报告bug技能Skill report-bug

此技能用于自动化报告compound-engineering插件中的bug,通过命令行界面收集用户输入和系统环境信息,生成结构化报告并直接提交到GitHub issue,简化bug报告流程,提高开发维护效率。关键词:bug报告、GitHub issue、compound-engineering插件、自动化报告、开发工具、插件维护。

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

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创建后:

  1. 向用户显示issue URL
  2. 感谢他们报告bug
  3. 让他们知道维护者(Kieran Klaassen)会被通知

输出格式

✅ 成功提交bug报告!

Issue: https://github.com/EveryInc/compound-engineering-plugin/issues/[NUMBER]
Title: [compound-engineering] Bug: [描述]

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

错误处理

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

隐私声明

此命令不收集:

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

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