企业官网建设流程全解析

用 Codex 技能自动化 Verifiedemail 操作：基于 Rube MCP 与 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

本指南以 verifiedemail-automation 技能 为核心，系统讲解如何在 Codex CLI / API 环境中通过 Rube MCP（Composio 的 MCP 网关）接入 Verifiedemail 工具集，完成从环境配置、连接授权到工具发现、任务执行的全流程自动化。读完本文，你将掌握RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL三个核心工具的调用范式，以及批量操作、分页处理和 schema 合规等实战要点，可直接复用到仓库内任意一个 Composio 自动化技能上。

一、技能概览：SKILL.md 里有什么

verifiedemail-automation是 awesome-codex-skills 仓库composio-skills/目录下数百个同构自动化技能之一。仓库中每个*-automation技能都遵循同一套模板结构：通过 Rube MCP 暴露的 Composio 工具集，让 Codex 以自然语言驱动真实世界的第三方服务操作。

该技能的 SKILL.md 顶部是 YAML frontmatter：

--- name: verifiedemail-automation description: "Automate Verifiedemail tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube] ---

• name：技能唯一标识，同时决定了技能目录名。
• description：Codex 判断何时触发该技能的唯一依据。这里明确写入了两个关键触发语义——"通过 Rube MCP 自动化 Verifiedemail 任务"以及"始终先搜索工具以获取当前 schema"，确保 Agent 在收到邮件验证类任务时能被正确唤起。
• requires.mcp：声明该技能运行依赖rube这个 MCP 服务器，属于 skill-creator 规范 中 frontmatter 的标准字段之一。

按 README 对 Codex 技能机制的解释，技能元数据（name + description）常驻上下文，而正文仅在技能被触发后才加载，这正是本文档刻意保持精炼的原因。

二、前置条件：开始前的三项检查

在运行任何工作流之前，技能要求确认以下三点缺一不可：

1. Rube MCP 已连接：环境内存在可用的RUBE_SEARCH_TOOLS工具（MCP 工具以RUBE_为前缀暴露）。
2. Verifiedemail 连接为 ACTIVE：通过RUBE_MANAGE_CONNECTIONS建立并激活 Verifiedemail 工具集的账号连接。
3. 先调用RUBE_SEARCH_TOOLS：工具 schema 会随服务演进，每次执行前必须重新获取最新 schema，这是本技能反复强调的铁律。

其中第 3 点对使用体验影响最大：Composio 的工具集 schema 由上游服务动态生成，硬编码工具 slug 或参数会导致调用失败，因此"先搜索、后执行"是稳定性的前提。

三、环境设置：接入 Rube MCP 并激活连接

3.1 配置 Rube MCP 服务器

技能给出的接入方式非常轻量：在 MCP 客户端配置中新增一个服务器端点即可，无需任何 API Key：

服务器端点：https://rube.app/mcp

在 Codex 的 MCP 配置（如~/.codex/config.toml）中注册该端点后，RUBE_前缀的工具即对 Agent 可见。

3.2 激活 Verifiedemail 连接的四步流程

1. 通过确认RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 已就绪；
2. 调用RUBE_MANAGE_CONNECTIONS，指定工具集verifiedemail；
3. 若返回的连接状态不是ACTIVE，跟随返回的授权链接完成第三方账号的 OAuth 授权；
4. 在运行任何工作流之前，再次确认连接状态为ACTIVE。

整个流程与仓库内其他技能（如 composio-automation）完全一致，区别仅在于toolkits参数的值不同——这正是 Composio 统一连接层带来的复用红利：一次 MCP 接入，千种工具集通用。

四、工具发现：先搜索，再执行

在任何任务开始前，技能要求先执行工具发现，典型调用如下：

RUBE_SEARCH_TOOLS queries: [{use_case: "Verifiedemail operations", known_fields: ""}] session: {generate_id: true}

调用返回四类关键信息：

• 可用工具 slug 列表：后续RUBE_MULTI_EXECUTE_TOOL需要填入的tool_slug；
• 输入 schema：每个工具的字段名、类型与必填项；
• 推荐执行计划：针对该 use case 的官方建议调用顺序；
• 已知陷阱：该工具集特有的易错点。

known_fields参数用于提供你已掌握的字段线索（留空则全量搜索），session.generate_id: true用于新工作流创建新会话 ID。

五、核心工作流：发现 → 检查 → 执行

技能给出了一个稳定的三步执行模式，适用于任意 Verifiedemail 任务。

Step 1：发现可用工具

RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Verifiedemail task"}] session: {id: "existing_session_id"}

将use_case替换为你的具体任务描述（例如"验证一批邮箱地址"或"查询某次验证记录"），并在同一工作流内复用已有会话 ID。

Step 2：检查连接

RUBE_MANAGE_CONNECTIONS toolkits: ["verifiedemail"] 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参数必须始终携带，即使为空也要传{}；
• 一次可传入多个 tool 对象实现多工具串联执行。

六、进阶能力：批量操作与完整 Schema 获取

技能快速参考表补充了两个进阶入口：

批量操作：使用RUBE_REMOTE_WORKBENCH并在其中调用run_composio_tool()，适合需要对大量邮箱记录执行同一操作的场景，例如批量验证、批量导出结果。

完整 Schema 获取：当搜索结果只返回schemaRef引用而非完整 schema 时，使用RUBE_GET_TOOL_SCHEMAS拉取工具的完整定义，补齐字段细节后再构造arguments。

分页处理：当响应包含分页 token 时，必须持续翻页直到取回全部数据，否则会遗漏部分结果——这是数据处理类任务最容易被忽略的坑。

七、已知陷阱清单：六条经验法则

技能用专门一节总结了运行此类工作流的六条铁律，逐条展开如下：

八、快速参考表

九、源码级纵深：这个技能为什么这样设计

9.1 与仓库技能体系的统一范式

verifiedemail-automation并非孤例。在composio-skills/目录下，ahrefs-automation、slackbot-automation、zoho-crm-automation 等数百个技能共享完全相同的骨架：同一个RUBE_工具集，仅切换toolkits参数与use_case描述。因此，本文讲解的调用范式可以直接迁移到仓库内任意 Composio 集成，掌握一个等于掌握全部。

9.2 遵循 Codex 技能设计规范

对照仓库的 skill-creator 规范 可以印证本文档的设计合理性：

• 正文精炼：规范要求 SKILL.md 正文控制在 500 行以内、只保留必要的过程性指引——本技能全文 91 行，属于"medium freedom"档位，既给出了稳定的三步调用序列，又保留了每个任务的具体参数自由度；
• frontmatter 触发机制：规范强调 description 是唯一触发依据，本技能在 description 中显式声明了"先搜索工具获取 schema"的行为约束，让 Codex 在被触发的同时就获得正确的工作方式；
• 渐进式披露：细节（如具体工具 slug、schema）不在文档中固化，而是通过RUBE_SEARCH_TOOLS按需获取，避免文档随上游 schema 频繁过期。

9.3 如何安装与启用该技能

按 README 快速开始 的说明，将composio-skills/verifiedemail-automation目录复制到$CODEX_HOME/skills/（默认~/.codex/skills/）下，重启 Codex 加载元数据后，在会话中描述邮件验证类任务即可自动触发该技能。可用ls ~/.codex/skills验证安装、用head ~/.codex/skills/verifiedemail-automation/SKILL.md检查元数据。

十、一个完整的最小调用链示例

把上述内容串起来，一次标准的 Verifiedemail 自动化任务包含以下顺序（仅示意参数结构，具体 slug 与字段以RUBE_SEARCH_TOOLS实时返回为准）：

// 1. 发现工具 RUBE_SEARCH_TOOLS queries: [{use_case: "Verifiedemail operations", known_fields: ""}] session: {generate_id: true} // 2. 激活/确认连接 RUBE_MANAGE_CONNECTIONS toolkits: ["verifiedemail"] session_id: "新生成的会话ID" // 3. 执行任务 RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: "搜索返回的slug", arguments: {"schema中的字段": "合规的值"} }] memory: {} session_id: "同一会话ID"

三步之间保持会话 ID 一致，是确保连接上下文与执行上下文连贯的关键。熟练之后，你可以在此基础上叠加RUBE_REMOTE_WORKBENCH处理批量任务、借助RUBE_GET_TOOL_SCHEMAS处理复杂参数，将邮件验证类工作流完整自动化。

【免费下载链接】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