Codex Skill 实战通过 Rube MCP 自动化 Addresszen 地址服务操作 —— 从连接配置到工作流执行的完整指南【免费下载链接】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 仓库中的 addresszen-automation Skill 为骨架系统讲解如何让 CodexCLI / API通过 Composio 生态的 Rube MCP 网关完成 Addresszen 地址服务的工具发现、OAuth 连接、schema 合规执行与分页取数等全链路自动化。读完本文你将掌握一套先搜工具、再查连接、最后执行的可复用三层工作流模式并能将其泛化到仓库中任意一个 composio-skills 自动化场景。Skill 是什么一份让 Codex 学会操作 Addresszen 的指令包Codex Skill 本质上是存放在$CODEX_HOME/skills/skill-name/SKILL.md中的模块化指令包YAML frontmatter 中的name与description决定 Codex 何时自动触发该 Skill正文则告诉 Codex 具体怎么执行。仓库 README 中对此机制有明确说明Codex 在会话中根据请求与description的匹配度自动加载 Skill 正文从而保持上下文精简。本 Skill 的 frontmatter 如下--- name: addresszen-automation description: Automate Addresszen tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires.mcp: [rube]是一个关键声明它告诉 Codex该 Skill 的运行依赖名为rube的 MCP 服务器即 Rube MCPdescription中Always search tools first for current schemas则点出了整份 Skill 的核心纪律——工具 schema 随时可能变化任何执行前必须先搜索。该 Skill 与仓库中 composio-automation、zoho-automation 等数百个 composio-skills 遵循完全相同的模板化结构本文的流程可以 1:1 迁移到任意 toolkit。前置条件三个缺一不可在开始任何 Addresszen 工作流之前请确认以下三项均已就绪Rube MCP 已连接RUBE_SEARCH_TOOLS工具可用说明网关已打通Addresszen 连接已激活通过RUBE_MANAGE_CONNECTIONS建立的addresszentoolkit 连接状态为ACTIVE执行前先搜索每次运行工作流前必须先调用RUBE_SEARCH_TOOLS获取最新工具 schema禁止依赖记忆中的旧 slug 或参数。环境配置一行 MCP endpoint 搞定无需 API KeyRube MCP 的接入方式极为轻量——不需要预先申请任何 API Key在客户端配置中添加 MCP 服务器地址https://rube.app/mcp添加后即可直接使用。接入后按以下四步完成连接引导确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为addresszen若返回的连接状态不是ACTIVE跟随返回的认证链接完成 OAuth 授权设置在运行任何工作流之前再次确认连接状态显示为ACTIVE。这一步的本质是连接即认证Rube MCP 通过内置的认证流程代替了你在代码里手写 token 的工作OAuth 授权一次后连接长期有效之后所有 Addresszen 调用都复用该连接。工具发现先看货再下单永远不要硬编码执行任何工作流之前必须通过RUBE_SEARCH_TOOLS发现当前可用的工具。文档给出的首次发现示例RUBE_SEARCH_TOOLS queries: [{use_case: Addresszen operations, known_fields: }] session: {generate_id: true}调用后会返回四类关键信息可用的工具 slugtool slugs每个工具的输入 schemainput schemas推荐执行计划recommended execution plans已知的坑known pitfalls。为什么必须这样做Addresszen 或其他任何 Composio toolkit 的接口都可能升级演进硬编码 slug 或参数会让工作流在 schema 变更后静默失败。搜索是保证 schema 合规的前提也是本 Skill 反复强调的第一纪律。核心工作流三层模式完整拆解Step 1发现可用工具在已有会话中继续搜索具体任务对应的工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Addresszen task}] session: {id: existing_session_id}注意此处复用了已存在的session_id而非生成新会话——这体现了会话复用的纪律同一工作流内复用会话 ID新工作流才生成新 ID。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [addresszen] 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必须严格遵循搜索结果返回的字段名与类型memory参数必须始终携带即使为空也要传{}。已知陷阱六条必须遵守的纪律文档以清单形式列出了六个高频踩坑点逐条展开如下陷阱正确做法原因跳过工具搜索每次执行前先调RUBE_SEARCH_TOOLS工具 schema 会变化硬编码 slug/参数必然过时忽略连接状态执行前用RUBE_MANAGE_CONNECTIONS确认ACTIVE未激活连接会直接导致执行失败参数不按 schema使用搜索结果中的精确字段名和类型字段名拼写或类型不符会被网关拒绝遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory即使为空{}该参数是协议必需项会话混用同一工作流内复用 session ID新工作流生成新 ID会话上下文与状态一致性忽略分页检查响应中的分页 token持续拉取直到数据完整列表类接口默认只返回首页数据快速参考五个 Rube 操作一览操作方式查找工具RUBE_SEARCH_TOOLS传入 Addresszen 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 填addresszen执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slugs批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于返回schemaRef的工具其中RUBE_REMOTE_WORKBENCH适用于需要在远程沙箱中批量执行或编写复合逻辑的场景当搜索返回的工具携带schemaRef引用而非内联 schema时则用RUBE_GET_TOOL_SCHEMAS拉取完整定义后再构造参数。模式复用同一套流程驱动整个 composio-skills 家族值得强调的是这份 Skill 的价值不止于 Addresszen 本身。从仓库目录结构可以看出composio-skills 下包含数百个按 toolkit 命名的同类 Skill如 zoho-automation、openai-automation 等它们的骨架完全一致frontmatter 声明requires.mcp: [rube]→ 前置条件 → Rube MCP 配置 → 工具发现 → 三步工作流 → 陷阱清单 → 快速参考表。因此当你在 Codex 中为另一个服务Zoho、Slack、Gmail 等编写或触发自动化时只需把本文中的addresszentoolkit 名称与 use_case 替换为目标服务其余流程——先RUBE_SEARCH_TOOLS发现、再RUBE_MANAGE_CONNECTIONS确认激活、最后RUBE_MULTI_EXECUTE_TOOL按 schema 执行——可以原样套用。这种一份 Skill 模板、全生态通用的设计正是该仓库作为 Codex 实用技能精选集的核心组织方式。【免费下载链接】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），仅供参考