bugbug-automation

bugbug-automation skill 概览

bugbug-automation 能做什么

bugbug-automation skill 可帮助 AI agent 通过 Composio 的 Rube MCP 集成来自动化处理 Bugbug 测试自动化任务。它适用于这样一类工作流：agent 需要先发现当前的 Bugbug 工具 schema，确认用户的 Bugbug 连接状态，然后再使用可用的 Rube MCP tools 执行动作，而不是凭空猜测 API 名称或参数。

它不是独立的 Bugbug SDK 封装。这个 skill 是一份工作流指南，用于指导 agent 使用通过 Rube MCP 暴露的 bugbug toolkit。

最适合的用户和任务

如果你希望 Claude 或其他支持 MCP 的 agent 协助处理 Bugbug 操作，例如管理自动化测试工作流、查看当前可用的 Bugbug actions，或基于 Composio 当前暴露的 tools 制定执行计划，可以使用 bugbug-automation skill。

它尤其适合已经在使用 Bugbug，并希望借助 agent 控制流程、同时不想每次都手动检查 toolkit schema 的 QA 工程师、测试自动化负责人和开发者。

核心差异：schema-first 执行

bugbug-automation 的关键价值在于，它要求在执行任何 Bugbug action 之前必须先调用 RUBE_SEARCH_TOOLS。这很重要，因为 MCP tool schemas 可能会变化，而 Bugbug 操作也可能需要特定参数。普通 prompt 可能会让 agent 编造 tool 名称；这个 skill 会要求 agent 先发现可用 tools，再根据返回的 schema 执行。

采用前需要考虑什么

你需要一个能够连接 Rube MCP 的 MCP client，并且需要一个可通过 RUBE_MANAGE_CONNECTIONS 激活的 Bugbug 账号连接。该仓库只包含一个 SKILL.md，没有辅助脚本或扩展示例。应把它视为一份简明操作流程，而不是完整的测试自动化框架。

如何使用 bugbug-automation skill

bugbug-automation 安装上下文

从 Composio skills repository 安装该 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill bugbug-automation

然后在你的 client 中使用以下地址配置 Rube MCP：

https://rube.app/mcp

该 skill 需要 rube MCP server，并依赖以下 tools 可用：

• RUBE_SEARCH_TOOLS
• RUBE_MANAGE_CONNECTIONS
• 通过 discovery 返回的 Bugbug toolkit tools

在要求 agent 运行 Bugbug 工作流之前，请先确认 RUBE_SEARCH_TOOLS 能正常响应。

使用前的必要设置

正确的 bugbug-automation usage 流程应从连接校验开始：

1. 要求 agent 针对你的具体 Bugbug 使用场景调用 RUBE_SEARCH_TOOLS。
2. 要求它使用 toolkit bugbug 调用 RUBE_MANAGE_CONNECTIONS。
3. 如果连接状态不是 ACTIVE，完成返回的授权流程。
4. 只有在 Bugbug 连接激活后，agent 才应调用 discovery 发现的 Bugbug tools。

这个顺序可以避免两类常见失败：使用过期 schema，以及在 Bugbug 账号尚未连接时就尝试执行操作。

能更好触发该 skill 的高质量 prompt

较弱的 prompt 是：“Use Bugbug to run my tests.”

更好的 prompt 是：

Use the bugbug-automation skill. First call RUBE_SEARCH_TOOLS for Bugbug test execution and inspect the returned schemas. Then check the bugbug connection with RUBE_MANAGE_CONNECTIONS. If active, propose the exact tool call plan before executing. I want to run the regression suite for the checkout flow and summarize failures with links or IDs returned by Bugbug.

这个写法效果更好，因为它同时说明了任务、必需的 discovery 步骤、授权检查、目标测试范围，以及期望的输出格式。

优先阅读的文件

从这里开始：

• composio-skills/bugbug-automation/SKILL.md

这个 skill 文件夹中没有单独的 README.md、rules/、references/ 或脚本。最重要的仓库指引都在 SKILL.md 中：前置条件、设置方式、tool discovery，以及核心工作流模式。

bugbug-automation skill 常见问题

bugbug-automation 适合 Test Automation 新手吗？

它可以帮助新手通过 agent 操作，但不会从零讲解 Bugbug。你应该知道自己想影响哪个 Bugbug project、suite、test 或 workflow。这个 skill 通过强制 schema discovery 来提升执行可靠性；它不能替代基础的 QA 规划。

它比普通 prompt 好在哪里？

普通 prompt 可能只是让 agent “use Bugbug”，但 agent 并不知道当前 MCP session 中实际有哪些 tools。bugbug-automation skill 增加了一种更安全的模式：先发现 tools，确认连接，再基于返回的 schemas 执行。这样可以减少虚构参数和调用失败。

什么时候不应该使用这个 skill？

如果你无法使用 Rube MCP、不能授权 Bugbug 连接，或需要在没有实时 Bugbug 访问权限的情况下离线生成测试，就不要使用它。对于不涉及任何 Bugbug 操作的宽泛 QA 策略文档，也不需要使用它；普通规划型 prompt 就足够了。

它是否依赖 Composio 或 Rube MCP？

是的。该 skill 明确围绕 Composio 通过 Rube MCP 提供的 Bugbug toolkit 构建。上游指引会将用户引导到 composio.dev/toolkits/bugbug 上的 Bugbug toolkit 文档，但实际执行依赖你的 client 中可用的 Rube MCP tools。

如何改进 bugbug-automation skill

用更好的输入提升 bugbug-automation 结果

向 agent 提供具体的 Bugbug 意图：project 名称、suite 或 test 目标、environment、你希望执行还是检查，以及你需要什么输出。例如：

Find the available Bugbug tools, verify my connection, then identify whether there is a tool for listing test runs. If available, retrieve recent checkout-flow runs and summarize failed cases by status, test name, and run URL.

明确的目标能让 agent 搜索正确的 tool schema，而不是使用笼统的 “Bugbug operations” 查询。

避免常见失败模式

最主要的失败模式是跳过 RUBE_SEARCH_TOOLS。如果 agent 试图直接调用某个 Bugbug tool，应立即停止它，并要求它重新发现 schema。另一个常见失败是在 bugbug 连接尚未处于 ACTIVE 状态时继续执行；每次新 session 开始时都应要求进行连接检查。

还应避免在没有确认步骤的情况下要求执行破坏性或大规模变更。对于会修改 tests、suites 或 configurations 的操作，应让 agent 在执行前先提出准确的、已发现的 tool calls。

在第一次 tool 响应后继续迭代

拿到第一次 Bugbug 响应后，应根据实际返回字段继续细化。如果 tool 返回了 run IDs 但没有返回 URLs，就要求 agent 搜索可获取 run details 的后续 tool。如果 schema 要求 filters，则提供 date ranges、project IDs、suite names 或 status values。

推荐的迭代模式：

1. Discover schema.
2. Execute the smallest safe read action.
3. Inspect returned identifiers and fields.
4. Run targeted follow-up actions.
5. Summarize results with evidence from the tool output.

如果扩展该 skill，可以添加什么

当前的 bugbug-automation guide 有意保持精简。若要在本地改进它，可以为团队常见的 Bugbug 工作流添加示例，例如列出 test runs、检查 failed cases，或触发某个已知 suite。请保持 schema-first 规则不变，并记录哪些 prompts 在执行前需要审批。