affinity-automation

affinity-automation skill 概覽

affinity-automation 的用途

affinity-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP server 執行 Affinity CRM 操作。它適合用在代理需要先找出目前的 Affinity tool schema、確認使用者的 Affinity 連線狀態，然後再執行 CRM 動作的情境；相比自由輸入 prompt，能減少猜測與誤操作。

最適合的使用者與任務

affinity-automation skill 很適合已經在使用 Affinity，並希望 AI 代理協助處理可重複營運工作的 CRM Operations、sales operations、投資人關係、招募營運與資料團隊。常見任務包括尋找正確的 Affinity tools、準備清單或組織更新、檢查連線狀態，以及引導代理遵循安全的「先探索、再執行」流程。

這個 skill 的差異化重點

它的關鍵差異不在於內建一大串硬編碼的 Affinity commands。這個 skill 會要求代理先使用 RUBE_SEARCH_TOOLS，以便從 Rube MCP 取得目前可用的 tool slugs、schemas、execution plans 與 pitfalls。這一點很重要，因為 MCP tool schemas 可能會變動；如果 prompt 假設的是舊參數名稱，可能導致執行失敗，或寫入錯誤的 CRM 資料。

採用前的重要條件

安裝或依賴 affinity-automation 之前，請先確認你的 AI client 支援 MCP，且已設定 Rube MCP。來源 skill 需要 mcp: [rube]、透過 RUBE_MANAGE_CONNECTIONS 建立的有效 Affinity connection，以及 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 中加入 https://rube.app/mcp 作為 MCP server。上游 skill 說明 endpoint 本身不需要 API keys，但你仍然需要一個有效的 Affinity connection。請先確認 RUBE_SEARCH_TOOLS 可用，再使用 RUBE_MANAGE_CONNECTIONS 搭配 toolkit affinity；如果連線狀態不是 ACTIVE，就完成其回傳的授權流程。

你需要提供給 skill 的輸入

若要有效使用 affinity-automation，請提供代理業務目標、Affinity object type、篩選條件、預計執行的動作，以及任何安全規則。較弱的 prompt 是：「Update Affinity。」更好的 prompt 是：「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 可以把你的營運目標對應到目前的 Rube tools，而不是猜測任務涉及 people、organizations、lists、opportunities，還是 notes。

建議工作流程

每次執行都應從 tool discovery 開始：請代理針對具體 Affinity 任務呼叫 RUBE_SEARCH_TOOLS，而不是只搜尋「Affinity operations」。可行時重用回傳的 session，檢視已探索到的 schema，接著用 RUBE_MANAGE_CONNECTIONS 檢查 Affinity connection。只有在完成這些步驟後，代理才應呼叫 execution tools。若是寫入操作，請要求代理提供簡短的 preflight summary：目標 records、要變更的 fields、要略過的 records，以及 rollback 或 review 的限制。

優先閱讀的 repository files

這個 skill 很精簡：主要需要檢視的檔案是 composio-skills/affinity-automation/SKILL.md。目前 repository preview 中沒有隨附 scripts、references、rules 或 README files，因此多數實作細節都在 skill 文字，以及即時的 Rube MCP tool discovery response 裡。若是為了決定是否安裝，請先閱讀 prerequisites、setup、tool discovery 與 core workflow 相關段落。

affinity-automation skill 常見問題

affinity-automation 適合 CRM Operations 嗎？

是。affinity-automation 用於 CRM Operations 時，最適合需要一致代理流程來處理 Affinity 任務的團隊：先探索 tools、確認 connection、檢視 schema，然後才執行。當資料品質很重要，且代理應避免自行編造 fields 或使用過時 API 假設時，它尤其有價值。

它比一般 prompt 好在哪裡？

一般 prompt 可能只會說「use Affinity」，但不一定會強制代理探索目前的 Rube tool schemas。affinity-automation skill 把這種營運紀律寫進流程裡。當 schemas、tool names 或 required fields 不確定時，它的價值最高，因為它會推動代理在執行前先做即時 tool discovery。

初學者可以使用這個 skill 嗎？

初學者可以使用 affinity-automation skill，前提是他們了解自己的 Affinity data model，並有人協助設定 MCP。難點通常不在 skill 文字本身，而在於知道哪些 records 可以被變更、哪些絕對不能被改動。新使用者應先從 read-only discovery 和小範圍測試更新開始，再允許大規模寫入。

什麼時候不該使用？

如果你沒有 Rube MCP access、無法授權 Affinity，或需要的是不依賴 AI client 也能執行的 standalone script，就不應使用這個 skill。對於像「fix our CRM」這類模糊的清理需求，它也不適合，除非你能定義 target objects、matching rules、field rules 與 review steps。

如何改進 affinity-automation skill

用營運規則改善 affinity-automation prompts

要最快改善 affinity-automation 的結果，請把 prompt 寫得像 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、connection 未啟用、沿用過時 schema 假設、record matching 模糊，以及寫入操作範圍過大。預防方式是要求先執行 RUBE_SEARCH_TOOLS、請代理展示探索到的 schema、確認 connection status 為 ACTIVE，並在首次執行時限制為小批次，或在可用時採用 dry-run style plan。

第一輪輸出後要迭代檢查

在代理第一次回覆後，不要直接批准執行。請檢查選到的 Rube tools 是否符合任務、required fields 是否已填入，以及代理是否辨識出 discovery response 中提到的 pitfalls。如果計畫範圍太大，請縮小 segment，例如：「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 behavior 有變更時同步更新。