SuperAPI AI 工具集

report-bug

部署与运维

查看项目

更新于 10-16 05:26

技能介绍

用途

report-bug 用于报告在使用 compound-engineering 插件时遇到的缺陷。该命令会收集结构化的缺陷信息,并为维护者创建一个 GitHub Issue。

主要能力

命令通过 AskUserQuestion 工具向用户收集以下信息:

  • 缺陷类别:agent 不工作、command 不工作、skill 不工作、MCP server 问题、安装问题、其他。
  • 具体受影响的组件:agent、command、skill 或 MCP server 的名称。
  • 实际行为:使用该组件时发生了什么。
  • 预期行为:本应发生什么。
  • 复现步骤:出现缺陷前执行了哪些操作。
  • 错误信息:是否看到错误信息,如有请提供。

同时自动收集环境信息:

  • 插件版本:读取 ~/.claude/plugins/installed_plugins.json 中与 compound-engineering 相关的内容。
  • Claude Code 版本:通过 claude --version 获取。
  • 操作系统信息:通过 uname -a 获取。

使用方式

命令将报告格式化为包含 Bug Description、Environment(插件版本、Claude Code 版本、OS)、What Happened、Expected Behavior、Steps to Reproduce、Error Messages、Additional Context 等部分的结构化文本,然后使用 GitHub CLI 创建 issue:

gh issue create
--repo EveryInc/compound-engineering-plugin
--title "[compound-engineering] Bug: [Brief description]"
--body "[Formatted bug report from Step 3]"
--label "bug,compound-engineering"

如果标签不存在,则不带标签创建:

gh issue create
--repo EveryInc/compound-engineering-plugin
--title "[compound-engineering] Bug: [Brief description]"
--body "[Formatted bug report]"

创建成功后,命令会向用户显示 issue URL,感谢用户报告,并说明维护者(Kieran Klaassen)将收到通知。

适用场景

当用户在使用 compound-engineering 插件过程中遇到 agent、command、skill、MCP server 或安装相关问题时使用。

限制与错误处理

  • 如果 gh CLI 未认证,命令会提示用户先运行 gh auth login。
  • 如果创建 issue 失败,命令会显示格式化后的报告,供用户手动创建 issue。
  • 如果缺少必要信息,命令会针对该字段重新提示。

隐私说明

该命令不收集:个人信息、API 密钥或凭据、项目中的私有代码、超出基本操作系统信息的文件路径。报告中只包含与缺陷相关的技术信息。