基于 Rube MCP 与 Composio 的 Highlevel 自动化awesome-codex-skills 实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本篇技术指南以仓库中的 highlevel-automation Skill 为骨架系统讲解如何通过 Rube MCPComposio 提供的 MCP 网关驱动 GoHighlevelHighlevel平台的真实业务操作。你将掌握从 MCP 端点接入、连接授权、工具发现到多工具编排执行的完整闭环并学会规避工具 Schema 变更、连接失效等高频坑点从而把能聊 Highlevel变成能真正操作 Highlevel。背景为什么需要 Rube MCP 来做 Highlevel 自动化HighlevelGoHighlevel是面向本地商家与营销机构的 CRM 与营销自动化平台覆盖线索管理、客户旅程、营销活动、日历与通话等大量操作。直接为这类 SaaS 逐一编写 SDK 集成成本高昂且平台接口频繁演进维护困难。awesome-codex-skills 仓库在 README.md 中给出了清晰的定位Codex Skill 是模块化的指令包每个 Skill 目录下的SKILL.md通过 frontmatter 元数据namedescription声明自身职责Codex 依据描述自动触发匹配的 Skill并按需加载正文以节省上下文。highlevel-automation正是这样一个把 Highlevel 操作能力注入 Codex 的 Skill。它的实现路径是Rube MCP Composio Highlevel ToolkitRube 作为 MCP 服务器暴露统一端点Composio 在其背后托管 Highlevel 的整套工具toolkit。Skill 的 frontmatter 声明了依赖name: highlevel-automation description: Automate Highlevel tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]requires: mcp: [rube]意味着 Skill 被触发的前提是 Rube MCP 已接入客户端这也是后续所有RUBE_*工具调用的可用性基础。仓库中 composio-skills 目录下数百个*-automationSkill如 composio-automation、-21risk-automation 等都遵循同一套 Rube MCP 编排模式本指南介绍的流程可以平滑迁移到其他应用的自动化中。前置条件在开始之前需要确认以下三点齐备Rube MCP 已连接客户端环境中必须存在RUBE_SEARCH_TOOLS工具这是 Rube 网关可用的直接信号Highlevel 连接已建立通过RUBE_MANAGE_CONNECTIONS为 toolkithighlevel建立连接且状态为 ACTIVE先搜索、后执行任何工作流运行前都必须先调用RUBE_SEARCH_TOOLS获取当前工具 Schema——这是整个 Skill 反复强调的第一纪律。环境搭建接入 Rube MCP 并完成 Highlevel 授权第一步注册 MCP 端点Rube MCP 的接入非常轻量——只需在客户端配置中添加https://rube.app/mcp作为 MCP 服务器无需任何 API Key添加端点即可生效。第二步验证并建立连接按以下顺序完成连接初始化验证 Rube 可用确认RUBE_SEARCH_TOOLS有响应即证明 MCP 通道已打通发起连接调用RUBE_MANAGE_CONNECTIONS传入 toolkithighlevel完成授权若返回的连接状态不是 ACTIVE则按返回的授权链接auth link完成 Highlevel 账号的 OAuth 授权确认状态只有连接状态显示 ACTIVE才能继续运行任何工作流。这一连接机制与仓库中 connect 所介绍的 Composio CLI 连接思路同源先建立账号级授权再把授权后的能力交给 Codex 直接调用。区别在于 Rube 走 MCP 协议工具与连接的管理统一收敛到RUBE_*工具族。工具发现永远以当前 Schema 为准Highlevel Toolkit 暴露的工具是动态演进的——工具名slug、入参结构、字段类型都可能随平台升级而变化。因此 Skill 明确规定执行任何工作流之前必须先做工具发现。基础发现调用RUBE_SEARCH_TOOLS queries: [{use_case: Highlevel operations, known_fields: }] session: {generate_id: true}返回结果通常包含四类关键信息返回内容用途可用工具 slug确定该调用哪些工具输入 Schema构造符合规范的 arguments推荐执行计划官方建议的调用顺序与编排方式已知坑点官方标注的注意事项与边界注意首次发现时通过session: {generate_id: true}生成新会话 ID在既有工作流中则复用已有session: {id: existing_session_id}这是后续所有步骤保持一致上下文的前提。核心工作流模式三步完成一次 Highlevel 操作任何 Highlevel 自动化任务都收敛为发现 → 检查连接 → 执行三步闭环Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Highlevel task}] session: {id: existing_session_id}将use_case替换为具体任务描述例如创建联系人查询营销活动数据调度日历事件从返回结果中提取目标工具 slug 与完整输入 Schema。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [highlevel] session_id: your_session_id执行前确认连接仍为 ACTIVE。OAuth 令牌可能过期、权限可能被用户在 Highlevel 后台撤销跳过这一步会导致执行阶段收到授权类错误排查成本更高。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id执行层使用RUBE_MULTI_EXECUTE_TOOL多工具执行其关键点tool_slug必须来自 Step 1 的搜索结果禁止硬编码arguments必须严格符合搜索结果返回的 Schema字段名、类型、必填项memory参数必须显式携带即使为空也要传{}Skill 明确要求缺失可能导致执行器状态不一致一次调用可传入多个工具对象便于完成读-写-确认这类复合流程。高级操作批量任务与完整 Schema 获取对于超出单次执行范围的场景Skill 的速查表给出了两条进阶路径批量操作使用RUBE_REMOTE_WORKBENCH配合run_composio_tool()运行适合在远端工作台中批量执行同一工具多次例如批量更新线索状态、批量发送营销消息完整 Schema当搜索结果中工具带有schemaRef引用时使用RUBE_GET_TOOL_SCHEMAS拉取该工具的全量字段定义适合需要精确构造复杂嵌套参数如自定义字段、JSON 数组的场景。这两条路径与RUBE_SEARCH_TOOLS、RUBE_MULTI_EXECUTE_TOOL一起构成完整的 Rube 工具族覆盖搜索 → 取全量 Schema → 单次/批量执行的全链路。已知陷阱清单六个必须遵守的纪律Skill 明确列出了自动化实践中最容易踩的六个坑逐条展开如下永远先搜索工具 Schema 会变。不调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是最常见的失败来源检查连接执行前确认RUBE_MANAGE_CONNECTIONS状态为 ACTIVE避免在失效连接上浪费执行配额Schema 合规使用搜索结果中的精确字段名与类型多一个拼写错误、少一个必填字段都会直接导致工具调用失败Memory 参数必带RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory即使为空对象{}会话复用同一工作流内复用会话 ID 以保持上下文连续性开启新工作流时生成新会话避免状态串扰分页处理检查响应中的分页令牌pagination tokens持续拉取直到数据完整防止只处理了第一页数据就得出错误结论。操作速查表操作方式查找工具RUBE_SEARCH_TOOLS Highlevel 相关 use case建立连接RUBE_MANAGE_CONNECTIONS toolkithighlevel执行工具RUBE_MULTI_EXECUTE_TOOL 搜索结果中的工具 slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 SchemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具如何将本 Skill 用于你的 Codex 环境依据仓库 README.md 的通用安装方式将该 Skill 放入 Codex 技能目录即可生效将composio-skills/highlevel-automation目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex使其重新加载 Skill 元数据在会话中按自然语言描述 Highlevel 相关任务Codex 会根据 frontmatter 中的description自动触发本 Skill也可以直接提及 Skill 名称强制纳入考量验证安装ls ~/.codex/skills确认目录存在head ~/.codex/skills/highlevel-automation/SKILL.md检查元数据。需要注意的是本 Skill 的完整能力依赖 Rube MCP 端点可达且 Highlevel 账号授权有效纯本地环境无法脱离这两者单独验证工具执行。总结highlevel-automationSkill 展示了一种极具代表性的 SaaS 自动化范式Skill 定义怎么做指令与编排纪律Rube MCP 提供能做什么工具发现与 SchemaComposio 托管做什么Highlevel 真实工具。三步工作流搜索 → 检查连接 → 执行 六条纪律先搜索、查连接、守 Schema、带 memory、复会话、管分页构成了这套范式的高可靠性底座。由于同一模式在 composio-skills 目录下数百个*-automationSkill 中复用掌握本指南后你可以零成本迁移到任意其他应用的自动化编排中。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考