agencyzoom-automation

agencyzoom-automation skill 概览

agencyzoom-automation 适合用来做什么

agencyzoom-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Agencyzoom CRM 操作。它的核心价值不在于提供一组写死的固定动作，而是指导 agent 先发现当前可用的 Agencyzoom tool schema，验证连接状态，然后再为用户请求的工作流执行正确的 Rube MCP tool。

当你希望 AI assistant 协助处理 Agencyzoom 任务时，可以使用这个 skill，例如 CRM 记录操作、pipeline 更新、账户跟进流程，或需要根据实时 Composio toolkit schema 判断可用动作的运营检查。

最适合 CRM Operations 团队

agencyzoom-automation skill 最适合 CRM Operations、agency admin、RevOps 以及自动化用户使用：这些用户已经在使用 Agencyzoom，并希望 Claude 通过已认证的 MCP 连接执行操作。尤其当任务需要发现当前工具能力，而不是凭记忆猜测 API 字段时，它会更有价值。

如果你只是想获得关于 Agencyzoom 的文字建议、没有可用的 Rube MCP，或无法授权一个有效的 Agencyzoom 连接，那么它的帮助就比较有限。

关键差异：先搜索工具，再执行操作

它的核心模式是：不要假设 Agencyzoom schema。这个 skill 会要求 agent 在执行前调用 RUBE_SEARCH_TOOLS，以获取当前 toolkit 版本下可用的 tool slug、必填输入、字段名、推荐执行计划以及潜在风险点。

这一点很重要，因为 CRM 自动化一旦出现 agent 编造字段名、使用过期 schema，或在认证完成前尝试执行操作，就很容易失败。

安装前应该检查什么

上游 skill 体量很小，目前主要围绕一个文件：SKILL.md。skill 文件夹中没有额外的脚本、资源、规则或 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。在用于实际工作前，请让 agent 验证 RUBE_SEARCH_TOOLS 是否有响应，并确认 Agencyzoom toolkit connection 的状态为 ACTIVE。

必需的连接与发现流程

一个实用的 agencyzoom-automation 使用流程应该是：

1. 确认 Rube MCP 已连接。
2. 使用 RUBE_MANAGE_CONNECTIONS，toolkit 设置为 agencyzoom。
3. 如果连接不是 active，完成返回的 authentication link。
4. 针对具体的 Agencyzoom 任务调用 RUBE_SEARCH_TOOLS。
5. 检查发现到的 tool schema 和必填字段。
6. 只有在 tool 和输入都确认后再执行。

一个合适的第一条指令是：

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，加入 review 步骤，并避免在确认前进行大范围 CRM 变更。

优先阅读的文件和源码路径

先从这里开始：

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

这个文件包含该 skill 的操作约定：前置条件、设置方式、工具发现，以及核心工作流模式。由于这个 skill 没有 helper scripts 或 reference folders，你不应期待它内置适用于你机构的业务逻辑。你需要在 prompt 中提供工作流规则、记录筛选条件、审批步骤和数据映射。

agencyzoom-automation skill 常见问题

没有 Rube MCP，agencyzoom-automation 还能用吗？

不能。这个 skill 依赖 Rube MCP。如果 RUBE_SEARCH_TOOLS 不可用，agent 就无法遵循该 skill 的主要安全模式。你还需要先通过 RUBE_MANAGE_CONNECTIONS 建立一个 active 的 Agencyzoom 连接，agent 才能执行已认证的操作。

它比普通 Claude prompt 好在哪里？

普通 prompt 可能只是要求 Claude “use Agencyzoom”，但并不会强制进行实时工具发现。agencyzoom-automation skill 的价值在于，它会引导 agent 在选择动作前搜索当前的 Composio tool schemas。这可以减少 schema 幻觉，并帮助 agent 适应 Agencyzoom 可用工具的变化。

新手可以使用这个 skill 吗？

可以，前提是他们能够配置 MCP 并完成 Agencyzoom 授权流程。新手应从只读或低风险检查开始，让 agent 在执行前展示发现到的 tool schema，并要求在修改 CRM 数据前获得批准。

什么时候不应该使用这个 skill？

不要在没有经过测试的记录列表、审批步骤和回滚计划的情况下，用它进行批量 CRM 变更。如果你的任务主要是战略建议、培训内容或文档编写，也应避免使用它；这个 skill 是为通过 Composio 执行实时 Agencyzoom 操作而设计的，不是通用 CRM 咨询工具。

如何改进 agencyzoom-automation skill

用约束条件改进 agencyzoom-automation prompt

提升输出质量最有效的方法，是给 agent 明确的操作约束。请包含：

• 你希望影响的 Agencyzoom object 或 workflow
• Record IDs、搜索条件或来源表
• 需要读取或更新的字段
• 要写入的值，以及空值如何处理
• agent 是否可以执行，还是必须等待批准
• 需要排除的 records、statuses 或 pipelines

这些信息可以让 agencyzoom-automation 聚焦于预期的 CRM 操作，而不是做过宽的假设。

在执行前降低失败模式

常见失败模式包括连接未激活、对字段名使用过期假设、缺少必填字段，以及更新条件过宽。要避免这些问题，可以要求 agent 在调用执行类 tool 之前，先展示发现到的 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.

在第一次工具结果后继续迭代

在第一次 discovery 或 execution 结果返回后，请让 agent 对照你的目标工作流核对实际发生了什么。可用的后续追问包括：

• “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 不包含机构专属策略。为了让 agencyzoom-automation 更可靠，可以在 prompt 或本地 skill notes 中加入你自己的规则：审批阈值、命名规范、允许使用的 pipelines、需要排除的 statuses、audit-log 格式，以及批量大小限制。

如果要反复使用，建议维护一份简短的内部 playbook，把常见 Agencyzoom 任务与已批准的 prompts 和必需的 review checkpoints 配对。