在 awesome-codex-skills 中通过 Rube MCP 实现 Dialpad 自动化dialpad-automation 技能全解析【免费下载链接】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本文围绕仓库中composio-skills/dialpad-automation/SKILL.md这一 Codex 技能文档展开讲解如何借助 Composio 的 Rube MCP 通道在 Codex CLI/API 中安全地驱动 Dialpad 操作从技能元数据与前置条件到工具发现RUBE_SEARCH_TOOLS、连接管理RUBE_MANAGE_CONNECTIONS与工具执行RUBE_MULTI_EXECUTE_TOOL的完整三步工作流以及官方文档列出的全部已知陷阱与快速参考表。读完本文你可以在 Codex 中安装并触发该技能掌握“先搜索、再校验、后执行”的 Rube MCP 标准调用模式并将同一套模式复用到仓库内其他 Composio 自动化技能上。技能定位与元数据dialpad-automation 是什么dialpad-automation是 dialpad-automation/SKILL.md 所定义的 Codex 技能其定位是通过 Composio 的 Dialpad toolkit经由 Rube MCP自动化 Dialpad 相关操作。按照仓库 README.md 对 Codex 技能的定义每个技能是一个独立的文件夹其中SKILL.md携带 YAML frontmatternamedescription和分步执行指引Codex 读取元数据来决定何时触发技能并在触发后加载正文以保持上下文精简。该技能的文件头元数据为name: dialpad-automation description: Automate Dialpad tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]这里有两点值得关注description不仅说明了技能做什么Automate Dialpad tasks via Rube MCP还内嵌了执行纪律Always search tools first for current schemas。这与仓库 README 的最佳实践一致——description应完整描述触发时机正文聚焦执行步骤。requires.mcp: [rube]声明了该技能对外部 MCP 服务Rube MCP的硬依赖。技能正文中所有RUBE_*工具均由 Rube MCP 提供客户端必须先连接该 MCP 端点技能才能真正执行。从源码结构看dialpad-automation并非孤例在composio-skills/目录下数百个技能如ably-automation、zoho-desk-automation、sourcegraph-automation等都遵循同一套 Rube MCP 协议其中 758 个 SKILL.md 引用了RUBE_REMOTE_WORKBENCH。也就是说掌握 Dialpad 这一篇的调用模式就等于掌握了整个 Composio 技能族的通用范式。前置条件Rube MCP 连接与 Dialpad 授权文档明确要求满足以下三项前置条件缺一不可Rube MCP 已连接客户端中RUBE_SEARCH_TOOLS工具可用并有响应Dialpad 连接处于激活状态通过RUBE_MANAGE_CONNECTIONS且 toolkit 为dialpad连接状态显示 ACTIVE始终以工具搜索为先在调用任何业务工具前先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。第 3 条是整个技能设计的核心约束后文的“已知陷阱”部分还会再次强调工具 schema 会随 Composio 侧更新而变化任何硬编码的工具 slug 或参数结构都可能失效。接入 Rube MCP四步 Setup文档给出的接入流程非常简洁——只需把 Rube MCP 端点https://rube.app/mcp加入客户端的 MCP server 配置文档说明该端点“无需 API key加上端点即可工作”然后按以下四步完成初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应发起连接调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为dialpad完成授权如果连接状态不是 ACTIVE按照返回值中的授权链接auth link完成 Dialpad 侧的授权设置确认状态在执行任何工作流之前确认连接状态显示为 ACTIVE。这一流程体现了 Composio 的无本地凭据设计Dialpad 的 OAuth 授权、token 管理都由 Rube MCP 网关托管Codex 侧只需要维护“连接状态是 ACTIVE”这一单一事实。工具发现RUBE_SEARCH_TOOLS 与 session 机制在正式工作流之外文档单独给出了一个工具发现示例用于在进入工作流前先摸清 Dialpad 侧可用工具的全貌RUBE_SEARCH_TOOLS queries: [{use_case: Dialpad operations, known_fields: }] session: {generate_id: true}该调用的返回内容包括四部分可用工具的 slug 列表、各工具的输入 schema、推荐的执行计划recommended execution plans、已知陷阱known pitfalls。注意此处session: {generate_id: true}会生成一个新的会话 ID——这正是“会话复用”规则的起点同一条工作流内复用同一个 session ID开启新工作流时再重新生成。核心工作流发现 → 校验 → 执行三步模式Step 1针对具体任务发现工具将 Step 1 的use_case换成你的具体 Dialpad 任务描述例如通话记录查询、用户管理等并复用已生成的会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Dialpad task}] session: {id: existing_session_id}搜索返回的工具 slug 与参数 schema 是后续执行步骤的唯一可信来源。Step 2校验 Dialpad 连接状态RUBE_MANAGE_CONNECTIONS toolkits: [dialpad] session_id: your_session_id执行任何业务工具前必须确认此处返回的状态为 ACTIVE若非 ACTIVE应回到 Setup 第 3 步走授权流程而不是直接执行。Step 3通过 RUBE_MULTI_EXECUTE_TOOL 执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id三个关键细节tool_slug必须取自 Step 1 搜索结果中的真实 slug示例中的TOOL_SLUG_FROM_SEARCH是占位符arguments必须严格符合搜索返回的 schema——字段名、类型逐一对应不允许凭经验填参memory参数必须始终存在即使内容为空对象{}。这是RUBE_MULTI_EXECUTE_TOOL的强制字段。三步之间由session_id串联保证 Rube MCP 网关能在同一会话上下文中维护状态如连接、记忆。快速参考表五种操作路径文档末尾给出的 Quick Reference 是整个技能的操作索引这里完整继承并补充说明操作方式说明查找工具RUBE_SEARCH_TOOLS传入 Dialpad 专属 use_case 描述返回 slug 与 schema建立连接RUBE_MANAGE_CONNECTIONS指定 toolkitdialpad状态须为 ACTIVE执行工具RUBE_MULTI_EXECUTE_TOOL使用发现到的工具 slug 执行批量操作RUBE_REMOTE_WORKBENCH通过其run_composio_tool()函数执行批量/复杂编排获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于搜索结果中带schemaRef标记的工具拉取完整字段定义其中两条是“进阶路径”当批量场景例如遍历多个团队或通话记录需要编排多个工具调用时走RUBE_REMOTE_WORKBENCH的run_composio_tool()当某个工具在搜索结果中只给出schemaRef引用而非内联 schema 时必须用RUBE_GET_TOOL_SCHEMAS补齐完整定义后再执行。已知陷阱文档明示的六条执行纪律这部分是技能作者沉淀的“防错清单”全部继承如下先搜索再动手Always search first工具 schema 会变。未调用RUBE_SEARCH_TOOLS之前绝不硬编码工具 slug 或参数。执行前校验连接Check connection确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 状态后再执行工具。遵守 schemaSchema compliance使用搜索结果中完全一致的字段名与类型。memory 参数必填RUBE_MULTI_EXECUTE_TOOL调用中必须包含memory哪怕传空对象{}。会话复用Session reuse同一条工作流内复用 session ID新工作流生成新 ID避免跨任务串状态。分页处理Pagination检查响应中的分页 token持续拉取直至数据完整防止漏取结果。这六条中“先搜索”与“memory 必填”是Rube MCP协议层面的硬性约定违反它们大概率导致工具调用被拒绝或参数不匹配其余几条属于流程纪律用于保证多步工作流的正确性与幂等性。在 Codex 中安装与触发该技能该技能位于仓库的composio-skills/dialpad-automation/目录。结合 README.md 与 skill-installer/SKILL.md 的说明安装与触发方式为克隆仓库后使用仓库自带安装脚本把技能放入$CODEX_HOME/skills默认~/.codex/skills。脚本入口为 install-skill-from-github.pyREADME 给出的标准用法形如python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/dialpad-automation该脚本支持--ref、--dest、--method auto|download|git等参数公网仓库默认走直接下载、失败时回退 git sparse checkout目标目录已存在时会中止。重启 Codex使其重新加载技能元数据可通过ls ~/.codex/skills与head ~/.codex/skills/dialpad-automation/SKILL.md验证安装。在会话中用自然语言描述 Dialpad 任务例如“帮我把 Dialpad 里某团队的通话记录导出”Codex 会根据 frontmatter 的description自动触发匹配技能也可以直接点名dialpad-automation强制考虑。前提仍是你的 Codex 客户端已按上文 Setup 接入 Rube MCP 端点并完成 Dialpad 授权否则技能触发后会在连接校验环节被“状态非 ACTIVE”挡下。小结dialpad-automation是 awesome-codex-skills 中 Composio 技能族的一个标准样本它把“工具动态发现 连接状态校验 schema 合规执行”固化为可被 Codex 直接触化的指令包把 Dialpad 的凭据与授权复杂度全部收敛到 Rube MCP 网关一侧。由于该协议在composio-skills/下的数百个技能中保持同构RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL辅以RUBE_REMOTE_WORKBENCH与RUBE_GET_TOOL_SCHEMAS两条进阶路径本文梳理的这套三步模式可以平移到其中任何一个 toolkit 的自动化场景。【免费下载链接】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),仅供参考