name: report-bug description: 报告compound-engineering插件中的bug
参数
[可选:bug的简要描述]
报告Compound-Engineering插件Bug
报告在使用compound-engineering插件时遇到的bug。此命令收集结构化信息并为维护者创建GitHub issue。
步骤1:收集Bug信息
使用AskUserQuestion工具收集以下信息:
问题1:Bug类别
- 您遇到的是什么类型的问题?
- 选项:代理不工作、命令不工作、技能不工作、MCP服务器问题、安装问题、其他
问题2:具体组件
- 哪个具体组件受到影响?
- 询问代理、命令、技能或MCP服务器的名称
问题3:发生了什么(实际行为)
- 询问:“当您使用此组件时发生了什么?”
- 获取实际行为的清晰描述
问题4:应该发生什么(预期行为)
- 询问:“您期望发生什么?”
- 获取预期行为的清晰描述
问题5:复现步骤
- 询问:“在bug发生之前您采取了什么步骤?”
- 获取复现步骤
问题6:错误消息
- 询问:“您看到任何错误消息了吗?如果是,请分享。”
- 捕获任何错误输出
步骤2:收集环境信息
自动收集:
# 获取插件版本
cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | grep -A5 "compound-engineering" | head -10 || echo "未找到插件信息"
# 获取Claude Code版本
claude --version 2>/dev/null || echo "Claude CLI版本未知"
# 获取OS信息
uname -a
步骤3:格式化Bug报告
创建结构良好的bug报告:
## Bug描述
**组件:** [类型] - [名称]
**摘要:** [从参数或收集信息中的简要描述]
## 环境
- **插件版本:** [从installed_plugins.json]
- **Claude Code版本:** [从claude --version]
- **操作系统:** [从uname]
## 发生了什么
[实际行为描述]
## 预期行为
[预期行为描述]
## 复现步骤
1. [步骤1]
2. [步骤2]
3. [步骤3]
## 错误消息
[任何错误输出]
## 额外上下文
[任何其他相关信息]
---
*通过`/report-bug`命令报告*
步骤4:创建GitHub Issue
使用GitHub CLI创建issue:
gh issue create \
--repo EveryInc/compound-engineering-plugin \
--title "[compound-engineering] Bug: [简要描述]" \
--body "[从步骤3格式化的bug报告]" \
--label "bug,compound-engineering"
注意: 如果标签不存在,创建时不带标签:
gh issue create \
--repo EveryInc/compound-engineering-plugin \
--title "[compound-engineering] Bug: [简要描述]" \
--body "[格式化的bug报告]"
步骤5:确认提交
在issue创建后:
- 向用户显示issue URL
- 感谢他们报告bug
- 让他们知道维护者(Kieran Klaassen)会被通知
输出格式
✅ 成功提交bug报告!
Issue: https://github.com/EveryInc/compound-engineering-plugin/issues/[NUMBER]
Title: [compound-engineering] Bug: [描述]
感谢您帮助改进compound-engineering插件!
维护者将审核您的报告并尽快回复。
错误处理
- 如果
ghCLI未认证:提示用户先运行gh auth login - 如果issue创建失败:显示格式化的报告,以便用户手动创建issue
- 如果所需信息缺失:重新提示该特定字段
隐私声明
此命令不收集:
- 个人信息
- API密钥或凭据
- 您项目中的私有代码
- 超出基本OS信息的文件路径
报告中仅包含有关bug的技术信息。