使用 Rube MCP 自动化 Perigon 新闻数据任务awesome-codex-skills 中 perigon-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/perigon-automation/SKILL.md 为骨架系统讲解如何在 Codex 中通过 Rube MCPComposio 的 MCP 网关连接并自动化 Perigon 新闻与信息聚合平台操作。读完本文你将掌握工具发现 → 连接检查 → 工具执行的完整自动化工作流、RUBE 系列工具的正确调用姿势以及可复用的批量执行与 Schema 查询方法能够直接在 Codex CLI 与 API 会话中落地 Perigon 自动化任务。技能概览perigon-automation 是什么perigon-automation是 awesome-codex-skills 仓库composio-skills/目录下的一个 Codex 技能其核心定位是通过 Rube MCP 调用 Composio 的 Perigon 工具包自动化 Perigon 相关的数据获取与处理任务。技能元数据SKILL.md frontmatter定义了它的触发与依赖条件--- name: perigon-automation description: Automate Perigon tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段元数据传达三个关键信息name技能唯一标识安装后对应$CODEX_HOME/skills/perigon-automation/目录名descriptionCodex 依据它判断何时触发本技能——凡是涉及 Perigon 操作的请求都会命中同时开宗明义地强调Always search tools first总是先搜索工具这是贯穿全文的核心纪律requires.mcp声明技能运行依赖rube这个 MCP 服务器未连接时技能不可用。从仓库结构看composio-skills/下按应用划分了数百个同构自动化技能如 composio-skills/composio-automation/SKILL.md、composio-skills/openai-automation/SKILL.md它们的骨架完全一致先声明rubeMCP 依赖再围绕RUBE_SEARCH_TOOLS → RUBE_MANAGE_CONNECTIONS → RUBE_MULTI_EXECUTE_TOOL组织工作流。这意味着本文总结的模式与陷阱同样适用于该目录下其他任意应用技能具备很高的复用价值。前置条件与工作原理运行本技能前需要满足三个前置条件Rube MCP 必须已连接且RUBE_SEARCH_TOOLS工具可正常响应Perigon 连接必须处于 ACTIVE 状态该连接通过RUBE_MANAGE_CONNECTIONS以 toolkitperigon创建和管理任何工作流执行前必须先调用RUBE_SEARCH_TOOLS获取当前工具 Schema。理解这套机制的关键在于Rube 是一个位于 Agent 与 Composio 集成之间的 MCP 网关。Agent 不直接调用 Perigon API而是通过 Rube 暴露的RUBE_*工具间接操作。由于 Composio 侧的工具 Schema参数名、类型、可选字段会随上游演进硬编码工具 slug 或参数必然导致失效因此先搜索、后执行不是可选项而是强约束。环境配置连接 Rube MCP 与 Perigon接入 Rube MCP 无需任何 API Key。只需在客户端配置中将https://rube.app/mcp添加为 MCP 服务器端点即可生效。添加完成后按以下四步完成 Perigon 连接验证 Rube 可用确认RUBE_SEARCH_TOOLS能正常响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkits 参数传[perigon]完成授权若连接状态不是 ACTIVE跟随返回的认证链接完成设置确认状态在运行任何工作流之前确认连接状态显示为 ACTIVE。注意步骤 3 的返回的 auth link是授权流程的产物通常需要人工或具备浏览器能力的 Agent完成 OAuth 授权。未完成授权的连接无法执行任何工具调用。工具发现RUBE_SEARCH_TOOLS 用法Rube 将工具发现抽象为一次语义搜索。执行工作流前应首先发起工具发现请求RUBE_SEARCH_TOOLS queries: [{use_case: Perigon operations, known_fields: }] session: {generate_id: true}参数说明参数含义建议queries[].use_case描述你要执行的任务场景用自然语言写清目标如 Perigon operations 或更具体的任务描述queries[].known_fields你已知的字段/约束无则传空字符串session.generate_id是否自动生成会话 ID工作流首次发起时设为true调用后会返回四类关键信息可用工具 slugtool slugs后续RUBE_MULTI_EXECUTE_TOOL的调用目标输入 Schema每个工具参数的字段名、类型与必填性推荐执行计划针对该 use case 的建议调用顺序已知陷阱known pitfalls该任务场景下的常见坑点。这套返回结构让 Agent 无需查阅外部文档即可按图索骥完成调用也是技能描述中反复强调search tools first的底层原因。核心工作流三步曲Perigon 自动化的标准工作流由三个步骤组成形成一个闭环Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Perigon task}] session: {id: existing_session_id}与首次发现不同工作流中途复用会话时将session.generate_id替换为session.id传入既有的existing_session_id。这样 Rube 可以在同一会话上下文内追踪连续的工具调用。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [perigon] session_id: your_session_id执行任何工具前用该调用确认 Perigon 连接仍为 ACTIVE。连接可能因凭证过期、撤销授权等原因失效跳过此步会让后续调用直接失败。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_idRUBE_MULTI_EXECUTE_TOOL支持在一次调用中传入tools数组批量执行多个工具。每个元素包含tool_slug取自 Step 1 搜索结果的工具标识严禁硬编码arguments严格符合搜索结果 Schema 的参数对象字段名与类型必须逐字匹配memory跨调用状态存储即使为空也必须显式传{}session_id贯穿整个工作流的会话标识。批量操作与完整 Schema 获取对于批量或复杂场景Rube 还提供两个高级工具RUBE_REMOTE_WORKBENCH在远端工作台环境中执行批量操作通过run_composio_tool()函数内联调用 Composio 工具。适合需要循环、条件分支或数据组装的多步任务避免在单次调用中塞入过于复杂的参数RUBE_GET_TOOL_SCHEMAS当某个工具带有schemaRef即 Schema 以引用形式存在时用该工具拉取完整 Schema 定义补齐RUBE_SEARCH_TOOLS未展开的细节。常见陷阱与最佳实践原文档将踩坑经验浓缩为六条纪律逐条展开如下陷阱正确做法硬编码工具 Schema工具 Schema 会变化任何 slug 或参数在使用前都必须经RUBE_SEARCH_TOOLS重新确认绝不沿用旧值跳过连接检查执行前务必用RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE避免在失效连接上白跑调用参数类型不匹配严格使用搜索结果中的字段名与类型大小写、嵌套结构、可选字段都不能想当然遗漏 memory 参数每次RUBE_MULTI_EXECUTE_TOOL调用都必须包含memory即使为空也要显式传{}会话乱用同一工作流内复用同一session_id以保持上下文开启新工作流时生成新的会话 ID忽略分页检查响应中的分页 token未取完的数据要持续翻页直至完整避免结果被截断这六条经验的本质是一致的Rube 层的工具契约是动态的Agent 必须通过运行时探测search/connection/schema而非静态假设来驱动执行。快速参考表操作对应工具查找工具RUBE_SEARCH_TOOLS配合 Perigon 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 传perigon执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH内部调用run_composio_tool()获取完整 SchemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具安装到 Codex 并投入使用本技能按 Codex Skills 规范组织安装方式与仓库中其他技能一致手动安装将 composio-skills/perigon-automation 目录整体复制到$CODEX_HOME/skills/下默认~/.codex/skills/重启 Codex 使其加载元数据。新会话中描述 Perigon 相关任务时Codex 会根据 frontmatter 的description自动触发该技能机制详见 README.md。脚本安装仓库提供了 skill-installer/scripts/install-skill-from-github.py支持从仓库路径安装技能具体参数与行为默认分支、目标目录、--name命名等见 skill-installer/SKILL.md。安装完成后会话中需先接入 Rube MCP配置https://rube.app/mcp端点随后即可按工具发现 → 连接检查 → 执行的流程驱动 Perigon 任务。若你是首次接触这一技能家族还可对照阅读 composio-skills/composio-automation/SKILL.md 与 composio-skills/openai-automation/SKILL.md它们与本文技能共享同一套工作流骨架可以帮助你快速举一反三把同样的自动化模式复制到 Composio 支持的任何集成上。【免费下载链接】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），仅供参考