用途
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 密钥或凭据、项目中的私有代码、超出基本操作系统信息的文件路径。报告中只包含与缺陷相关的技术信息。