通过 Rube MCP 与 Composio 实现 AgentQL 自动化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在 awesome-codex-skills 仓库中agentql-automation 技能 为 Codex 提供了一条基于Rube MCP Composio AgentQL toolkit的 AgentQL 操作自动化路径。本文以该技能文档为骨架结合仓库内其他自动化技能与安装机制完整讲解前置条件、Rube MCP 接入、工具发现、三步核心工作流、已知坑点与快速参考表帮助你在 Codex 会话中直接驱动 AgentQL 相关工具完成真实操作。技能定位一份面向 Agent 的自动化执行指南composio-skills/agentql-automation/SKILL.md的 YAML frontmatter 定义了技能的触发元数据--- name: agentql-automation description: Automate Agentql tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各司其职name是技能唯一标识description是 Codex 判断何时触发该技能的依据明确写出了通过 Rube MCP 自动化 AgentQL 任务以及最重要的行为约束始终先搜索工具获取当前 schemarequires.mcp声明了运行前提——必须在客户端配置中接入名为rube的 MCP 服务器。这与仓库 README.md 中描述的技能机制一致Codex 仅通过 frontmatter 的元数据决定是否触发技能正文在触发后才加载从而保持上下文精简。技能正文的标题Agentql Automation via Rube MCP点明了技术路径AgentQL 操作经由 Composio 的 AgentQL toolkit再由 Rube MCP 桥接给 Codex 调用。它属于 composio-skills 这一系列通过 Rube MCP 驱动某个业务系统的技能家族中的一员因此其先搜索、再连接、后执行的调用纪律具有普遍参考价值。前置条件在运行任何 AgentQL 工作流之前需要满足以下三项条件Rube MCP 必须已连接客户端环境中可用的RUBE_SEARCH_TOOLS工具是 Rube MCP 接入成功的标志AgentQL 连接必须处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立且 toolkit 名称为agentql任何执行前必须调用RUBE_SEARCH_TOOLS工具 schema 是动态变化的硬编码工具 slug 或参数是典型的失败来源。接入 Rube MCPSetupRube MCP 的接入成本极低在客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点即可无需任何 API Key。添加后按以下步骤完成初始化验证 Rube MCP 可用——确认RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONS并指定 toolkit 为agentql若返回的连接状态不是 ACTIVE则跟随返回的认证链接完成授权设置在运行任何工作流之前确认连接状态显示为ACTIVE。这套端点即服务、连接即授权的模式与仓库中 connect 技能 介绍的 Composio CLI 链路composio link toolkit一次 OAuth、连接持久化思路同源认证状态由平台侧维护Agent 侧只需要确认连接可用。工具发现执行任何操作前必须先搜索技能强调一个核心纪律永远先做工具发现。AgentQL toolkit 的可用工具、输入 schema、推荐执行计划与已知坑点都在变化因此首次接触该 toolkit 时应执行RUBE_SEARCH_TOOLS queries: [{use_case: Agentql operations, known_fields: }] session: {generate_id: true}该调用会返回可用工具的slug后续RUBE_MULTI_EXECUTE_TOOL的寻址依据每个工具的输入 schema字段名与类型必须严格遵循推荐的执行计划已知的坑点规避常见调用错误。注意首次调用时使用generate_id: true生成新会话 IDknown_fields留空表示让 Rube 基于use_case自行推荐工具集合。核心工作流模式三步走技能给出了稳定可复用的三步执行模式任何 AgentQL 任务都应遵循Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Agentql task}] session: {id: existing_session_id}将use_case替换为你具体的 AgentQL 任务描述例如网页数据提取、页面元素定位等并复用已存在的会话 IDsession.id确保工作流内状态连续。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [agentql] 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_id执行的关键约束tool_slug必须是 Step 1 搜索结果返回的真实 slug不可凭记忆硬编码arguments必须与搜索结果中的 schema 完全一致字段名、类型逐一对照memory参数必须始终携带即使为空也要传{}session_id沿用工作流会话。从 composio-automation 技能 可以看到完全一致的三步模式说明这是该系列技能的统一约定可在不同业务 toolkit 之间平移复用。已知坑点与规避策略技能文档总结了六条实战中反复出现的坑点是稳定运行 AgentQL 自动化工作流的关键永远先搜索工具 schema 会变化不先调用RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数是最大的失败源检查连接执行工具前务必通过RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE遵循 schemaarguments 必须使用搜索结果中的精确字段名与类型始终携带 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中即使memory为空也要传{}这是 API 的硬性要求会话复用同一工作流内复用会话 ID只有开启全新工作流时才生成新的会话 ID分页处理检查响应中是否携带分页 token如有则持续拉取直到数据取完。快速参考表操作方式查找工具RUBE_SEARCH_TOOLS携带 AgentQL 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定为agentql执行操作RUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具这张表覆盖了从找工具到批量执行的完整链路日常单次调用走前三行大规模批处理切换到RUBE_REMOTE_WORKBENCH需要完整字段定义时用RUBE_GET_TOOL_SCHEMAS深挖。在 Codex 中启用本技能本技能是一份标准的 Codex skill 目录composio-skills/agentql-automation/下仅含SKILL.md无额外脚本与资源符合 skill-creator 技能 提倡的正文精简、按需加载原则。启用方式与仓库其他技能一致详见 README.md 的 Quickstart推荐方式使用 skill-installer 中的安装脚本将技能安装到$CODEX_HOME/skills默认~/.codex/skills手动方式将composio-skills/agentql-automation/目录复制到$CODEX_HOME/skills/下重启 Codex 使其加载 frontmatter 元数据验证方式ls ~/.codex/skills确认目录存在head ~/.codex/skills/agentql-automation/SKILL.md检查元数据。安装后在会话中自然描述 AgentQL 自动化任务Codex 会依据description自动触发该技能触发后技能正文Rube MCP 三步工作流才会进入上下文。小结agentql-automation 技能 的实战价值在于其明确的操作纪律先搜索 schema、再确认连接、最后严格按 schema 执行。通过 Rube MCP 单端点接入、零 API Key 配置配合 Composio 的 AgentQL toolkitCodex 得以把网页数据提取与浏览器自动化类任务从生成建议升级为直接执行。这一模式对仓库内其他数百个*-automation技能如 ably、composio同样适用——掌握本文的三步工作流即可举一反三地驱动任意已接入 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），仅供参考