报告错误技能Skill report-bug

此技能用于报告compound-engineering插件的错误,通过交互式问题收集错误详情,自动生成并提交GitHub问题,方便用户快速反馈bug。关键词:错误报告,GitHub问题,插件测试,bug追踪,软件开发。

测试 0 次安装 0 次浏览 更新于 3/9/2026

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: 确认提交

问题创建后:

  1. 向用户显示问题URL
  2. 感谢他们报告错误
  3. 让他们知道维护者(Kieran Klaassen)将被通知

输出格式

✅ 错误报告提交成功!

问题: https://github.com/EveryInc/compound-engineering-plugin/issues/[编号]
标题: [compound-engineering] Bug: [描述]

感谢您帮助改进compound-engineering插件!
维护者将审查您的报告并尽快回复。

错误处理

  • 如果gh CLI未认证:提示用户先运行gh auth login
  • 如果问题创建失败:显示格式化报告,以便用户手动创建问题
  • 如果必需信息缺失:重新提示该特定字段

隐私声明

此命令不收集:

  • 个人信息
  • API密钥或凭据
  • 您项目的私有代码
  • 超出基本操作系统信息的文件路径

报告中仅包含有关错误的技术信息。