在 Codex 中通过 Rube MCP 与 Composio 自动化 Google Address Validation 地址校验完整技能实战指南【免费下载链接】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 中的 google-address-validation-automation 技能文档 编写系统讲解如何让 Codex Agent 通过 Rube MCPComposio 提供的统一 MCP 网关调用 Google Address Validation 工具包完成地址验证、标准化等自动化操作。读完本文你将掌握一条技能的 YAML 元数据结构、先发现工具、再检查连接、后执行调用的三段式工作流范式以及 session 复用、schema 合规、分页处理等实战细节可直接用于搭建自己的地址校验自动化 Agent。一、这条技能解决什么问题在电商下单、物流配送、CRM 客户数据治理等业务中地址是否真实存在、是否可投递、写法是否规范是高频且必须的校验动作。Google Address Validation 是 Google Maps Platform 提供的地址校验服务能够验证地址的真实性与可投递性、返回标准化的地址组件街道、城市、邮政编码等并给出修正建议。本仓库中的google-address-validation-automation技能位于 composio-skills/google-address-validation-automation/做的事情是让 Codex 通过Rube MCP这座桥直接驱动 Composio 提供的google_address_validation工具包把地址校验从一句描述变成一次真实可执行的工具调用。技能的 SKILL.md 头部 YAML 元数据如下--- name: google-address-validation-automation description: Automate Google Address Validation tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段 frontmatter 是 Codex 触发技能的依据name是技能标识description说明技能用途自动化 Google Address Validation 任务并强调了一条铁律——Always search tools first for current schemas先搜索工具以获取最新 schemarequires.mcp声明该技能依赖名为rube的 MCP 服务器。根据仓库 README.md 的说明Codex 技能就是这样一个包含SKILL.md的目录Codex 依据description元数据决定何时触发技能触发后才加载正文从而保持上下文精简。二、核心概念Rube MCP 如何桥接 Google Address Validation整个自动化链路的关键是Rube MCP。它是一个无需 API Key 的 MCP 端点在客户端配置中添加https://rube.app/mcp作为 MCP 服务器即可使用。Rube MCP 对外暴露一组以RUBE_前缀命名的 MCP 工具本技能涉及的主要有Rube MCP 工具职责RUBE_SEARCH_TOOLS按 use_case 搜索 Composio 工具返回工具 slug、输入 schema、推荐执行计划与已知陷阱RUBE_MANAGE_CONNECTIONS管理创建/查询第三方应用连接检查连接状态RUBE_MULTI_EXECUTE_TOOL批量执行一个或多个 Composio 工具调用RUBE_REMOTE_WORKBENCH远程工作台用于批量/复杂操作内部通过run_composio_tool()执行RUBE_GET_TOOL_SCHEMAS获取带schemaRef引用的工具的完整 schema底层原理可以这样理解Composio 维护了 1000 应用的统一工具层仓库 connect/SKILL.md 对此有更直观的 CLI 版描述而 Rube MCP 将这一工具层以 MCP 协议暴露给任意 MCP 客户端如 Codex。因此 Codex 不需要知道 Google Address Validation API 的细节只要会调用RUBE_*工具就能间接完成真实地址校验。仓库 composio-skills/composio-automation/SKILL.md 与 composio-skills/composio-search-automation/SKILL.md 使用完全相同的结构印证了这是一套覆盖数百个工具包的通用自动化模式。三、前置条件与 Setup3.1 前置条件在运行任何地址校验工作流之前必须满足Rube MCP 已连接环境中存在RUBE_SEARCH_TOOLS工具可用Google Address Validation 连接已激活通过RUBE_MANAGE_CONNECTIONS建立了 toolkit 为google_address_validation的连接且状态为ACTIVE先搜索再执行任何时候调用工具前先用RUBE_SEARCH_TOOLS获取当前工具 schema——工具 schema 会变化硬编码 slug 或参数是不安全的。3.2 获取并接入 Rube MCP在客户端配置中添加 MCP 服务器端点https://rube.app/mcp鉴权无需任何 API Key添加端点即可使用3.3 四步 Setup 流程技能文档给出了标准初始化流程验证 Rube MCP 可用——确认RUBE_SEARCH_TOOLS有响应调用RUBE_MANAGE_CONNECTIONS传入 toolkitgoogle_address_validation发起连接若连接状态不是ACTIVE跟随返回的授权链接完成 OAuth 设置在运行任何工作流前再次确认连接状态为ACTIVE。其中第 2 步的请求骨架RUBE_MANAGE_CONNECTIONS toolkits: [google_address_validation] session_id: your_session_id四、工具发现一切调用的起点技能反复强调先发现工具。首次执行时使用带generate_id的会话发起工具搜索RUBE_SEARCH_TOOLS queries: [{use_case: Google Address Validation operations, known_fields: }] session: {generate_id: true}该调用返回四类关键信息可用工具 slugtool slugs后续执行阶段引用输入 schema即每个工具的参数结构与类型定义推荐执行计划recommended execution plans已知陷阱known pitfalls。在后续工作流中复用既有会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Google Address Validation task}] session: {id: existing_session_id}queries数组支持传入更精确的use_case描述例如validate this address或check deliverabilityknown_fields字段可用于附带已知的字段约束从而缩小搜索范围、提高召回精度。五、核心工作流三步执行模式这是本技能也是整个 composio-skills 系列最通用的执行范式务必按序执行。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Google Address Validation task}] session: {id: existing_session_id}从返回结果中取出目标工具的tool_slug与输入 schema。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [google_address_validation] session_id: your_session_id确认连接为ACTIVE。若为其他状态回到 Setup 步骤补授权。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参数必须始终携带即使为空也要传{}。RUBE_MULTI_EXECUTE_TOOL的tools是数组因此可以在一次调用中批量执行多个校验请求例如批量验证一批客户地址这是提升吞吐的关键。六、批量操作与完整 Schema两个进阶工具技能文档在快速参考中补充了两个进阶场景批量操作使用RUBE_REMOTE_WORKBENCH在远程工作台中通过run_composio_tool()以编程方式编排多步逻辑如批量校验 → 汇总不可投递地址 → 生成修正建议报告适合需要循环、条件分支和结果汇总的复杂任务完整 Schema对返回结果中带schemaRef引用的工具使用RUBE_GET_TOOL_SCHEMAS拉取其完整 schema——这类工具的完整参数定义通常较长Rube 默认可能只返回引用需要显式获取后才能构造合规参数。七、已知陷阱六条实战红线技能文档沉淀了六条高频踩坑经验直接决定工作流的成败永远先搜索工具 schema 会持续变更。不调用RUBE_SEARCH_TOOLS就硬编码 slug 或参数是最大的稳定性风险检查连接执行前必须确认RUBE_MANAGE_CONNECTIONS返回ACTIVE否则调用必然失败Schema 合规参数必须使用搜索结果中的精确字段名和类型不要按常识猜字段Memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须包含memory即使为空对象{}也不能省略Session 复用同一工作流内复用 session ID用于关联上下文与连接新工作流则生成新 session分页处理检查响应中是否携带分页 tokenpagination tokens若存在则继续拉取直到数据完整防止结果截断。八、快速参考速查表技能文档以表格形式给出了五种操作对应的标准做法整理如下可直接作为 Agent 执行时的查表依据操作做法查找工具RUBE_SEARCH_TOOLS携带 Google Address Validation 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 填google_address_validation执行调用RUBE_MULTI_EXECUTE_TOOL使用搜索到的工具 slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具九、典型应用场景基于 Google Address Validation 工具包的能力与上述工作流可以推断该技能适合承载以下自动化任务具体能力以RUBE_SEARCH_TOOLS返回的 schema 为准电商与物流在下单或发货前批量校验收货地址剔除不可投递地址减少退件成本CRM 数据治理清洗客户地址库将非规范地址标准化为统一格式并标记缺失的地址组件表单与风控对用户填写的地址做实时验证拦截虚构地址提升注册与支付环节的数据质量。执行任意场景时建议始终遵守搜索工具 → 检查连接 → 执行调用的顺序并在每个工作流开始时复用会话、结束时处理分页结果。十、结语google-address-validation-automation技能展示了 Codex 自动化的一条高效路径技能SKILL.md 指令→ MCP 网关Rube→ 统一工具层Composio→ 真实业务 APIGoogle Address Validation。它的核心方法论——先发现、后连接、再执行以及schema 以搜索为准、绝不硬编码——不仅适用于地址校验也贯穿于仓库中 composio-skills/ 下数百个同类自动化技能。掌握这一模式后你可以将同样的三段式工作流复用到任何 Composio 支持的第三方服务上让 Codex 从给出建议升级为直接执行。如需将技能安装进本机 Codex 环境可参考 README.md 中的安装指引使用 skill-installer 脚本或手动复制到$CODEX_HOME/skills后重启 Codex技能完整原文与元数据见 google-address-validation-automation/SKILL.md。【免费下载链接】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），仅供参考