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