
使用 Rube MCP 在 Codex 中自动化 Screenshotone 截图任务awesome-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本篇技术指南以仓库中的 composio-skills/screenshotone-automation/SKILL.md 为核心骨架系统讲解如何通过 Rube MCP 网关驱动 Composio 的 Screenshotone toolkit在 Codex CLI/API 会话中完成网页截图类任务的端到端自动化。读完你将掌握工具发现 → 连接检查 → 多工具执行的完整工作流理解 Rube 生态中RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等核心工具的正确调用姿势以及规避 Schema 过期、连接失效等高频陷阱的实战经验。一、技能定位这份 SKILL.md 解决什么问题Codex Skills 是一类模块化指令包每个技能以独立目录承载内含带name与descriptionfrontmatter 元数据的SKILL.mdCodex 依据元数据决定何时触发技能触发后才加载正文从而保持上下文精简见 README.md 中 What Are Codex Skills? 一节。本技能screenshotone-automation位于 composio-skills/screenshotone-automation/其 frontmatter 声明如下--- name: screenshotone-automation description: Automate Screenshotone tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从声明可以读出三层关键信息能力边界自动化 Screenshotone 相关操作——Screenshotone 是网页截图/页面渲染服务经 Composio 封装为 toolkit 后暴露为可调用工具依赖前提必须挂载名为rube的 MCP 服务器requires.mcp: [rube]铁律description末尾的 Always search tools first for current schemas 是贯穿全文的核心原则——工具的 Schema 随时可能变化绝不可硬编码工具 slug 与参数。该技能与仓库中大量composio-skills/*-automation技能如 composio-skills/composio-automation/SKILL.md共享同一套 Rube MCP 调用模式可以视为通过 Rube 网关调用 Composio toolkit这一通用范式的 Screenshotone 具体落地。二、运行前提Prerequisites在开始任何 Screenshotone 自动化之前必须满足以下三个前置条件对应 SKILL.md前提说明未满足时的现象Rube MCP 已连接环境中存在可用的RUBE_SEARCH_TOOLS工具无法发现工具、无法解析 SchemaScreenshotone 连接为 ACTIVE通过RUBE_MANAGE_CONNECTIONS以 toolkitscreenshotone建立并激活连接执行工具时鉴权失败先搜索再执行每次工作流开始前先调用RUBE_SEARCH_TOOLS获取最新工具 Schema工具 slug 或参数字段过期导致调用报错其中第三条是过程性前提它不是一个一次性配置而是每个工作流都必须执行的第一步。原因在于 Composio 侧的工具定义slug、入参字段、类型会随上游 API 演进而更新只有以搜索结果为唯一事实来源才能保证自动化脚本长期可用。三、初始化设置接入 Rube MCP 并激活 Screenshotone 连接3.1 获取 Rube MCPRube MCP 的接入方式极为轻量将https://rube.app/mcp作为 MCP 服务器地址添加到你的客户端Codex CLI 或其他支持 MCP 的客户端配置中即可无需申请任何 API Key——添加端点后即开箱可用见 SKILL.md 的 Setup 一节。3.2 四步建立连接接入端点后按以下顺序完成连接初始化验证可用性确认RUBE_SEARCH_TOOLS有响应证明 Rube MCP 通道已打通发起连接调用RUBE_MANAGE_CONNECTIONS参数中携带 toolkitscreenshotone完成授权若返回的连接状态不是 ACTIVE则跟随返回的认证链接auth link完成第三方授权流程确认状态在运行任何工作流之前务必确认连接状态已变为 ACTIVE。实践要点OAuth 授权是一次性的授权完成后连接会持久保存。后续会话中只需检查状态而非重复授权。四、工具发现让 Schema 始终新鲜先发现后执行是本技能的第一原则。执行任何工作流前必须先调用RUBE_SEARCH_TOOLS获取当前可用的工具列表SKILL.mdRUBE_SEARCH_TOOLS queries: [{use_case: Screenshotone operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息可用工具 slugtool slugs后续RUBE_MULTI_EXECUTE_TOOL中的tool_slug字段取值来源输入 Schema每个工具的参数名、类型、必填项是构造arguments的唯一依据推荐执行计划recommended execution plansRube 针对该 use case 给出的多步编排建议已知陷阱known pitfalls该工具链历史上容易踩坑的地方。注意这里使用了session: {generate_id: true}——这是新工作流的标准用法由 Rube 自动生成一个新的会话 ID 作为本次工作流的上下文容器。若已处于某个进行中的工作流则应改用session: {id: existing_session_id}复用既有会话。五、核心工作流搜索 → 检查连接 → 执行本技能的核心工作流由三个固定步骤组成SKILL.md每一步都有明确的工具与参数约定。5.1 Step 1发现可用工具将第一步中Screenshotone operations的宽泛 use case 替换为你的具体任务描述并在已有会话中执行RUBE_SEARCH_TOOLS queries: [{use_case: your specific Screenshotone task}] session: {id: existing_session_id}例如若任务是截取某 URL 的桌面端网页截图use_case 就应描述为与之匹配的自然语言任务。搜索越具体返回的工具 slug 与推荐执行计划越精准。5.2 Step 2检查连接状态在执行工具之前用会话 ID 显式确认 Screenshotone 连接仍然有效RUBE_MANAGE_CONNECTIONS toolkits: [screenshotone] session_id: your_session_id此步返回连接状态。只有当结果显示 ACTIVE 时才能进入下一步——避免因连接过期而在执行阶段才暴露鉴权错误。5.3 Step 3执行工具确认连接 ACTIVE 后调用RUBE_MULTI_EXECUTE_TOOL执行具体操作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的字段名与类型必须严格遵循搜索结果中的 Schemaschema-compliantmemory参数必须始终携带即使没有需要跨调用保留的状态也要传空对象{}session_id与 Step 1/2 保持一致确保同一工作流内的状态连贯。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中一次传入多个工具调用适合把截图 → 处理 → 上传这类多动作编排在一次请求内完成。六、常见陷阱与规避Known PitfallsSKILL.md 总结了六条高频陷阱逐条拆解如下1. 必须先搜索Always search first工具 Schema 会变化。任何未经过RUBE_SEARCH_TOOLS校验就硬编码的 slug 或参数都有可能在 API 演进后失效。这是本技能最核心的一条纪律。2. 执行前检查连接Check connection用RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE 再执行。连接可能因 token 过期、用户撤销授权等原因失效前置检查能避免在长工作流中段才发现问题。3. 严格遵循 SchemaSchema compliance参数必须使用搜索结果中的精确字段名与类型。多传、漏传、类型不符都会导致调用失败——不要凭直觉猜测字段。4. memory 参数不可省略Memory parameterRUBE_MULTI_EXECUTE_TOOL的调用中必须包含memory字段即使为空也要传{}。省略该字段可能导致调用不符合工具契约。5. 会话复用策略Session reuse同一工作流内复用同一个session_id保证上下文与状态连续开启全新工作流时再生成新的会话 ID。混用会导致状态串扰。6. 注意分页Pagination检查响应中的分页 tokenpagination tokens。当结果集较大时必须持续翻页直至取完否则会遗漏后续数据。这个陷阱在批量处理截图结果、拉取任务列表等场景尤其常见。七、速查表一次记住五类操作SKILL.md 提供了操作级速查表是日常使用时最高效的索引操作方式查找工具Find toolsRUBE_SEARCH_TOOLS传入 Screenshotone 相关的具体 use case建立连接ConnectRUBE_MANAGE_CONNECTIONStoolkit 指定为screenshotone执行操作ExecuteRUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作Bulk opsRUBE_REMOTE_WORKBENCH配合run_composio_tool()函数获取完整 SchemaFull schemaRUBE_GET_TOOL_SCHEMAS适用于搜索结果中带schemaRef的工具值得注意最后两行当单个工具的 Schema 较大、搜索结果只返回了schemaRef引用时需要用RUBE_GET_TOOL_SCHEMAS拉取完整定义而当需要对 Screenshotone 做批量、循环类操作时RUBE_REMOTE_WORKBENCH远程工作台支持执行run_composio_tool()这类编程式调用比逐个RUBE_MULTI_EXECUTE_TOOL更高效。八、与 Composio 生态的呼应一套模式千种集成将本技能放回仓库全景观察可以看到它并非孤立存在composio-skills/目录下成百上千个*-automation技能如 composio-skills/composio-automation/SKILL.md共享完全相同的 Rube MCP 骨架——同样的requires.mcp: [rube]声明、同样的四步连接流程、同样的三步工作流与六条陷阱清单唯一差异只是 toolkit 名称与 use case 描述。从源码结构可以推断这套搜索 → 检查连接 → 执行的编排方式是 Rube MCP 面向 Composio 全部集成1000 应用的统一契约Screenshotone 只是其中一例。这一模式也解释了为何技能描述反复强调先搜索因为有了统一的工具发现机制任何 toolkit 的工具变更都不需要技能作者逐一手动维护而是由运行时 Schema 动态兜底。与之互补的是 connect/SKILL.md 中介绍的 Composio CLI 路线composio search/composio execute/composio link。两条路线能力同源——都建立在 Composio 的工具封装之上区别在于接入形态Rube MCP 面向已接入 MCP 的 Agent 会话提供标准 MCP 工具调用而 Composio CLI 面向终端直接操作。二者可根据你的运行环境取舍。九、将本技能安装进 Codex技能安装遵循仓库 README.md 的通用流程本仓库只读以下仅为安装说明手动安装将composio-skills/screenshotone-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex使新的 frontmatter 元数据被加载触发使用在会话中自然描述截图自动化任务Codex 会根据description自动匹配并触发本技能也可显式提及技能名。安装完成后技能目录下的SKILL.md即成为 Codex 在该任务中的行为指导书前文所述的工作流与陷阱清单会自动约束 Agent 的每一步调用。结语Screenshotone 自动化只是 Rube MCP × Composio 集成范式的一个切片。吃透这份技能你就掌握了在 Codex 中驱动任何 Composio toolkit 的通用方法论永远先搜索 Schema永远先确认连接永远携带 memory 与正确的 session。把这三条纪律内化为习惯你就能在 Codex 中稳定、可复用、可维护地自动化网页截图乃至任何第三方 SaaS 操作。【免费下载链接】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),仅供参考