awesome-codex-skills 实战用 enginemailer-automation 技能通过 Rube MCP 自动化 Enginemailer 邮件营销操作【免费下载链接】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本文以 enginemailer-automation 技能文档 为核心完整讲解该 Codex 技能如何通过 Composio 的 Rube MCP 网关对接 Enginemailer 邮件营销平台从 MCP 端点接入、连接状态校验到工具发现 → 连接检查 → 工具执行的三步工作流并逐条解析官方列出的六项常见陷阱Known Pitfalls。读完本文你能够独立完成该技能的部署验证并在 Codex 会话中以 schema 合规的方式驱动 Enginemailer 自动化任务。技能定位与 Frontmatter 声明enginemailer-automation 是 awesome-codex-skills 仓库中composio-skills/目录下的一个标准 Composio 自动化技能其定位是通过 Rube MCP 自动化 Enginemailer 任务。技能元信息在 SKILL.md 的 YAML frontmatter 中声明--- name: enginemailer-automation description: Automate Enginemailer tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---两个字段值得注意description按照 README.md 中 Creating Skills 一节的最佳实践description 是 Codex 判断何时触发该技能的依据因此这里把Always search tools first总是先搜索工具获取当前 schema这一核心执行纪律直接写进了触发描述中requires: mcp: [rube]显式声明该技能依赖名为rube的 MCP 服务器即 Rube MCP / Composio 网关这是后续所有操作的前提。前置条件Prerequisites文档明确列出三项前置条件在执行任何 Enginemailer 工作流之前都应逐条确认Rube MCP 已连接客户端中必须存在可用的RUBE_SEARCH_TOOLS工具以此作为连通性探针Enginemailer 连接处于活跃状态通过RUBE_MANAGE_CONNECTIONS以 toolkit 名enginemailer管理连接状态须为ACTIVE先搜索、后执行始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema再执行任何工具调用。第三条是整个技能最重要的设计原则——Composio 工具集的 slug工具标识符与参数 schema 会随上游迭代而变化技能文档明确要求Never hardcode tool slugs or arguments without callingRUBE_SEARCH_TOOLS未经搜索不得硬编码工具 slug 或参数。Setup接入 Rube MCP 端点接入方式非常轻量不需要任何 API Key在客户端的 MCP 配置中把https://rube.app/mcp添加为 MCP server 端点即可。文档给出的四步接入验证流程为确认RUBE_SEARCH_TOOLS有响应证明 Rube MCP 已可用调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为enginemailer若连接状态不是ACTIVE按工具返回的授权链接auth link完成 OAuth/授权流程在运行任何工作流之前再次确认连接状态显示为ACTIVE。其中第 3 步说明授权是惰性的连接工具本身负责判断连接是否已建立未建立时返回一个需要人工在浏览器中完成的授权链接授权完成后连接才转为ACTIVE。因此确认 ACTIVE 再跑工作流第 4 步应视为硬性检查点而非可选建议。工具发现Tool Discovery执行工作流前必须先做工具发现。文档给出的标准发现调用为RUBE_SEARCH_TOOLS queries: [{use_case: Enginemailer operations, known_fields: }] session: {generate_id: true}参数含义queries[].use_case用自然语言描述具体使用场景如Enginemailer operations由网关侧做工具召回queries[].known_fields可选的已知字段提示首次发现时留空即可session.generate_id: true让网关为本次工作流生成一个 session id供后续步骤复用。该调用返回四类内容构成后续执行的依据可用工具的 slug 列表每个工具的输入 schema字段名、类型、必填性推荐执行计划recommended execution plans已知陷阱known pitfalls。这正是 frontmatter 中Always search tools first的落地方式每次任务开始时重新搜索而不是凭记忆写参数。核心工作流三步模式Core Workflow Pattern文档将一次完整的 Enginemailer 自动化执行归纳为三步。三步之间通过 session id 串联。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Enginemailer task}] session: {id: existing_session_id}注意此处session传的是id而非generate_id即复用 Step 0初次发现生成的会话。use_case应替换为具体的 Enginemailer 任务描述以便网关做更精确的召回。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [enginemailer] session_id: your_session_id该步骤是执行前的安全带只有返回中enginemailertoolkit 的连接状态为ACTIVE时才允许进入 Step 3。若为未激活状态应回到 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 搜索结果中返回的 slug不得手写猜测arguments必须严格符合搜索结果中的 schema——字段名和类型都要与搜索返回一致文档在 Known Pitfalls 中专门用 Schema compliance 强调了这一点memory参数必须出现即使为空对象{}也不能省略这是RUBE_MULTI_EXECUTE_TOOL的强制入参约定。已知陷阱Known Pitfalls逐条解析文档列出了六条 Known Pitfalls它们本质上构成了该技能的执行守则这里逐条说明其工程含义陷阱要点与原因Always search first总是先搜索工具 schema 会变化不先调RUBE_SEARCH_TOOLS就硬编码 slug/参数是此类网关型技能最常见的失败原因Check connection先查连接执行前必须确认RUBE_MANAGE_CONNECTIONS显示ACTIVE否则调用会因授权失效而失败Schema complianceschema 合规使用搜索结果中的精确字段名与类型不要凭经验拼参数Memory parametermemory 参数RUBE_MULTI_EXECUTE_TOOL必须携带memory空时也要传{}缺省会导致调用被拒Session reuse会话复用同一工作流内复用同一个 session id开启新工作流时再生成新 id避免上下文串扰Pagination分页检查响应中的分页 token循环拉取直到完整避免只处理了第一页数据快速参考表Quick Reference文档末尾给出的操作速查表可直接作为日常操作手册操作对应方式查找工具RUBE_SEARCH_TOOLSuse_case 填具体的 Enginemailer 场景建立连接RUBE_MANAGE_CONNECTIONStoolkit 为enginemailer执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现到的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS速查表中最后两行补充了两个进阶入口当任务需要跨多个工具做批量编排时使用RUBE_REMOTE_WORKBENCH远端工作台模式在脚本中以run_composio_tool()驱动当搜索结果只返回了schemaRefschema 引用占位而非完整入参定义时需再用RUBE_GET_TOOL_SCHEMAS拉取完整 schema 后才能构造合规的arguments。在仓库上下文中安装与触发该技能从源码结构看composio-skills/下共有 800 余个*-automation技能enginemailer-automation 只是其中之一它们共享同一套 Rube MCP 工作流模板——本仓库中约 750 个技能文档都包含RUBE_MULTI_EXECUTE_TOOL调用模式800 余个文档都指向https://rube.app/mcp端点。因此掌握本文的 enginemailer 工作流后可平移到仓库中其他 Composio 自动化技能。将该技能装入 Codex 有两种方式依据 README.md 的 Quickstart方式一使用仓库自带的安装脚本推荐git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/enginemailer-automation安装脚本为 install-skill-from-github.py它会把技能拉取并放置到$CODEX_HOME/skills/skill-name默认~/.codex/skills/。方式二手动安装将composio-skills/enginemailer-automation/整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以重新加载技能元数据在会话中描述 Enginemailer 相关任务或直接提及技能名Codex 会依据 frontmatter 的description自动匹配触发该技能。安装后可通过ls ~/.codex/skills与head ~/.codex/skills/enginemailer-automation/SKILL.md验证文件与元数据是否就位。小结验证清单执行任意 Enginemailer 自动化任务前按顺序核对以下检查项即可保证调用链路完整MCP 配置中已添加https://rube.app/mcp端点RUBE_SEARCH_TOOLS有响应RUBE_MANAGE_CONNECTIONStoolkitenginemailer返回ACTIVE已用当前任务描述调用过RUBE_SEARCH_TOOLS拿到最新 slug 与 schemaRUBE_MULTI_EXECUTE_TOOL的arguments与搜索返回 schema 完全一致且携带了memory: {}同一工作流内复用 session id新任务才生成新 session对带分页的响应继续翻页直至取完。该技能本身不包含脚本或附加资源目录内仅一个 SKILL.md全部能力依赖 Rube MCP 网关侧动态提供的工具集——这正是它把先搜索、后执行写入 description 与正文的根本原因。【免费下载链接】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），仅供参考