用 Rube MCP 在 Codex 中自动化 Griptape 任务awesome-codex-skills griptape-automation 实战指南【免费下载链接】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在 Codex 工作流中Griptape 提供了一套面向 AI Agent 编排的框架能力而本仓库的griptape-automationSkill 则给出了通过 Rube MCPComposio 提供的 MCP 网关驱动 Griptape 的标准操作范式先发现工具、再校验连接、最后执行调用。读完本文你将掌握在 Codex 中配置 Rube MCP、激活 Griptape 连接、用RUBE_SEARCH_TOOLS动态发现工具 Schema并按照发现 → 连接 → 执行三步模式稳定运行 Griptape 自动化任务的全部要点。1. Skill 概览它是什么、解决什么问题griptape-automation是 awesome-codex-skills 仓库中composio-skills/系列 Skill 的一个成员其定义位于 composio-skills/griptape-automation/SKILL.md。该 Skill 的 frontmatter 明确声明了触发条件--- name: griptape-automation description: Automate Griptape tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段元数据传达了两个关键信息requires.mcp: [rube]使用本 Skill 的前提是 Codex 环境中必须已接入名为rube的 MCP 服务器description中的 Always search tools first这是整套自动化范式的核心纪律——工具的 Schema参数结构、字段名会随版本变化任何执行之前都必须先通过RUBE_SEARCH_TOOLS拉取当前最新的工具定义绝不硬编码工具 slug 或参数。从仓库结构看composio-skills/目录下存在数百个同构的*-automationSkill如composio-automation、composio-search-automation它们共享同一套 Rube MCP 工作流模板区别仅在于toolkit名称与查询的use_case不同。本 Skill 专门针对Griptape toolkit即通过 Composio 封装的 Griptape 集成。2. 前置条件接入前先确认三件事在开始任何 Griptape 自动化之前文档要求逐项确认以下前置条件Rube MCP 已连接环境中必须存在RUBE_SEARCH_TOOLS工具它是判断 Rube MCP 是否可用的标志Griptape 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立并激活 toolkit 为griptape的连接执行前必须先搜工具任何工作流的第一步都必须是调用RUBE_SEARCH_TOOLS获取当前工具 Schema。3. Setup三步完成 Rube MCP 配置Rube MCP 的接入方式非常轻量——无需任何 API Key只需要在 MCP 客户端配置中添加一个端点地址https://rube.app/mcp即可。接入后的初始化流程共四步验证连通性确认RUBE_SEARCH_TOOLS有响应证明 Rube MCP 已正常加载建立连接调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为griptape完成授权若连接状态不是ACTIVE跟随返回的授权链接完成第三方账号Griptape 侧的认证设置状态确认在运行任何工作流之前确认连接状态已变为ACTIVE。这一步与仓库中 connect/SKILL.md 描述的 Composio CLI 连接思路一致composio link toolkit完成一次 OAuth 后连接持久化只是 Rube MCP 把连接管理收敛到了 MCP 工具调用层面更适合纯 Agent 场景。4. 工具发现先拿 Schema 再动手文档反复强调Always discover available tools before executing workflows这是整个 Skill 的第一原则。初次使用时的标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Griptape operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息供后续执行决策可用的工具 slugtool slugs每个工具的输入 Schemainput schemas推荐的执行计划recommended execution plans已知的坑known pitfalls。注意初次调用时使用了session: {generate_id: true}——由 Rube 生成一个新的会话 ID 供本次工作流使用而后续步骤中则改为复用session: {id: existing_session_id}。5. 核心工作流模式发现 → 连接 → 执行文档给出了适用于绝大多数 Griptape 自动化任务的三步标准流程。以下代码块均来自原 Skill 文档可完整复制到 Codex 会话中运行。Step 1发现可用工具用你的具体任务描述替换use_case并复用已存在的会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Griptape task}] session: {id: existing_session_id}Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [griptape] session_id: your_session_id确认返回的状态为ACTIVE后再进入执行阶段若为其他状态先回到第 3 节完成授权。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 中的字段名与类型schema-compliantmemory必须始终携带即使为空也要传{}session_id保持与 Step 1/2 相同的会话 ID确保整个工作流上下文连贯。6. 已知陷阱与最佳实践六条军规文档整理了六个在实战中反复踩到的坑值得逐条对照陷阱应对策略工具 Schema 会变化永远先调用RUBE_SEARCH_TOOLS不硬编码 slug 或参数连接可能失效执行前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态参数不匹配严格使用搜索结果中的精确字段名与类型遗漏 memory 参数每次RUBE_MULTI_EXECUTE_TOOL调用都必须携带memory可为{}会话上下文混乱同一工作流内复用 session ID新工作流生成新 ID响应分页遗漏检查响应中的分页令牌持续拉取直到数据完整其中分页一项值得特别留意大批量 Griptape 操作如列出、批量创建类任务的响应可能跨多页Agent 必须读取分页令牌并继续请求否则会拿到不完整的结果就草率收尾。7. 快速参考表五个操作的统一入口文档末尾给出了一个高度凝练的操作对照表可视为日常使用的最小速查卡操作采用方式查找工具RUBE_SEARCH_TOOLS附带 Griptape 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 设为griptape执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH通过run_composio_tool()函数获取完整 SchemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具可以看到Rube MCP 提供了五类核心工具覆盖从发现、连接、执行、批处理到深度 Schema 查询的完整链路。批量操作与深度 Schema 查询属于进阶能力前者适合一次性编排多个调用在远端工作台环境中以run_composio_tool()方式运行后者适合RUBE_SEARCH_TOOLS返回的 Schema 被schemaRef引用、需要单独展开完整定义的工具。8. 在 Codex 中安装与触发本 Skill本 Skill 的安装方式与仓库其他 Skill 完全一致。根据 README.md 的 Quickstart 说明推荐使用官方安装脚本git clone https://github.com/ComposioHQ/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/griptape-automation也可手动安装将 composio-skills/griptape-automation 目录复制到$CODEX_HOME/skills/默认~/.codex/skills/然后重启 Codex 使其加载元数据。安装后在会话中自然描述任务例如自动化 Griptape 任务Codex 会根据SKILL.mdfrontmatter 中的description自动触发本 Skill。9. 写在最后一条可复用的自动化范式griptape-automation的价值不止于 Griptape 本身——它在仓库中代表了一套可复制的通过 Rube MCP 自动化第三方 toolkit的通用方法论任何 toolkitGriptape、Composio、Composio Search 等都遵循先用RUBE_SEARCH_TOOLS发现 → 用RUBE_MANAGE_CONNECTIONS校验连接 → 用RUBE_MULTI_EXECUTE_TOOL执行的三步闭环。掌握这套模式后当你需要自动化其他通过 Composio 封装的工具时只需替换toolkit名称与use_case描述其余纪律不硬编码 Schema、复用会话、携带memory、处理分页完全通用。对于希望深入源码验证的读者可对照阅读 composio-skills/griptape-automation/SKILL.md 原文以及同目录下 composio-skills/composio-automation/SKILL.md 等兄弟 Skill观察它们如何在保持同一框架的前提下针对各自 toolkit 做参数化定制从而举一反三写出属于自己的自动化 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），仅供参考