基于 Rube MCP 与 Composio 的 Page X 自动化实战awesome-codex-skills 官方 Skill 全解析【免费下载链接】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本篇技术指南围绕 awesome-codex-skills 仓库中 page-x-automation Skill 展开系统讲解如何通过 Rube MCP 网关接入 Composio 的 Page X toolkit让 Codex 具备发现工具、建立授权连接并执行真实业务操作的能力。读完本文你将掌握一套「先搜索工具、再校验连接、后执行调用」的可复用自动化范式并能直接复刻到同一仓库中其他 500 集成 Skill 的实战场景。一、这个 Skill 解决什么问题Page X 是面向内容出版与分发领域的业务平台本 Skill 的目标是让 Codex Agent 通过 MCPModel Context Protocol通道自动操作 Page X 账户中的业务数据。其底层链路为Codex CLI / API │ 触发 page-x-automation Skill依据 SKILL.md 的 description 元数据 ▼ Rube MCP 服务器rube.app/mcp 端点无需 API Key │ 暴露 RUBE_SEARCH_TOOLS / RUBE_MANAGE_CONNECTIONS / RUBE_MULTI_EXECUTE_TOOL 等能力 ▼ Composio Page X toolkit统一承载 OAuth 授权与工具执行与仓库内其他数百个composio-skills/*-automation目录如 composio-automation、composio-search-automation同构本 Skill 的SKILL.md通过 YAML frontmatter 声明元数据--- name: page-x-automation description: Automate Page X tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中description决定了 Codex 在何种任务下自动触发该 Skill而requires.mcp声明了运行时依赖——Rube MCP 必须已在 Codex 客户端中注册。这与仓库 README.md 中描述的 Codex Skill 机制一致Codex 先读取元数据决定是否触发加载正文后才注入完整指令保持上下文精简。二、前置条件在使用本 Skill 前需要确认以下三项都已就绪Rube MCP 已连接RUBE_SEARCH_TOOLS工具可用这是判断 Rube MCP 是否注册成功的标志。Page X 连接已激活通过RUBE_MANAGE_CONNECTIONS建立并保持page_xtoolkit 的 ACTIVE 连接。先搜索后执行任何工作流开始前必须先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema禁止凭记忆硬编码。三、Setup接入 Rube MCP 并建立连接3.1 添加 Rube MCP 服务器在 Codex 的 MCP 客户端配置中将https://rube.app/mcp添加为一个 MCP server。这是接入过程中的关键便利点无需申请任何 API Key只需添加端点即可连通认证统一由 Rube/Composio 侧处理。3.2 四步完成连接建立Skill 文档给出了标准建连流程验证 Rube MCP 可用——确认RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONStoolkit 参数指定为page_x若连接状态不是 ACTIVE则按返回的授权链接auth link完成 OAuth 设置在运行任何工作流之前再次确认连接状态显示为 ACTIVE。从源码结构看composio-skills/目录下每个*-automationSkill 均遵循同一建连协议仅 toolkit 标识不同如ably、composio、composio_search等因此这套步骤具有跨集成的通用性。四、工具发现RUBE_SEARCH_TOOLSRube MCP 要求「每次执行前都先搜索」原因在于工具 schema 会随平台演进而变更。首次接入时推荐使用generate_id让 Rube 自动生成会话标识RUBE_SEARCH_TOOLS queries: [{use_case: Page X operations, known_fields: }] session: {generate_id: true}该调用返回四类关键信息可用的工具 slugtool slugs后续执行阶段的调用标识输入 schema每个工具的字段名、类型与必填项推荐的执行计划execution plans针对目标用例的组合调用建议已知陷阱known pitfalls该工具链特有的注意事项。五、核心工作流模式三步法Skill 文档将 Page X 自动化收敛为三个固定步骤这一模式适用于任意具体任务发布内容、拉取数据、批量操作等。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Page X task}] session: {id: existing_session_id}将use_case替换为你的具体任务描述如 publish a new article、fetch page analytics并复用当前工作流的会话 ID。搜索结果的 slug 与 schema 是 Step 3 的唯一事实来源。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [page_x] session_id: your_session_id在每次执行前确认连接仍处于 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_id执行阶段的三个要点tool_slug必须取自 Step 1 搜索结果不得臆造arguments的字段名与类型必须与搜索结果中的 schema 完全一致memory参数即使为空也必须显式携带传{}。六、已知陷阱Known PitfallsSkill 文档明确列出六条高频踩坑点实操时务必逐条对照#陷阱规避方式1跳过搜索直接执行工具 schema 会变化绝不硬编码 tool slug 或参数必须先调RUBE_SEARCH_TOOLS2连接状态未确认执行前用RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE3schema 不匹配严格使用搜索结果给出的字段名与类型逐字对齐4遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL每次调用都必须带memory即使为空对象{}5会话复用不当同一工作流内复用 session ID新工作流必须生成新的 session ID6忽略分页检查响应中的分页令牌pagination tokens持续拉取直到数据完整七、快速参考四类操作速查表操作对应方式查找工具RUBE_SEARCH_TOOLS传入 Page X 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定为page_x执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索得到的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于返回结果带schemaRef的工具其中RUBE_REMOTE_WORKBENCH面向批量/复杂场景允许在远程工作台中通过run_composio_tool()编程式编排多次调用RUBE_GET_TOOL_SCHEMAS则用于按schemaRef引用拉取更完整的参数定义作为RUBE_SEARCH_TOOLS结果的补充。八、将 Skill 安装到 Codex本 Skill 的安装遵循仓库统一的 README.md 指南方式一使用 Skill Installer推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/page-x-automation安装器会将 Skill 放置到$CODEX_HOME/skills/page-x-automation/重启 Codex 后生效。方式二手动安装将 composio-skills/page-x-automation/ 整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以加载新的 frontmatter 元数据在会话中直接描述任务如「帮我自动化 Page X 的发布流程」Codex 会根据description自动匹配并触发本 Skill。安装完成后可用ls ~/.codex/skills与head ~/.codex/skills/page-x-automation/SKILL.md验证元数据已加载。九、同构 Skill 的横向复用从仓库源码结构看composio-skills/下存在数百个结构完全一致的自动化 Skillably-automation、composio-automation、composio-search-automation 等均可作为对照样本。它们共享同一套 Rube MCP 协议与「搜索—连接—执行」三步范式差异仅在toolkit标识与use_case描述。因此本文总结的建连步骤、调用格式与六条陷阱可无损迁移到任意 Composio 集成场景——你只需把page_x替换为目标 toolkit 名称即可构建全新的自动化 Skill。【免费下载链接】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），仅供参考