awesome-codex-skills 中 Customgpt 自动化 Skill基于 Rube MCP 的 Customgpt 工作流实战指南【免费下载链接】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本文基于 customgpt-automation/SKILL.md 展开讲解如何在 Codex 中通过 Rube MCP 连接并自动化 Customgpt 平台的操作。读完本篇你将掌握该 Skill 的前置条件与安装方式、Rube MCP 接入配置、搜索工具—检查连接—执行工具的标准工作流以及调用RUBE_MULTI_EXECUTE_TOOL等 Rube 工具时的常见陷阱与排查要点。Customgpt 是一套企业级 AI 聊天助手构建平台典型操作包括创建/管理 ChatGPT 实例、配置数据源、管理用户访问等。直接为这些操作编写 API 集成代码成本高且易过期而customgpt-automation这个 Codex Skill 的思路是不硬编码任何 Customgpt API 细节而是让 Agent 通过 Composio 的 Rube MCP 网关动态发现并调用当前最新的 Customgpt 工具。该 Skill 属于仓库中composio-skills/目录下的一个自动化 Skill 样例该目录共收录了 800 多个按集成对象命名的同类 Skill命名规范为服务名-automation本 Skill 即对应 Customgpt 服务。Skill 的元数据与触发机制每个 Codex Skill 由一个含 YAML frontmatter 的SKILL.md构成Codex 依据 frontmatter 中的name和description判断何时触发该 Skill触发后才加载正文。customgpt-automation 的元数据如下见 SKILL.md 文件头--- name: customgpt-automation description: Automate Customgpt tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各有明确用途name: customgpt-automationSkill 的唯一标识也是安装到$CODEX_HOME/skills/后的目录名。description声明了本 Skill 的核心行为约束——Always search tools first for current schemas总是先搜索工具以获取当前 schema这与正文Known Pitfalls中的Always search first原则一脉相承。requires.mcp: [rube]声明该 Skill 依赖 Rube MCP 服务器。从源码结构看仓库中所有composio-skills/下的同类 Skill 都统一声明mcp: [rube]这是 Composio 自动化 Skill 家族的共同特征它们不直接对接各服务的 REST API而是统一经由 Rube MCP 端点路由。这一设计与仓库根 README.md 中Skills tell your agent how to work. An MCP Gateway gives it secure access to the tools it needs的描述一致Skill 提供领域工作流知识MCP 网关提供真实的工具访问能力。前置条件在执行任何 Customgpt 工作流之前文档列出了三条硬性前置条件Prerequisites 一节Rube MCP 已连接即RUBE_SEARCH_TOOLS工具在当前客户端中可用已通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为customgpt的活跃 Customgpt 连接每次执行前都必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema——因为工具 schema 会随服务演进而变化。安装 Skill 到 CodexSkill 需要放到 Codex 的技能目录才能被加载。仓库提供了两种方式见 README.md 的 Quickstart 章节方式一使用 Skill Installer推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # Install one or more skills into $CODEX_HOME/skills (defaults to ~/.codex/skills) python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions把--path参数换成composio-skills/customgpt-automation即可安装本 Skill。从 安装脚本实现 看脚本支持--url/--repo--path/--ref/--dest/--name等参数默认拉取master分支并将 Skill 落到$CODEX_HOME/skills/skill-nameCODEX_HOME未设置时默认~/.codex。方式二手动安装把composio-skills/customgpt-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 使其重新加载元数据之后在会话中自然描述任务如帮我用 Customgpt 的接口建一个知识库Codex 会根据 description 匹配并触发该 Skill。验证安装可用ls ~/.codex/skills查看目录、head ~/.codex/skills/customgpt-automation/SKILL.md检查 frontmatter。接入 Rube MCP文档给出的接入方式非常轻量Setup 一节Get Rube MCP: Addhttps://rube.app/mcpas an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.即在你的 MCP 客户端配置Codex 的 MCP 服务器配置、或其他支持 MCP 的客户端中添加远程端点https://rube.app/mcp无需在客户端侧配置任何 API key——认证统一由 Rube/Composio 侧的连接管理流程完成。接入后按以下 4 步完成初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能够响应调用RUBE_MANAGE_CONNECTIONS并指定 toolkitcustomgpt如果返回的连接状态不是 ACTIVE按响应中给出的 auth link 完成授权在运行任何工作流之前确认连接状态显示为 ACTIVE。工具发现Tool DiscoveryRube 的工具集合是动态的因此本 Skill 的第一条铁律是先搜索、再执行。标准的发现调用如下Tool Discovery 一节RUBE_SEARCH_TOOLS queries: [{use_case: Customgpt operations, known_fields: }] session: {generate_id: true}参数说明queries[].use_case用自然语言描述你要做的事这里是通用的 Customgpt operations实际工作流中应替换为更具体的任务描述见下文 Step 1queries[].known_fields已知的字段提示可为空字符串session: {generate_id: true}让 Rube 生成一个新的会话 ID。该 ID 是后续所有调用的工作流上下文句柄需要保存并复用。搜索结果会返回四类关键信息可用的工具 slug、每个工具的输入 schema、推荐的执行计划recommended execution plans以及已知陷阱known pitfalls。这些信息是后续执行的唯一可信输入——文档明确禁止在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。核心工作流三步模式文档将完整执行过程抽象为Discover → Check Connection → Execute三步模式三步共享同一个 session id。Step 1按具体任务发现可用工具把发现查询从泛化的 Customgpt 操作收窄为你的具体任务并复用已有会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Customgpt task}] session: {id: existing_session_id}注意此处 session 参数从{generate_id: true}变为{id: existing_session_id}——同一工作流内必须复用会话 ID只有开启全新工作流时才生成新的这是 Known Pitfalls 中 Session reuse 原则的体现。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [customgpt] session_id: your_session_id执行工具前必须确认customgpttoolkit 的连接为 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——字段名和类型都要精确匹配文档用/* schema-compliant args from search results */标注了这一点memory参数即使为空也必须显式传入{}缺省该字段是不被推荐的。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中放入多个工具调用因此一次调用可以串起多个 Customgpt 操作如先查实例列表、再批量更新配置减少多轮往返。常见陷阱Known Pitfalls文档Known Pitfalls一节对应行段总结的六条经验是这类动态工具发现模式中最容易踩的坑值得逐条对照排查Always search first总是先搜索工具 schema 会变化。未调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是此类 Skill 最常见的失败来源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 工具的映射可直接作为执行时的速查手册操作做法查找工具RUBE_SEARCH_TOOLS传入 Customgpt 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定customgpt执行工具RUBE_MULTI_EXECUTE_TOOL传入发现得到的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对返回中带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS其中后两行值得展开说明搜索结果中的工具若只给出schemaRef引用而非完整 schema需要用RUBE_GET_TOOL_SCHEMAS二次拉取完整定义后再构造arguments而需要批量或脚本化执行时RUBE_REMOTE_WORKBENCH提供了run_composio_tool()这一编程入口适合把多次工具调用组织成脚本而非逐个对话式触发。适用前提与边界本 Skill 依赖 Rube MCP 端点https://rube.app/mcp可用且 Customgpt 连接需要人工完成一次授权走 auth link之后由 Rube 侧管理凭据客户端不需要保存 Customgpt 的 API key具体可执行哪些 Customgpt 操作哪些 tool slug、参数结构以RUBE_SEARCH_TOOLS的实时返回为准本文与 Skill 文档均不固化具体工具清单——这正是该 Skill 的设计意图schema 会漂移动态发现优于静态清单该 Skill 是composio-skills/家族中针对 Customgpt 的一个实例。同一模式frontmatter 声明mcp: [rube]、先RUBE_SEARCH_TOOLS后执行、RUBE_MULTI_EXECUTE_TOOL落地同样适用于该目录下的其他集成例如 composio-automation/SKILL.md差异仅在 toolkit 名称与 use case 描述编写同类 Skill 时可参考仓库中的 skill-creator 获取 SKILL.md 结构、frontmatter 书写与progressive disclosure等最佳实践。【免费下载链接】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），仅供参考
