使用 Rube MCP 自动化 Better Proposalsawesome-codex-skills 实战指南【免费下载链接】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本指南以仓库中的 better-proposals-automation Skill 为核心讲解如何通过 Rube MCPComposio驱动 Better Proposals 的提案创建、发送与追踪类自动化任务。读完本文你将掌握从 MCP 接入、连接授权、工具发现到执行与批量操作的完整链路并理解为什么先搜索、再执行是这套体系不可违背的纪律。一、这个 Skill 解决什么问题Better Proposals 是面向销售团队的一站式提案制作与跟踪 SaaS用于快速生成、发送并追踪销售提案Proposal的打开、签署状态。本仓库中的 composio-skills/better-proposals-automation/SKILL.md 是一份标准的 Codex Skill 指令包它告诉 Codex如何借助 Composio 提供的 Better Proposals toolkit 来真实地操作 Better Proposals 服务而不是仅仅建议你手动去做。Skill 的 YAML frontmatter 定义了触发元数据name: better-proposals-automation description: Automate Better Proposals tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]按照 README.md 对 Codex Skill 机制的说明Codex 读取name与description元数据来判断何时触发该 Skill只有触发后才会加载正文从而保持上下文精简。因此当你的会话中出现与 Better Proposals 相关的任务意图时Codex 会自动加载这份指令。二、底层架构Rube MCP 与 Composio Toolkit整个自动化体系由三层组成Rube MCP一个统一的 MCPModel Context Protocol服务端点提供RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等标准工具作为 Agent 与各 SaaS 集成之间的网关。Composio Better Proposals toolkitComposio 平台封装好的工具集标识符为better_proposals内部包含针对 Better Proposals API 的具体工具tool slug。连接Connection在 Rube 侧建立并持有的 OAuth 授权连接状态为ACTIVE时工具才能实际调用。同仓库的 composio-automation Skill 与本文 Skill 共享同一套 Rube 工具协议RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL差异仅在于目标 toolkit 不同——这印证了该模式在仓库中是一套协议、多集成复用的通用架构。三、前置条件在运行任何 Better Proposals 工作流之前需确认三点Rube MCP 已连接且RUBE_SEARCH_TOOLS可用已通过RUBE_MANAGE_CONNECTIONS建立 Better Proposals 连接toolkit 为better_proposals始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema——这是本 Skill 反复强调的硬性纪律。四、Setup接入 Rube MCP 并建立连接1. 添加 MCP 服务端在客户端的 MCP 配置中添加端点https://rube.app/mcp即可。无需 API Key——只需添加端点即可工作。2. 建立 Better Proposals 连接按以下顺序完成授权闭环验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应调用RUBE_MANAGE_CONNECTIONStoolkit 传better_proposals若连接状态不是ACTIVE跟随返回的认证链接完成授权在运行任何工作流之前确认连接状态显示为ACTIVE。其中第 3 步是关键Rube 返回的 auth link 是一次性 OAuth 流程完成授权后连接状态才会从 pending 变为ACTIVE。结合仓库 connect/SKILL.md 中描述的 Composio CLI 流程composio link toolkit走 OAuth 一次、连接持久保留可以理解为 Rube 以 MCP 工具的形式复用了同样的连接生命周期。五、工具发现永远先执行 RUBE_SEARCH_TOOLS工具 schema 会随上游 API 演进而变化因此本 Skill 要求每次执行工作流前先做工具发现RUBE_SEARCH_TOOLS queries: [{use_case: Better Proposals operations, known_fields: }] session: {generate_id: true}返回内容包括可用的工具 slug 列表每个工具的输入 schema推荐的执行计划recommended execution plans已知陷阱known pitfalls。参数解读use_case描述你要做的具体任务如创建提案、发送提案、查询提案状态语义越精确返回的工具越聚焦known_fields如果你已知某些字段可在此预填以帮助排序未知时留空字符串sessiongenerate_id: true表示让服务端生成新的会话 ID在已有多步流程中则使用{id: existing_session_id}复用。六、三步核心工作流这是本 Skill 规定的标准执行模式发现工具 → 检查连接 → 执行工具。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Better Proposals task}] session: {id: existing_session_id}注意此处复用已有会话 ID保持同一工作流的会话连续性。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [better_proposals] session_id: your_session_id确认返回状态为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必须来自RUBE_SEARCH_TOOLS的返回结果禁止凭记忆硬编码arguments必须严格遵循搜索返回的 schema 字段名与类型例如提案内容、收件人邮箱等字段以 schema 为准memory参数必须始终携带即使为空也要传{}session_id与前面步骤保持一致。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中传入多个工具调用便于在同一次请求中编排创建提案 → 发送提案这类串联动作。七、批量操作与完整 Schema 获取当任务超出单次工具调用范围时本 Skill 提供两种进阶手段场景手段批量/脚本化操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()在远程环境中以代码方式驱动工具需要完整字段定义RUBE_GET_TOOL_SCHEMAS用于获取带schemaRef的工具的完整 schema其中RUBE_REMOTE_WORKBENCH适合需要对多个提案做循环处理、条件分支或数据汇总的场景RUBE_GET_TOOL_SCHEMAS则在RUBE_SEARCH_TOOLS返回结果包含schemaRef引用即详细定义需要另行拉取时使用能拿到比搜索摘要更完整的字段级定义。八、已知陷阱与最佳实践本 Skill 明确列出六条纪律逐条展开Always search first始终先搜索工具 schema 会变化。绝不在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。这是本 Skill 出现频率最高的告诫也是与 composio-automation Skill 完全一致的约定。Check connection检查连接执行工具前必须用RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE避免在未授权状态下空跑报错。Schema complianceschema 合规使用搜索结果中的精确字段名与类型Better Proposals 工具的入参结构以上游 schema 为准臆造字段会导致调用失败。Memory parametermemory 参数RUBE_MULTI_EXECUTE_TOOL调用中必须始终包含memory即使为空{}。它承载跨调用的上下文状态。Session reuse会话复用同一工作流内复用会话 ID新工作流生成新 ID以隔离状态并支持分页续取。Pagination分页检查响应中的分页 token存在后续页时持续拉取直至取完避免结果截断。九、速查表操作方式查找工具RUBE_SEARCH_TOOLSuse_case 指定 Better Proposals 相关任务建立连接RUBE_MANAGE_CONNECTIONStoolkit 传better_proposals执行工具RUBE_MULTI_EXECUTE_TOOL使用发现到的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具十、安装与触发方式本 Skill 位于仓库composio-skills/目录与其余数百个集成类 Skillcomposio-automation 等并列。安装方式遵循仓库 README.md 的统一约定将 Skill 目录复制到$CODEX_HOME/skills/默认~/.codex/skills/后重启 Codex也可使用 skill-installer 的install-skill-from-github.py脚本按仓库路径安装。安装后在会话中自然描述 Better Proposals 相关任务即可触发本 Skill。十一、适用前提与边界本文所述RUBE_*工具名、连接状态语义、参数结构均以 better-proposals-automation/SKILL.md 原文为准Better Proposals toolkit 内具体工具的 slug 与字段需以运行时RUBE_SEARCH_TOOLS返回的 schema 为准本文不臆造具体工具名该 Skill 面向 Codex CLI/API 场景依赖 Rube MCP 网关可用性自动化操作会真实作用于你的 Better Proposals 账号建议先在测试环境验证工作流。十二、总结better-proposals-automationSkill 展示了发现驱动的集成自动化范式Agent 不预置任何硬编码的工具定义而是通过RUBE_SEARCH_TOOLS在运行时获取 schema用RUBE_MANAGE_CONNECTIONS保障授权用RUBE_MULTI_EXECUTE_TOOL完成真实动作再用RUBE_REMOTE_WORKBENCH与RUBE_GET_TOOL_SCHEMAS覆盖批量与深度的需求。这套纪律不仅适用于 Better Proposals也复用于仓库内全部 Composio 集成类 Skill是一份可迁移的 MCP 自动化工程范式。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），仅供参考