基于 awesome-codex-skills 的 Timely 自动化技能通过 Rube MCP 驱动 Composio Timely 工具集【免费下载链接】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本文以仓库中的 timely-automation 技能 为骨架系统讲解如何在 Codex CLI / API 中通过 Rube MCP 自动发现并执行 Composio Timely 工具集完成时间跟踪类任务的端到端自动化。读完本文你将掌握从连接建立、工具发现、参数化执行到批量操作的完整调用链并理解为何每次先搜 schema 再执行是这套体系不可绕过的铁律。技能定位一个 Skill 如何封装 Timely 自动化该技能是仓库 composio-skills 目录下数百个应用自动化技能之一。与同目录的slackbot-automation、composio-automation等技能采用完全一致的模板结构区别仅在于目标工具集toolkit不同——本技能对应Timely时间跟踪工具集。技能本体只有一个文件SKILL.md通过 YAML frontmatter 声明元数据供 Codex 按 description 匹配触发--- name: timely-automation description: Automate Timely tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各有分工name技能唯一标识对应安装后$CODEX_HOME/skills/timely-automation目录名descriptionCodex 判断何时触发该技能的匹配依据。这里特意强调 Always search tools first for current schemas把先搜索、后执行写进触发条件是最重要的行为约束requires.mcp声明本技能依赖名为rube的 MCP 服务器。Codex 加载技能时会据此感知外部工具依赖而RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等工具正是由该 MCP 端点暴露的。安装与启用该技能按仓库 README.md 的标准方式安装。推荐使用 skill-installer 的安装脚本git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/timely-automation也可以手动把composio-skills/timely-automation目录复制到$CODEX_HOME/skills/默认~/.codex/skills/然后重启 Codex使其加载新的 frontmatter 元数据。之后在会话中自然描述用 Timely 记录工时/查询时间条目之类的任务Codex 便会根据description自动触发该技能。前置条件与运行架构技能文档明确列出三条前置条件缺一不可Rube MCP 已连接环境内可访问RUBE_SEARCH_TOOLS工具存在 ACTIVE 的 Timely 连接通过RUBE_MANAGE_CONNECTIONS建立toolkit 指定为timely每次执行前先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。整个调用链的本质是Codex客户端→ Rube MCP统一入口→ Composio认证与连接管理→ Timely API。Rube MCP 在这里扮演网关角色你不需要为 Timely 单独申请 API key连接状态OAuth 授权、有效性全部由 Composio 托管MCP 层只负责把工具暴露给 Agent。Setup 接入四步建立可用环境技能文档给出的接入步骤非常精简核心是先验证、再连接、确认 ACTIVE 后才干活获取 Rube MCP在客户端的 MCP 服务器配置中添加入口地址https://rube.app/mcp。无需任何 API key——只需添加端点即可使用。验证连通性确认RUBE_SEARCH_TOOLS有响应以此判断 Rube MCP 已就绪发起连接调用RUBE_MANAGE_CONNECTIONStoolkits参数传[timely]完成授权若连接状态不是 ACTIVE按返回的授权链接完成 OAuth 设置即用户在 Timely 侧登录授权Composio 保存凭证确认就绪在运行任何工作流前确认连接状态显示为 ACTIVE。第 3、4 步是实际生产环境中最常见的失败点连接建立后若未完成 OAuth 跳转授权或授权过期工具调用会直接报认证错误。因此文档强调先检查连接、再执行工具。工具发现先搜 schema 再动手技能把工具发现Tool Discovery列为执行工作流的前置强制动作示例负载如下RUBE_SEARCH_TOOLS queries: [{use_case: Timely operations, known_fields: }] session: {generate_id: true}调用后返回四类关键信息可用工具 slug 列表即后续RUBE_MULTI_EXECUTE_TOOL中tool_slug的取值来源输入 schema每个工具的参数结构、字段名与类型是构造arguments的唯一权威依据推荐执行计划针对 use_case 给出的编排建议已知坑位known pitfalls官方标注的该工具集常见踩坑点。设计上queries的use_case应尽量具体如 create a Timely time entryknown_fields可用于补充已知字段约束session.generate_id: true表示由服务端生成新会话 ID。为什么不能硬编码工具 slug因为工具 schema 会随 Timely API 演进而变化。技能文档的 Known Pitfalls 第一条即警告Never hardcode tool slugs or arguments without callingRUBE_SEARCH_TOOLS。任何写死的 slug 都可能在某次上游更新后失效唯有每次动态发现才能保证参数与当前 API 对齐。核心工作流三步模式详解技能文档定义的标准执行模式是发现 → 检查连接 → 执行的三步流水线全部负载原样继承如下。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Timely task}] session: {id: existing_session_id}与首次发现不同工作流中途复用会话时应传session.id已有会话 ID而不是generate_id: true从而保持会话连续性。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [timely] session_id: your_session_id确认timely工具集的连接状态为 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必须严格符合该 slug 的输入 schema字段名、类型逐一对应memory参数必须始终携带即使没有需要保留的状态也传空对象{}——这是协议层面的硬性要求遗漏会导致调用失败tools是数组支持在一次调用中编排多个工具按顺序执行。已知坑位六条实战铁律技能文档沉淀的六条 pitfalls 是这套体系最值得咀嚼的部分逐条展开Always search first工具 schema 会变化。未经RUBE_SEARCH_TOOLS不得硬编码任何 slug 或参数——这是整个技能的第一原则Check connection执行前必须用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态。连接过期是最隐蔽的失败原因报错往往指向认证失败而非业务参数Schema compliance使用搜索结果给出的精确字段名与类型不要凭直觉推断参数。Timely 工具集的参数如时间格式、项目 ID 字段与通用命名差异较大schema 是唯一依据Memory parameterRUBE_MULTI_EXECUTE_TOOL调用中永远包含memory空状态也传{}Session reuse同一工作流内复用 session ID保持上下文与状态关联新工作流则生成新 ID——不要跨任务复用旧会话Pagination检查响应中的分页 token若存在后续页则持续拉取直到数据取完避免结果被截断导致统计失真。快速参考表技能文档提供的速查表完整保留如下OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Timely-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkittimelyExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef表格揭示了三个进阶入口批量操作用RUBE_REMOTE_WORKBENCH当需要跨多个工具编排、或处理循环逻辑如遍历多个时间条目逐条更新时在工作台内通过run_composio_tool()编程式调用工具比逐条RUBE_MULTI_EXECUTE_TOOL更高效完整 schema用RUBE_GET_TOOL_SCHEMAS当搜索结果只给出schemaRef引用而非内联 schema 时用该工具拉取完整定义三张表联动覆盖了查工具 → 连应用 → 执行的全生命周期RUBE_REMOTE_WORKBENCH与RUBE_GET_TOOL_SCHEMAS则构成面向复杂与深度场景的补充通道。从技能到实战调用链全景结合仓库上下文可以推断出一套可落地的完整实践路径安装技能用 skill-installer 的脚本把composio-skills/timely-automation装进$CODEX_HOME/skills/重启 Codex配置 MCP添加https://rube.app/mcp端点验证RUBE_SEARCH_TOOLS可响应建立 Timely 连接RUBE_MANAGE_CONNECTIONS指定toolkits: [timely]走完 OAuth 授权确认 ACTIVE发现工具以具体 use_case 调用RUBE_SEARCH_TOOLS收集 slug、schema、执行计划与坑位提示执行与复核RUBE_MULTI_EXECUTE_TOOL按 schema 构造参数执行检查响应分页 token工作流内复用 session ID。整个流程体现的工程思想与仓库其他技能一脉相承把易变的上游 schema与稳定的编排逻辑解耦——逻辑写在 SKILL.md 里长期有效schema 则每次运行时动态获取。这正是 README.md 所述Codex skills 是模块化指令包metadata 决定触发、正文按需加载保持上下文精简这一理念在真实应用自动化中的具体实践。需要为其他应用构建同类能力时可参照 template-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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考