report-bug-ce

报告 Compound Engineering 插件 Bug

报告使用 compound-engineering 插件时遇到的 Bug。此技能会收集结构化信息，并为维护者创建 GitHub issue。

第 1 步：收集 Bug 信息

向用户提出以下问题（使用平台的阻塞式提问工具，例如 Claude Code 中的 AskUserQuestion、Codex 中的 request_user_input、Gemini 中的 ask_user，或提供编号选项并等待回复）：

问题 1：Bug 类别

• 你遇到了哪种类型的问题？
• 选项：Agent 无法工作、命令无法工作、技能无法工作、MCP 服务问题、安装问题、其他

问题 2：具体组件

• 哪个具体组件受到了影响？
• 询问 Agent、命令、技能或 MCP 服务的名称

问题 3：发生了什么（实际行为）

• 询问：“使用此组件时发生了什么？”
• 请用户清楚描述实际行为

问题 4：本应发生什么（预期行为）

• 询问：“你原本预期会发生什么？”
• 请用户清楚描述预期行为

问题 5：复现步骤

• 询问：“Bug 发生前，你执行了哪些步骤？”
• 获取复现步骤

问题 6：错误消息

• 询问：“你看到了任何错误消息吗？如果有，请分享。”
• 收集所有错误输出

第 2 步：收集环境信息

自动收集环境详情。检测编码 Agent 平台，并收集可用信息：

操作系统信息（所有平台）：

uname -a

**插件版本：**读取插件清单或已安装插件元数据。常见位置：

• Claude Code：~/.claude/plugins/installed_plugins.json
• Codex：.codex/plugins/ 或项目配置
• 其他平台：检查平台的插件注册表

**Agent CLI 版本：**运行平台对应的版本命令：

• Claude Code：claude --version
• Codex：codex --version
• 其他平台：使用相应的 CLI 版本标志

如果其中任何一项失败，请注明“未知”并继续，不要因此阻止报告流程。

第 3 步：整理 Bug 报告

创建结构清晰的 Bug 报告，包含：

## Bug Description

**Component:** [Type] - [Name]
**Summary:** [Brief description from argument or collected info]

## Environment

- **Plugin Version:** [from plugin manifest/registry]
- **Agent Platform:** [e.g., Claude Code, Codex, Copilot, Pi, Kilo]
- **Agent Version:** [from CLI version command]
- **OS:** [from uname]

## What Happened

[Actual behavior description]

## Expected Behavior

[Expected behavior description]

## Steps to Reproduce

1. [Step 1]
2. [Step 2]
3. [Step 3]

## Error Messages

[Any error output]

## Additional Context

[Any other relevant information]

---
*Reported via `/report-bug-ce` skill*

第 4 步：创建 GitHub Issue

使用 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]"

第 5 步：确认提交

创建 issue 后：

1. 向用户显示 issue URL
2. 感谢用户报告 Bug
3. 告知用户，维护者 Kieran Klaassen 会收到通知

输出格式

Bug report submitted successfully!

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

Thank you for helping improve the compound-engineering plugin!
The maintainer will review your report and respond as soon as possible.

错误处理

• 如果未安装 gh CLI 或尚未通过身份验证：提示用户先安装或完成身份验证
• 如果创建 issue 失败：显示整理好的报告，以便用户手动创建 issue
• 如果缺少必填信息：针对缺失的字段重新提问

隐私声明

此技能不会收集：

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

报告中只会包含与 Bug 相关的技术信息。