agencyzoom-automation

agencyzoom-automation skill 概覽

agencyzoom-automation 的用途

agencyzoom-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP server 執行 Agencyzoom CRM 操作。它的主要價值不在於提供一組固定寫死的動作；而是教代理先探索目前的 Agencyzoom 工具 schema、確認連線狀態，然後針對請求的工作流程執行正確的 Rube MCP tool。

當你希望 AI 助理協助處理 Agencyzoom 任務時，適合使用這個 skill，例如 CRM 紀錄操作、pipeline 更新、帳戶追蹤流程，或是實際可用動作會依目前 Composio toolkit schema 而定的營運檢查。

最適合 CRM Operations 團隊

agencyzoom-automation skill 最適合已經使用 Agencyzoom，並希望 Claude 透過已驗證 MCP 連線代為操作的 CRM Operations、agency admin、RevOps 與自動化使用者。當你的任務需要即時探索目前工具，而不是憑記憶猜 API 欄位時，它特別有用。

如果你只是需要 Agencyzoom 的文字建議、沒有可用的 Rube MCP，或無法授權有效的 Agencyzoom 連線，這個 skill 的幫助就比較有限。

關鍵差異：先搜尋工具，再執行動作

核心模式是：不要假設 Agencyzoom schema。這個 skill 會指示代理在執行前先呼叫 RUBE_SEARCH_TOOLS，以取得目前 toolkit 版本可用的 tool slugs、必要輸入、欄位名稱、建議計畫與注意事項。

這一點很重要，因為 CRM 自動化一旦代理憑空捏造欄位名稱、使用過時 schema，或在驗證尚未完成前就嘗試執行，很快就會失敗。

安裝前應先檢查什麼

上游 skill 很精簡，目前主要集中在一個檔案：SKILL.md。skill 資料夾內沒有額外 script、resources、rules 或 README 檔案，因此是否安裝，主要取決於你是否使用 Rube MCP 與 Agencyzoom。

請先閱讀 SKILL.md，確認所需的 MCP server、連線流程與工具探索模式是否符合你的環境。

如何使用 agencyzoom-automation skill

agencyzoom-automation 安裝情境

如果你的用戶端支援從 GitHub 安裝 skill，可以從 Composio skill collection 安裝，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill agencyzoom-automation

接著在你的 AI client 中加入以下設定來配置 Rube MCP：

https://rube.app/mcp

這個 skill 預期 Rube MCP tools 可用，尤其是 RUBE_SEARCH_TOOLS 與 RUBE_MANAGE_CONNECTIONS。在用於實際工作前，請要求代理確認 RUBE_SEARCH_TOOLS 有回應，並確認 Agencyzoom toolkit connection 為 ACTIVE。

必要連線與探索流程

實務上的 agencyzoom-automation 使用流程應該像這樣：

1. 確認 Rube MCP 已連線。
2. 使用 RUBE_MANAGE_CONNECTIONS，toolkit 設為 agencyzoom。
3. 如果連線尚未啟用，完成回傳的驗證連結。
4. 針對特定 Agencyzoom 工作呼叫 RUBE_SEARCH_TOOLS。
5. 檢視探索到的 tool schema 與必要欄位。
6. 只有在工具與輸入都確認後才執行。

一個好的第一句指令是：

Use the agencyzoom-automation skill. First verify Rube MCP access, then check that the Agencyzoom connection is active. Search for the current tool schema for updating Agencyzoom CRM records before taking any action.

把粗略目標變成完整 prompt

較弱的 prompt：

Update my Agencyzoom leads.

較好的 prompt：

Use agencyzoom-automation for CRM Operations. I need to update Agencyzoom lead records that match these criteria: [criteria]. First call RUBE_SEARCH_TOOLS for the exact Agencyzoom operation and show me the discovered tool name, required fields, and any missing inputs. Do not execute until I confirm the mapping. When ready, update only the records in this list: [record IDs or exported table].

較完整的 prompt 效果更好，因為它提供任務邊界、要求探索 schema、加入檢視步驟，並避免在確認前對 CRM 做出過於廣泛的變更。

優先閱讀的檔案與來源路徑

請從這裡開始：

• composio-skills/agencyzoom-automation/SKILL.md

這個檔案包含操作契約：先決條件、設定方式、工具探索，以及核心工作流程模式。由於此 skill 沒有 helper scripts 或參考資料夾，你不應期待它已內建你 agency 專用的業務邏輯。你需要在 prompt 中提供工作流程規則、紀錄篩選條件、核准步驟與資料對應方式。

agencyzoom-automation skill 常見問題

沒有 Rube MCP，可以只用 agencyzoom-automation 嗎？

不行。這個 skill 需要 Rube MCP。如果 RUBE_SEARCH_TOOLS 無法使用，代理就無法遵循 skill 的主要安全模式。你也需要先透過 RUBE_MANAGE_CONNECTIONS 建立有效的 Agencyzoom 連線，代理才能執行已驗證的操作。

這比一般 Claude prompt 好在哪裡？

一般 prompt 可能會要求 Claude「使用 Agencyzoom」，但不會強制進行即時工具探索。agencyzoom-automation skill 的價值在於，它會引導代理在選擇動作前先搜尋目前的 Composio tool schemas。這能降低 schema 幻覺，並幫助代理適應可用 Agencyzoom tools 的變化。

新手可以使用這個 skill 嗎？

可以，只要能設定 MCP 並完成 Agencyzoom 授權流程。新手應先從唯讀或低風險檢查開始，要求代理在執行前顯示探索到的 tool schema，並在更改 CRM 資料前要求核准。

什麼情況不適合使用這個 skill？

如果沒有經過測試的紀錄清單、核准步驟與 rollback plan，不要用它進行大量 CRM 變更。若你的任務主要是策略建議、訓練內容或文件撰寫，也應避免使用；這個 skill 是為了透過 Composio 執行即時 Agencyzoom 操作而設計，不是一般 CRM 顧問工具。

如何改進 agencyzoom-automation skill

用限制條件改善 agencyzoom-automation prompts

提升輸出品質最有效的方法，是提供代理明確的操作限制。請包含：

• 你想影響的 Agencyzoom 物件或工作流程
• Record IDs、搜尋條件，或來源表格
• 要讀取或更新的欄位
• 要寫入的值，以及空白值如何處理
• 代理是否可以執行，或必須等待核准
• 需要排除的紀錄、狀態或 pipelines

這能讓 agencyzoom-automation 聚焦在預期的 CRM 操作，而不是做出過於寬泛的假設。

執行前降低失敗風險

常見失敗模式包括連線未啟用、對欄位名稱使用過時假設、缺少必要欄位，以及更新條件過於寬泛。避免這些問題的方法，是要求代理在呼叫執行工具前，先顯示探索到的 RUBE_SEARCH_TOOLS 結果摘要。

一個強力的安全指令是：

If the current Agencyzoom schema does not expose the required operation, stop and explain the gap. Do not substitute a different CRM action without approval.

根據第一個工具結果持續調整

在第一次探索或執行結果後，請要求代理把實際結果與你的預期工作流程對齊。實用的後續問題包括：

• “Which required fields are still missing?”
• “Which records were skipped and why?”
• “Show the exact mapping before the next update.”
• “Run a smaller batch first.”
• “Summarize the completed changes for audit notes.”

這些迭代對 CRM Operations 團隊尤其重要，因為錯誤更新的代價通常高於多一次確認步驟的成本。

加入團隊專屬操作規則

上游 skill 不包含 agency 專屬政策。若要讓 agencyzoom-automation 更可靠，請在 prompt 或本機 skill notes 中加入你自己的規則：核准門檻、命名慣例、允許的 pipelines、排除的 statuses、audit-log 格式，以及 batch-size limits。

若會重複使用，建議維護一份簡短的內部 playbook，將常見 Agencyzoom 任務與已核准 prompts、必要檢查點配對。