awesome-codex-skills通过 Rube MCP 自动化 Castingwords 的 Codex 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本文以 composio-skills/castingwords-automation/SKILL.md 为主体完整讲解这个 Codex Skill 如何让 Agent 在 Composio 的 Castingwords 工具包上执行自动化操作从 Rube MCP 的接入与连接认证到“搜索工具 → 校验连接 → 执行工具”的三步标准工作流再到 6 条必须遵守的执行纪律。读完本文你可以在 Codex CLI 中安装并触发该技能理解其 frontmatter 元数据机制并把这套“先搜索、后执行”的协议模式复用到仓库中其他 800 多个 Composio 工具包技能上。1. 技能定位与元数据一个标准的 Composio 工具包技能castingwords-automation是 awesome-codex-skills 仓库 composio-skills/ 目录下的一个技能子目录。该目录是仓库中规模最大的技能族共收录 832 个以-automation结尾的技能如 composio-automation/SKILL.md、composio-search-automation/SKILL.md它们共享同一套“Composio 工具包 Rube MCP”的自动化协议只有目标工具包名称不同。技能的全部行为定义集中在唯一的 SKILL.md 文件中其 YAML frontmatter 如下--- name: castingwords-automation description: Automate Castingwords tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---结合仓库 README.md 中 “What Are Codex Skills?” 一节的说明可以逐字段理解这段元数据的作用字段取值作用namecastingwords-automation技能唯一标识与技能目录名保持一致用户可在会话中按名提及以强制考虑该技能description“Automate Castingwords tasks via Rube MCP (Composio). Always search tools first for current schemas.”触发依据。Codex 在加载阶段只读取元数据用它判断当前请求是否应触发该技能命中后才会加载正文requires.mcp[rube]声明该技能的运行前置依赖客户端必须已连接名为rube的 MCP 服务器否则正文中的所有RUBE_*工具都不可用这种“元数据先行、正文按需加载”的设计README 称之为 keeping context lean意味着description写得越准确技能的触发命中率越高——这也是 README “Creating Skills” 一节明确要求保持 description 精确的原因。从源码结构看该技能目录内只有SKILL.md一个文件没有scripts/、references/等可选子目录对比 mcp-builder/ 这类携带脚本的技能。也就是说本技能是纯指令型技能它不执行本地脚本而是把一套调用远程 MCP 工具的协议教给 Agent由 Agent 在会话中按步骤发起工具调用。2. 环境准备接入 Rube MCP 并完成 Castingwords 连接技能正文的 Prerequisites 一节列出三条前置条件Rube MCP 必须已连接RUBE_SEARCH_TOOLS工具可用通过RUBE_MANAGE_CONNECTIONS工具建立 toolkit 为castingwords的有效连接任何工作流执行前都必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema。Setup 一节给出接入步骤在客户端的 MCP 服务器配置中加入端点https://rube.app/mcp。文档明确指出“No API keys needed — just add the endpoint and it works”即无需在本地配置 API Key认证流程推迟到连接阶段完成。随后按以下 4 步验证环境确认RUBE_SEARCH_TOOLS有响应证明 Rube MCP 服务器已连通调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为castingwords若返回的连接状态不是 ACTIVE跟随返回的认证链接auth link完成授权在执行任何工作流前再次确认连接状态显示为 ACTIVE。这里的关键设计是“连接状态门禁”工具执行被硬性依赖 ACTIVE 状态Agent 不能跳过第 4 步直接调用业务工具。这一约束同时被写入了下文第 5 节的 Known Pitfalls形成双重复核。3. 工具发现为什么必须“先搜索、后执行”技能正文的 Tool Discovery 一节给出了标准的发现调用RUBE_SEARCH_TOOLS queries: [{use_case: Castingwords operations, known_fields: }] session: {generate_id: true}参数含义queries是查询数组use_case用自然语言描述任务此处为 Castingwords operationsknown_fields留空表示不预先假设任何字段session: {generate_id: true}表示让服务端为本次工作流生成新的会话 ID后续步骤将复用该 ID。文档明确说明该调用会返回四类信息可用工具的 slugtool_slug、输入参数 schema、推荐的执行计划recommended execution plans以及已知陷阱known pitfalls。“Always discover available tools before executing workflows” 是本技能的第一原则。其背后的原因是文档在 Known Pitfalls 中给出的工具 schema 会变化Tool schemas change因此绝不允许在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。这也解释了description中那句 “Always search tools first for current schemas” 为什么被写进了触发元数据——它既是使用建议也是技能的自我约束。4. 核心工作流发现 → 校验 → 执行的标准三步技能正文的 Core Workflow Pattern 一节把一次完整的自动化操作拆成三步以下代码块原文继承自 SKILL.mdStep 1: 发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Castingwords task}] session: {id: existing_session_id}与第 3 节的初始发现相比这里session改用{id: existing_session_id}即复用第 3 步生成的会话 IDuse_case则应替换为具体的 Castingwords 任务描述而非笼统的 Castingwords operations以便服务端返回更精确的工具集。Step 2: 校验连接状态RUBE_MANAGE_CONNECTIONS toolkits: [castingwords] session_id: your_session_id注意此处参数名是toolkits数组与session_id与 Setup 阶段首次建立连接时的调用形态一致但语义上这里是“查询/复核”而非“初始化”。返回状态必须为 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——字段名、类型都不能自行推断对应 Pitfalls 中的 Schema compliancememory参数必须显式携带即使为空对象{}也不能省略文档将其列为硬性要求。批量与深层 schema 的两条补充路径技能正文 Quick Reference 表还给出了两条进阶路径原文表格全文继承如下OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Castingwords-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitcastingwordsExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef其中Bulk ops大批量操作不走RUBE_MULTI_EXECUTE_TOOL而是走RUBE_REMOTE_WORKBENCH在其上调用run_composio_tool()完成批量执行Full schema当搜索返回的工具带有schemaRef字段表示 schema 被引用而未内联展开时需要再调用RUBE_GET_TOOL_SCHEMAS拉取完整 schema否则arguments无法保证完整合规。5. 执行纪律6 条 Known Pitfalls 逐条解读技能正文 Known Pitfalls 一节列出 6 条陷阱它们共同构成了这套协议的“防御性编程”Always search first先搜索工具 schema 会变化。未经RUBE_SEARCH_TOOLS确认不得硬编码任何 tool slug 或参数。这是全部 832 个 composio-skills 共享的第一纪律。Check connection查连接执行前必须验证RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态。连接过期或认证中断时强行执行只会得到失败调用。Schema complianceschema 合规使用搜索结果中精确的字段名与类型。MCP 工具调用对参数结构敏感字段名大小写或类型不符都会被拒绝。Memory parametermemory 必传RUBE_MULTI_EXECUTE_TOOL调用中必须包含memory参数空时传{}。省略该字段属于调用格式错误。Session reuse会话复用同一工作流内复用同一个 session ID开启新工作流时才生成新 ID。会话是服务端关联上下文工具发现结果、执行计划、记忆的载体跨工作流混用会污染上下文。Pagination分页处理检查响应中的分页 token持续拉取直到完整。列表类查询若只取第一页Agent 会基于不完整数据做决策。这 6 条纪律中第 1、4、5 条是协议层约束不调用会直接失败第 2、3、6 条是数据质量约束调用了但结果不可信。将二者区分开有助于在实际调试时快速定位故障类型。6. 安装、加载与触发本技能技能本身不携带安装脚本安装动作由 awesome-codex-skills 仓库的 skill-installer/ 或 README Quickstart 流程完成。方式一使用 skill-installer 脚本README 推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # 安装本技能到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/castingwords-automationskill-installer/SKILL.md 对该脚本的行为有完整说明安装目标为$CODEX_HOME/skills/skill-name默认~/.codex/skills若目标目录已存在则中止公网仓库默认直连下载认证失败时回退 git sparse checkout支持--ref默认main、--dest、--method auto|download|git等参数。方式二手动复制按 README.md 的 Manual install 流程把composio-skills/castingwords-automation目录整体复制到~/.codex/skills/下重启 Codex 使其重新加载元数据。触发机制安装并重启后Codex 依据 frontmatter 中的description自动匹配请求——当你描述与 Castingwords 相关的自动化任务或显式提及技能名castingwords-automation时该技能正文即被加载进上下文Agent 按第 25 节所述的协议执行。可用ls ~/.codex/skills与head ~/.codex/skills/castingwords-automation/SKILL.md验证安装结果。7. 小结与适用边界castingwords-automation的价值不在某个具体工具的实现细节而在于它示范了一整套可复用的远程工具自动化协议用requires: mcp声明运行依赖、用“搜索 → 校验 → 执行”的三段式调用链替代硬编码、用 6 条 Pitfalls 约束 Agent 的行为边界。由于 composio-skills/ 下 832 个技能共享完全相同的协议骨架仅 toolkit 名称与use_case描述不同掌握本文的 Castingwords 流程后切换到其他工具包如composio、composio_search等时只需替换toolkits参数与查询描述即可。需要说明的适用边界本技能的所有RUBE_*工具均来自 Rube MCP 服务端仓库本身不包含其实现代码工具的实际可用性、字段集合以RUBE_SEARCH_TOOLS的实时返回为准本文所有协议细节均以 composio-skills/castingwords-automation/SKILL.md 当前版本为唯一依据若上游工具 schema 变更应重新执行工具发现而非沿用旧参数。【免费下载链接】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），仅供参考