affinity-automation
作成者 ComposioHQaffinity-automation は、エージェントが Composio Rube MCP 経由で Affinity CRM の操作を実行するためのスキルです。`RUBE_SEARCH_TOOLS` で現在のツールスキーマを確認し、Affinity 接続を検証したうえで、実行前により安全な CRM ワークフロー手順を踏む用途に使えます。
このスキルの評価は66/100で、ディレクトリ掲載には許容範囲ですが、機能は限定的です。ディレクトリ利用者は、特に Rube による検出と接続設定まわりで、Affinity 自動化向けの実用的な MCP トリガーパターンを利用できます。一方で、同梱された参考資料や具体的な Affinity ワークフローの深さは少なく、比較的軽量なスキルとして見るべきです。
- 有効な skill frontmatter で `rube` MCP 要件が明示され、Affinity 自動化の目的も説明されています。
- 前提条件とセットアップ手順では、Rube MCP の接続、`RUBE_MANAGE_CONNECTIONS` による Affinity の ACTIVE 確認、最初に `RUBE_SEARCH_TOOLS` を呼び出すことが説明されています。
- 中核となるワークフローパターンにより、ツール検出、接続状態の確認、Composio/Rube 経由での Affinity 操作実行まで、エージェントが実行しやすい手順が示されています。
- サポートファイル、スクリプト、参考資料、README、インストールコマンドが含まれていないため、導入・採用の判断材料は SKILL.md の記述に限られます。
- ワークフローはスキーマ取得をライブの Rube ツール検出に依存しており、Affinity 固有の具体的なタスク例は少なめです。そのため、エージェント側で実行時に解釈が必要になる場合があります。
affinity-automation skill の概要
affinity-automation の用途
affinity-automation skill は、Composio の Rube MCP server 経由で Affinity CRM の操作を実行するための Claude skill です。エージェントが現在の Affinity tool schema を確認し、ユーザーの Affinity 接続状態を検証したうえで、自由記述プロンプトだけに頼るよりも推測を減らして CRM 操作を進める場面に向いています。
向いているユーザーと業務
affinity-automation skill は、すでに Affinity を利用していて、反復的な運用作業を AI エージェントに支援させたい CRM Operations、営業企画、投資家対応、採用オペレーション、データチームに適しています。代表的な用途は、適切な Affinity tools の検索、リストや組織情報の更新準備、接続状態の確認、そして「実行前に必ず検出する」安全なワークフローへエージェントを誘導することです。
この skill の違い
大きな違いは、ハードコードされた Affinity コマンドを大量に持っていることではありません。この skill は、まず RUBE_SEARCH_TOOLS を使うようエージェントに指示し、Rube MCP から最新の tool slugs、schemas、execution plans、pitfalls を取得させます。MCP tool schemas は変わる可能性があるため、古いパラメータ名を前提にしたプロンプトでは失敗したり、不適切な CRM データを書き込んだりするリスクがあります。
導入前に確認すべき要件
affinity-automation をインストールしたり本番利用したりする前に、利用する AI client が MCP をサポートしており、Rube MCP が設定済みであることを確認してください。元の skill は mcp: [rube] を必要とし、RUBE_MANAGE_CONNECTIONS 経由の有効な Affinity 接続、および affinity toolkit へのアクセスが前提です。Rube MCP に接続できない、または Affinity を認可できない場合、この skill は実用的な作業を実行できません。
affinity-automation skill の使い方
affinity-automation のインストール前提
Composio skill collection から skill をインストールし、その後、利用している client 側で Rube MCP を別途設定します。一般的なインストールコマンドは次のとおりです。
npx skills add ComposioHQ/awesome-claude-skills --skill affinity-automation
次に、client configuration に MCP server として https://rube.app/mcp を追加します。上流の skill では、この endpoint 自体に API keys は不要とされていますが、有効な Affinity 接続は別途必要です。まず RUBE_SEARCH_TOOLS が利用可能か確認し、その後 toolkit affinity で RUBE_MANAGE_CONNECTIONS を使います。接続が ACTIVE でない場合は、返された認可フローを完了してください。
skill に渡すべき入力
affinity-automation を有効に使うには、業務目的、Affinity object type、選定条件、実行したい操作、安全上のルールをエージェントに伝えます。弱いプロンプトは「Update Affinity.」です。よりよいプロンプトは次のようになります。「Use affinity-automation to find Affinity tools for updating organizations. Check the Affinity connection first. I need to add companies from list X to list Y only if they are not already present. Do not overwrite existing owner, status, or notes fields. Show the discovered tool schema before executing.」
こうすることで、skill は対象が people、organizations、lists、opportunities、notes のどれなのかを推測するのではなく、あなたの運用目的を現在の Rube tools に対応づけやすくなります。
推奨ワークフロー
毎回、まず tool discovery から始めます。エージェントには単に「Affinity operations」ではなく、具体的な Affinity タスクに対して RUBE_SEARCH_TOOLS を呼び出すよう依頼してください。可能であれば返された session を再利用し、検出された schema を確認してから、RUBE_MANAGE_CONNECTIONS で Affinity 接続を確認します。実行 tools を呼ぶのはその後です。書き込み操作では、事前確認として、対象レコード、変更する fields、スキップするレコード、rollback やレビュー上の制約を短くまとめるよう依頼すると安全です。
最初に読むべき repository files
この skill はコンパクトです。まず確認すべき主要ファイルは composio-skills/affinity-automation/SKILL.md です。現在の repository preview には、同梱 scripts、references、rules、README files はありません。そのため、実装上の詳細の多くは skill text と、実行時に取得する Rube MCP tool discovery response にあります。導入判断のためには、prerequisites、setup、tool discovery、core workflow の各セクションを先に読むとよいでしょう。
affinity-automation skill FAQ
affinity-automation は CRM Operations 向けですか？
はい。CRM Operations 向けの affinity-automation は、Affinity タスクについて「tools を検出する、接続を確認する、schema を確認する、その後に実行する」という一貫したエージェントワークフローが必要なチームに特に有用です。データ品質が重要で、エージェントに fields を作り上げさせたり、古い API 前提で操作させたりしたくない場合に適しています。
通常のプロンプトより何が優れていますか？
通常のプロンプトでも「use Affinity」と指示することはできますが、現在の Rube tool schemas を必ず検出させるとは限りません。affinity-automation skill は、その運用上の規律を組み込んでいます。schemas、tool names、required fields が不確かな場合に価値が高く、実行前に live tool discovery へエージェントを誘導します。
初心者でも使えますか？
自社の Affinity data model を理解しており、MCP 設定を支援してもらえるなら、初心者でも affinity-automation skill を使えます。難しいのは多くの場合、skill text そのものではなく、どの records を変更してよいか、何を絶対に変更してはいけないかを判断することです。新しいユーザーは、広範囲の書き込みを許可する前に、read-only の discovery と小規模な test updates から始めるべきです。
使わないほうがよい場面は？
Rube MCP にアクセスできない、Affinity を認可できない、または AI client なしで動く standalone script が必要な場合は、この skill を使うべきではありません。また、「fix our CRM」のような曖昧なクリーンアップ依頼にも向いていません。対象 objects、matching rules、field rules、review steps を定義できることが前提です。
affinity-automation skill を改善する方法
運用ルールで affinity-automation prompts を改善する
affinity-automation の結果を改善する最短の方法は、プロンプトを operations runbook のように書くことです。Affinity object、record source、match key、allowed fields、forbidden fields、duplicate handling、そしてエージェントに実行を許可するのか、計画のみを求めるのかを含めてください。例：「Find tools for Affinity list membership. Use company domain as the match key. Add missing organizations to the named list. If multiple matches exist, skip and report. Do not create new organizations.」
防ぐべきよくある失敗
主なリスクは、tool discovery の省略、inactive な接続、古い schema 前提、曖昧な record matching、広すぎる書き込み操作です。これを防ぐには、最初に RUBE_SEARCH_TOOLS を必須にし、検出された schema をエージェントに提示させ、接続状態が ACTIVE であることを確認し、最初の実行を小さな batch または利用可能であれば dry-run 形式の plan に限定します。
最初の出力後に見直す
エージェントの最初の回答を受け取ったら、そのまま実行承認しないでください。選択された Rube tools がタスクに合っているか、required fields が埋まっているか、discovery response から pitfalls を特定できているかを確認します。計画が広すぎる場合は、対象を絞ります。たとえば「only records updated in the last 30 days」、「only organizations with a domain」、「only list members from this source」のように指定します。
チーム向けに skill を拡張する
affinity-automation を繰り返し使うチームは、上流ファイルの外側にローカルのガイダンスを追加することで改善できます。たとえば、承認済みの Affinity field names、命名規則、list ownership rules、duplicate-resolution policy、安全な prompts の例などです。これらの追加情報は secrets とは分けて管理し、Affinity workspace や Composio tool の挙動が変わったときに更新してください。