highlevel-automation

highlevel-automation skill 概览

highlevel-automation 的作用

highlevel-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动执行 HighLevel 任务。它的核心价值不在于提供一组固定动作，而是教会 agent 先发现当前可用的 HighLevel tool schema，确认账号连接状态，然后再通过可用的 Rube tools 执行工作流。

最适合 Workflow Automation 用户的场景

当你希望 AI agent 协助处理 HighLevel 中的联系人、CRM、营销或账号工作流任务，并且相关 tool schema 可能会变化时，可以使用 highlevel-automation skill。它更适合已经在使用 Claude、MCP、Composio/Rube，并且已连接 HighLevel 账号的用户。

关键差异：先看 schema，再执行

这里最重要的模式是“先搜索工具，再采取行动”。skill 不会让 agent 假设过时参数，而是要求 agent 针对具体用例调用 RUBE_SEARCH_TOOLS，读取返回的 tool slugs 和 input schemas，然后再继续执行。这样可以减少因示例过期或字段名猜错而导致的调用失败。

采用前需要考虑的点

这是一个轻量级 skill：仓库路径下只有一个 SKILL.md，没有随附脚本、参考资料或辅助资源。这让 highlevel-automation 很容易审阅，但也意味着执行效果取决于你的 MCP 设置、有效的 HighLevel 授权，以及你提供的任务说明是否足够清晰。

如何使用 highlevel-automation skill

highlevel-automation 安装与设置背景

从 Composio skills repository 安装该 skill，然后确保你的客户端可以使用 Rube MCP：

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

该 skill 需要 rube MCP server。请在客户端配置中将 https://rube.app/mcp 添加为 MCP server。之后确认 RUBE_SEARCH_TOOLS 可用。在执行 HighLevel 操作前，先针对 highlevel toolkit 使用连接管理工具；如果连接未激活，请完成返回的授权流程。

使用该 skill 时你需要提供的信息

为了可靠地使用 highlevel-automation，请给 agent 一个清晰的业务目标，并提供足够的操作上下文，帮助它选择正确的 HighLevel tools。建议包括对象类型、动作、筛选条件、要更新的字段、安全限制，以及 agent 是否需要先预览再执行。

较弱的 prompt：

Update my HighLevel contacts.

更好的 prompt：

Use highlevel-automation for Workflow Automation. First discover current HighLevel tools with RUBE_SEARCH_TOOLS. Then find contacts tagged Webinar-Lead created in the last 14 days, preview the count and sample records, and only after confirmation add them to the nurture workflow named Q3 Demo Follow-up. Do not modify contacts without an email address.

推荐工作流

先阅读 SKILL.md；它包含完整的操作模式。实际使用中，一次比较稳妥的执行流程通常是：

1. 要求 agent 针对你的具体 HighLevel 任务调用 RUBE_SEARCH_TOOLS。
2. 让它总结可用的 tool slugs、必填字段和潜在问题。
3. 通过 Rube connection tool 确认 HighLevel 连接处于激活状态。
4. 在执行写入操作前，先要求给出执行计划。
5. 当操作会影响大量记录时，先运行读取或预览步骤。
6. 只有在 schemas、筛选条件和目标记录都明确后再执行。

这个顺序很重要，因为该 skill 依赖实时工具发现，而不是硬编码的 HighLevel API 映射。

实用 prompt 模板

一个适合 highlevel-automation skill 的强 prompt 通常可以按下面的结构组织：

Use the highlevel-automation skill. Discover current HighLevel tools first.
Goal: [business outcome]
Target records: [contacts/opportunities/campaigns/etc.]
Selection rules: [tags, dates, pipeline stage, location, status]
Action: [create/update/search/trigger workflow]
Required fields: [field names and values if known]
Safety: [preview first, max records, ask before writes]
Output: [summary, CSV-style table, errors, next steps]

如果可以，请尽量按 HighLevel 中显示的原样写出名称细节。如果你不知道字段名，也要明确说明，并要求 agent 只有在读取返回的 Rube schema 后再进行推断。

highlevel-automation skill 常见问题

highlevel-automation 只适合高级用户吗？

如果你已经在通过 MCP tools 使用 Claude，它并不难上手，但它不是一键式自动化套件。初学者也可以成功使用它，建议从只读发现类任务开始，并要求 agent 在任何写入操作前解释每个 tool schema。

它比普通 prompt 好在哪里？

普通 prompt 可能会幻觉出 HighLevel API 字段，或默认使用过时的工具名称。highlevel-automation 会明确要求 agent 先使用 RUBE_SEARCH_TOOLS，因此工作流会基于运行时返回的最新 Composio/Rube tool definitions。

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

如果你无法连接 Rube MCP、无法授权 HighLevel 账号，或需要一个在 AI/MCP 客户端之外独立运行的脚本，就不适合使用它。如果要执行大规模破坏性操作，而你又无法定义严格筛选条件、预览步骤和审批关卡，它也不是合适选择。

应该先查看哪些仓库文件？

对于这个 skill，优先查看 composio-skills/highlevel-automation/SKILL.md。当前结构中没有额外脚本或参考文件夹，因此安装决策应重点关注 MCP 要求和 schema-discovery 工作流是否与你的环境匹配。

如何改进 highlevel-automation skill 的使用效果

让 highlevel-automation 的输入更精确

提升结果质量最快的方法，是用可执行的操作约束替代含糊的 CRM 表述。不要只说“clean up leads”，而要明确细分人群、目标字段、可接受值、排除记录，以及什么算成功。这样 agent 才有足够信息选择正确的已发现工具，并避免范围过大的误更新。

避免常见失败模式

大多数失败都来自跳过工具发现、在 HighLevel 连接尚未激活时就开始操作，或提供的筛选条件不完整。对于写入操作，要求 agent 在执行前说明所选 tool slug、必需 schema fields、计划传入的 arguments，以及预期影响。这样可以更早发现字段名不匹配和意外批量修改风险。

在第一次输出后继续迭代

把第一次响应当作规划阶段。如果 agent 返回多个工具选项，要求它进行对比并选择最安全的一个。如果它找到了记录，先要求提供样本和数量，再修改任何内容。如果 tool call 失败，把错误信息贴回去，并要求 agent 通过 RUBE_SEARCH_TOOLS 重新检查 schema，而不是猜测修复方法。

如果团队需要，可添加本地操作规则

由于 highlevel-automation 本身是一个紧凑型 skill，团队可能希望加入自己的使用规范：最大批处理数量、加入 workflow 前必须审批、字段命名说明、location/account IDs，或标准 tags。这些本地规则可以在不改变“schema-first”核心模式的前提下，让重复性的 HighLevel 自动化更安全、更一致。