awesome-codex-skills 的 Countdown API 自动化技能通过 Rube MCP 驱动倒计时 API 工作流的完整指南【免费下载链接】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本文围绕 countdown-api-automation 技能 展开讲清在 awesome-codex-skills 仓库中如何借助 Composio 的 Rube MCP 网关让 Codex Agent 安全地发现、连接并执行 Countdown API 工具。读完本篇你将掌握该技能的安装落位方式、前置条件核对、四步连接建立流程、“搜索—验连—执行”的核心工作模式以及一组来自技能文档本身的避坑清单与快速参考表。技能定位一个面向 Countdown API 的 MCP 自动化技能composio-skills/countdown-api-automation/SKILL.md 是仓库composio-skills/目录下众多第三方工具包toolkit自动化技能之一。该目录当前收录了数百个结构一致的自动化技能每个技能对应一个外部服务Countdown API 即其中之一——它让 Agent 能够对 Countdown API 的服务执行真实操作而不是只“描述应该做什么”。技能的 YAML frontmatter 完整声明了它的元数据--- name: countdown-api-automation description: Automate Countdown API tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各有关键含义name技能标识Codex 加载技能目录时以此为技能名description说明该技能“做什么”以及最重要的触发原则——始终先搜索工具以获取当前 schemaAlways search tools first这一句话实际上概括了整个技能的设计哲学requires.mcp: [rube]声明该技能依赖 Rube MCP 服务。没有这个 MCP 连接技能正文中的所有工具调用都无法成立。安装与落位如何把这个技能装进 Codex按 README.md 的 Quickstart 说明仓库中的技能有两种安装方式方式一使用 skill-installer 脚本推荐git clone https://gitcode.com/GitHub_Trending/aw/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/countdown-api-automation安装器会把技能抓取并放到$CODEX_HOME/skills/skill-name下。关于安装行为的可参考细节见 skill-installer/SKILL.md若目标技能目录已存在则中止支持多次--path一次安装多个技能网络操作在沙箱中运行时需要申请提权。方式二手动安装将技能文件夹复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 使其加载新元数据在后续会话中用自然语言描述任务或直接提及技能名Codex 会依据description自动触发匹配的技能。无论哪种方式安装后都可以通过ls ~/.codex/skills和head ~/.codex/skills/countdown-api-automation/SKILL.md验证技能是否落位、元数据是否正确。前置条件开工前的三要素技能文档在Prerequisites一节明确列出三项前提缺一不可Rube MCP 已连接——RUBE_SEARCH_TOOLS工具可用Countdown API 连接处于活跃状态——通过RUBE_MANAGE_CONNECTIONS检查 toolkit 为countdown_api的连接任何工作流执行前始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema。第三条不是建议而是硬性纪律Rube MCP 的工具 slug 和入参 schema 会随平台更新而变化技能文档在Known Pitfalls中反复强调“Never hardcode tool slugs or arguments”绝不硬编码工具 slug 或参数。连接建立把 Rube MCP 接进客户端技能文档给出的Setup流程如下获取 Rube MCP在你的 MCP 客户端配置中加入端点https://rube.app/mcp作为 MCP server。文档特别说明“No API keys needed — just add the endpoint and it works”即端点本身即可用鉴权在后续连接管理环节完成。然后按四步验证并建立连接确认RUBE_SEARCH_TOOLS有响应证明 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为countdown_api若连接状态不是 ACTIVE按返回的 auth link 完成授权设置在运行任何工作流之前确认连接状态显示为 ACTIVE。这四步体现了 MCP 网关类技能的典型模式端点接入是通用的对仓库里其他 composio-skills 技能也相同而 toolkit 参数决定了你实际操作的是哪一个第三方服务——本技能锁定的是countdown_api。工具发现RUBE_SEARCH_TOOLS 是工作流的入口在执行 Countdown API 的任何操作前必须先做工具发现。文档给出的标准调用RUBE_SEARCH_TOOLS queries: [{use_case: Countdown API operations, known_fields: }] session: {generate_id: true}要点解析use_case用自然语言描述目标操作这里是泛化的 “Countdown API operations”实际工作流中可以换成更具体的任务描述见下文核心工作流 Step 1known_fields用于提供已知的字段线索首次发现时传空字符串即可session: {generate_id: true}让服务端生成本次会话的 session id后续步骤复用该 id。返回内容包括四部分可用工具 slug、输入 schema、推荐执行计划recommended execution plans、已知坑known pitfalls。这四部分共同构成后续执行步骤的“唯一事实来源”——参数名、类型都必须以这次搜索结果为准。核心工作流搜索 → 验连 → 执行三步模式技能文档将可重复的自动化流程抽象为三步模式这也是理解整类 Rube MCP 技能的关键。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Countdown API task}] session: {id: existing_session_id}与首次发现不同这里把use_case换成“你的具体 Countdown API 任务”并通过session.id复用已有会话 id——这正是文档在 Pitfalls 中要求的“Session reuse同一工作流内复用 session id新工作流再生成新的”。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [countdown_api] session_id: your_session_id执行前复核countdown_api的连接是否仍为 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 搜索结果中返回的 slug 原文不能凭记忆填写arguments注释明确写着 “schema-compliant args from search results”即参数名与类型严格对齐搜索返回的 schemamemory文档在 Pitfalls 中单独强调——每次调用RUBE_MULTI_EXECUTE_TOOL都必须带上memory参数即使为空对象{}也不能省略。这是调用契约的一部分省略可能导致请求不符合预期。已知坑清单技能文档给出的六条纪律Known Pitfalls一节是技能实战价值最密集的部分逐条对应一条可执行的工程纪律纪律说明先搜索再执行工具 schema 会变未调用RUBE_SEARCH_TOOLS前绝不硬编码 slug 或参数先验连接执行工具前确认RUBE_MANAGE_CONNECTIONS显示 ACTIVESchema 合规字段名和类型严格使用搜索结果中的原文memory 参数必带RUBE_MULTI_EXECUTE_TOOL调用中memory不可省略空则传{}会话复用同一工作流复用 session id新工作流才生成新的分页处理检查响应中的分页 token持续拉取直到完整其中“分页处理”一条对批量拉取类操作尤其重要如果 Countdown API 的某个查询返回分页 token 而客户端没有继续翻页拿到的只是部分数据却难以从表面报错中察觉。快速参考表五种操作到五个工具的映射技能文档末尾的Quick Reference把常用操作浓缩为一张对照表完整继承如下OperationApproachFind toolsRUBE_SEARCH_TOOLS配合 Countdown API 具体用例描述ConnectRUBE_MANAGE_CONNECTIONStoolkit 为countdown_apiExecuteRUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slugBulk opsRUBE_REMOTE_WORKBENCH配合run_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具后两行补充了正文工作流未展开的两条能力路径批量操作当需要以脚本化方式批量驱动工具时走RUBE_REMOTE_WORKBENCH其中提供run_composio_tool()函数逐个调用工具完整 schema 拉取搜索结果中若某工具只返回schemaRef引用占位而非内联 schema需要进一步调用RUBE_GET_TOOL_SCHEMAS取得完整定义后再构造参数。技能全景它在 composio-skills 家族中的位置从源码结构看composio-skills/目录下每个子目录如本技能所在的countdown-api-automation/都是一个独立技能目录内只有一个 SKILL.md。整个家族共享同一套模板frontmatter 声明requires.mcp: [rube]正文遵循“Prerequisites → Setup → Tool Discovery → Core Workflow Pattern → Known Pitfalls → Quick Reference”的固定骨架差异只体现在 toolkit 标识如countdown_api和use_case的自然语言描述上。这种高度一致的模板意味着掌握本篇讲解的搜索—验连—执行模式后迁移到仓库中其他 composio-skills 技能的成本极低。另外值得注意的是仓库还提供了另一种不依赖 MCP 的 Composio 集成路径——connect 技能 通过 Composio CLI 完成搜索composio search、执行composio execute与连接管理composio link。可以推断两者的定位区别在于本技能面向已在客户端接入 Rube MCP 的 Agent 会话由模型直接发起 MCP 工具调用而 connect 技能面向 shell 场景由 Codex 通过命令行执行。选型取决于你的 Agent 运行环境是否已挂载 Rube MCP 端点。小结countdown-api-automation 技能的价值不在于它枚举了 Countdown API 的哪些具体接口——恰恰相反它刻意不写死任何工具 slug而是把“先RUBE_SEARCH_TOOLS发现、再RUBE_MANAGE_CONNECTIONS验连、最后RUBE_MULTI_EXECUTE_TOOL执行”固化为技能正文中的强制流程用六条 pitfall 纪律保证 Agent 在工具 schema 演进时依然稳健。结合 README.md 的安装流程把技能放进$CODEX_HOME/skills再按本文的连接与工作流步骤操作即可在 Codex 中跑通对 Countdown API 的自动化操作。该技能与整组 composio-skills 由 Composio 提供原文档标注 Powered by 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考