ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

使用 awesome-codex-skills 的 Workiom 自动化技能:通过 Rube MCP 编排 Workiom 业务操作

使用 awesome-codex-skills 的 Workiom 自动化技能:通过 Rube MCP 编排 Workiom 业务操作 使用 awesome-codex-skills 的 Workiom 自动化技能通过 Rube MCP 编排 Workiom 业务操作【免费下载链接】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本篇技术指南聚焦 awesome-codex-skills 仓库中的composio-skills/workiom-automation技能讲解如何借助 Rube MCPComposio 提供连接 Workiom 账号以标准的“先发现、再连接、后执行”三步模式让 Codex 自动化完成 Workiom 中的业务操作。读完本文你将掌握 Rube MCP 的安装与连接方法、RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL等关键工具的正确调用方式以及规避 schema 变更、连接失效等常见坑位的实战策略。技能背景什么是 workiom-automationworkiom-automation是 awesome-codex-skills 仓库composio-skills/目录下的一个 Codex 技能Skill。它本身不是一段可执行代码而是一份经过结构化设计的指令包告诉 Codex 如何通过 Composio 的 Workiom 工具集toolkit去调用 Workiom 的开放能力。技能核心定义位于 SKILL.md其 frontmatter 声明如下--- name: workiom-automation description: Automate Workiom tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段元数据是 Codex 触发技能的依据name是技能标识description描述技能适用场景Codex 会在对话中依据它判断何时加载本技能requires.mcp声明运行本技能必须接入名为rube的 MCP 服务器。这与仓库 README.md 对 Codex Skills 的总体描述一致——技能是模块化的指令包元数据决定触发时机正文在触发后才加载从而保持上下文精简。前置条件在开始任何 Workiom 自动化工作流之前需要确认以下三个条件全部满足Rube MCP 必须已连接Codex 会话中应能看到RUBE_SEARCH_TOOLS等工具可用Workiom 连接必须处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立并激活对 toolkitworkiom的连接必须先用RUBE_SEARCH_TOOLS获取当前工具 schema这是本技能反复强调的第一原则。环境设置接入 Rube MCP 并建立 Workiom 连接获取 Rube MCP在客户端配置中将https://rube.app/mcp添加为 MCP 服务器即可无需任何 API Key——只需要添加该端点即可工作。建立连接的四步流程验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为workiom若连接状态不是 ACTIVE则跟随返回的授权链接完成 Workiom 账号授权在运行任何工作流之前再次确认连接状态显示为 ACTIVE。连接状态检查是后续所有执行步骤的前提跳过它会直接导致工具调用失败或返回鉴权错误。工具发现一切执行的起点Rube 的工具 schema 会随服务端更新而变化因此永远不要硬编码工具 slug 或参数结构。每次执行前都应先调用RUBE_SEARCH_TOOLS获取当前 schemaRUBE_SEARCH_TOOLS queries: [{use_case: Workiom operations, known_fields: }] session: {generate_id: true}该调用会返回可用的工具 slugtool slugs各工具的输入 schemainput schemas推荐的执行计划recommended execution plans已知的坑位提示known pitfalls。这些返回内容就是后续构造RUBE_MULTI_EXECUTE_TOOL请求参数的唯一权威依据。核心工作流模式发现 → 连接 → 执行Step 1发现可用工具针对具体任务使用更精确的 use_case 查询并复用已有会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Workiom task}] session: {id: existing_session_id}Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [workiom] session_id: your_session_id确认返回的连接状态为 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_idtool_slug与arguments必须严格来自 Step 1 搜索结果的 schema字段名和类型不能凭记忆编写。memory参数即使为空也要显式传入{}。已知陷阱与规避策略原文档总结了六条实战中容易踩的坑逐一说明如下Always search first先搜索再执行工具 schema 会变化。在不调用RUBE_SEARCH_TOOLS的情况下绝不硬编码工具 slug 或参数Check connection执行前检查连接执行工具前必须确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 状态Schema compliance严格遵循 schema使用搜索结果中给出的精确字段名与字段类型Memory parametermemory 参数必带所有RUBE_MULTI_EXECUTE_TOOL调用都必须包含memory参数即使内容为空也要传{}Session reuse会话复用同一工作流内复用同一个 session ID开启新工作流时再生成新的 session IDPagination注意分页检查响应中的分页 tokenpagination tokens持续拉取直到数据完整避免只拿到第一页结果。快速参考五类操作的对应工具OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Workiom-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitworkiomExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef其中批量操作Bulk ops建议切换到RUBE_REMOTE_WORKBENCH通过其中的run_composio_tool()函数在远程工作台中编排多次调用若搜索结果中某个工具带有schemaRef引用则需要用RUBE_GET_TOOL_SCHEMAS获取其完整 schema 后再构造参数。安装到 Codex让技能可用按仓库 README.md 的安装说明可以把本技能装入本地 Codex 环境。推荐使用仓库自带的 Skill Installergit 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/workiom-automation安装器会把技能放到$CODEX_HOME/skills/skill-name默认~/.codex/skills重启 Codex 后即可加载。也可以手动安装将 composio-skills/workiom-automation/ 整个目录复制到$CODEX_HOME/skills/重启 Codex然后在会话中描述任务即可触发该技能。总结workiom-automation技能的核心理念可以概括为一句话schema 是易变的连接是需要验证的执行必须建立在两者之上。通过“RUBE_SEARCH_TOOLS发现 →RUBE_MANAGE_CONNECTIONS验证 →RUBE_MULTI_EXECUTE_TOOL执行”的标准流程配合会话复用、显式memory、分页拉取等细节约束你可以稳定、可复现地在 Codex 中自动化 Workiom 业务操作并将同一套模式复用到仓库中其他*-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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表