affinity-automation

affinity-automation skill 概览

affinity-automation 适合做什么

affinity-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Affinity CRM 操作。它适合这类任务：agent 需要先发现当前的 Affinity tool schema，验证用户的 Affinity 连接状态，然后再执行 CRM 动作，从而比自由发挥式 prompt 更少猜测、更可控。

最适合的用户和任务

affinity-automation skill 很适合已经在使用 Affinity，并希望让 AI agent 协助处理可重复运营工作的 CRM Operations、sales operations、investor relations、recruiting operations 和数据团队。典型任务包括查找合适的 Affinity tools、准备 list 或 organization 更新、检查连接状态，以及引导 agent 按照“先发现、再执行”的安全流程工作。

这个 skill 的不同之处

它的核心差异不在于内置了一大批硬编码的 Affinity 命令。这个 skill 会要求 agent 先使用 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 连接，并且能够访问 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 配置中将 https://rube.app/mcp 添加为 MCP server。上游 skill 说明该 endpoint 本身不需要 API keys，但你仍然需要一个有效的 Affinity 连接。请先确认 RUBE_SEARCH_TOOLS 可用，然后使用带 toolkit affinity 的 RUBE_MANAGE_CONNECTIONS；如果连接状态不是 ACTIVE，需要完成返回的授权流程。

你需要提供哪些输入

要让 affinity-automation 真正有用，需要告诉 agent 业务目标、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 开始：要求 agent 针对具体的 Affinity 任务调用 RUBE_SEARCH_TOOLS，而不是泛泛地搜索 “Affinity operations”。尽可能复用返回的 session，检查发现到的 schema，然后用 RUBE_MANAGE_CONNECTIONS 检查 Affinity 连接。只有完成这些步骤之后，agent 才应该调用执行工具。对于写入操作，请要求 agent 先给出简短的 preflight summary：目标记录、要修改的字段、要跳过的记录，以及 rollback 或 review 上的限制。

优先阅读的仓库文件

这个 skill 很精简：最值得先看的主文件是 composio-skills/affinity-automation/SKILL.md。当前 repository preview 中没有附带 scripts、references、rules 或 README 文件，因此大部分实现细节都在 skill 文本，以及实时的 Rube MCP tool discovery response 中。做安装决策时，建议优先阅读 prerequisites、setup、tool discovery 和 core workflow 相关部分。

affinity-automation skill 常见问题

affinity-automation 适合 CRM Operations 吗？

适合。用于 CRM Operations 的 affinity-automation，在团队需要一套稳定的 Affinity agent 工作流时最有价值：先发现 tools，确认连接，检查 schema，然后再执行。尤其在数据质量很重要、agent 不应编造字段或使用过时 API 假设的场景下，它更有意义。

它比普通 prompt 好在哪里？

普通 prompt 可能只是说“use Affinity”，但不一定会强制 agent 发现当前的 Rube tool schemas。affinity-automation skill 把这种运营纪律写进了流程。它在 schemas、tool names 或 required fields 不确定时价值最高，因为它会推动 agent 在执行前先做实时 tool discovery。

新手能使用这个 skill 吗？

新手可以使用 affinity-automation skill，前提是理解自己的 Affinity 数据模型，并且有人协助配置 MCP。难点通常不在 skill 文本本身，而在于知道哪些记录可以被修改、哪些内容绝不能改。新用户应先从只读 discovery 和小范围测试更新开始，再允许大范围写入。

什么时候不应该使用它？

如果你没有 Rube MCP 访问权限，无法授权 Affinity，或者需要一个不依赖 AI client 的独立脚本，就不应使用这个 skill。对于“fix our CRM”这类模糊的清理请求，它也不合适，除非你能明确目标 objects、匹配规则、字段规则和 review 步骤。

如何改进 affinity-automation skill

用运营规则改进 affinity-automation prompts

提升 affinity-automation 结果最快的方法，是像写 operations runbook 一样写 prompt。请包含 Affinity object、record source、match key、允许修改的字段、禁止修改的字段、重复项处理方式，以及 agent 是可以执行还是只能规划。示例：“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、连接未激活、沿用过时 schema 假设、记录匹配含糊，以及写入范围过大。预防方式是要求先执行 RUBE_SEARCH_TOOLS，让 agent 展示发现到的 schema，确认连接状态为 ACTIVE，并将首次执行限制在小批量，或在可用时采用 dry-run 风格的计划。

第一次输出后继续迭代

收到 agent 第一次响应后，不要直接批准执行。先检查所选 Rube tools 是否与任务匹配，required fields 是否已填充，以及 agent 是否识别了 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，以及安全 prompt 示例。请将这些补充内容与 secrets 分开保存，并在你的 Affinity workspace 或 Composio tool 行为变化时及时更新。