通过 Rube MCP 与 Composio 实现 AgentQL 自动化：awesome-codex-skills 实战指南-育师

通过 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 任务"以及最重要的行为约束"始终先搜索工具获取当前 schema"；requires.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 MCP（Setup）

Rube 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生成新会话 ID；known_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 任务描述（例如网页数据提取、页面元素定位等），并复用已存在的会话 ID（session.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；
遵循 schema：arguments 必须使用搜索结果中的精确字段名与类型；
始终携带 memory 参数：RUBE_MULTI_EXECUTE_TOOL调用中即使memory为空也要传{}，这是 API 的硬性要求；
会话复用：同一工作流内复用会话 ID；只有开启全新工作流时才生成新的会话 ID；
分页处理：检查响应中是否携带分页 token，如有则持续拉取直到数据取完。

快速参考表

操作	方式
查找工具	`RUBE_SEARCH_TOOLS`，携带 AgentQL 相关的 use case
建立连接	`RUBE_MANAGE_CONNECTIONS`，toolkit 指定为`agentql`
执行操作	`RUBE_MULTI_EXECUTE_TOOL`，使用搜索发现的 tool slug
批量操作	`RUBE_REMOTE_WORKBENCH`，配合`run_composio_tool()`
获取完整 schema	`RUBE_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 toolkit，Codex 得以把"网页数据提取与浏览器自动化"类任务从"生成建议"升级为"直接执行"。这一模式对仓库内其他数百个*-automation技能（如 ably、composio）同样适用——掌握本文的三步工作流，即可举一反三地驱动任意已接入 Composio 的业务系统。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考