mcpField
C
ce-report-bug

ce-report-bug

github.com/everyinc测试与质量25.8k1.7k 次安装今天更新
代码仓库

关于 ce-report-bug

为 compound-engineering 插件用户提供的缺陷报告技能，会收集复现步骤和环境信息，并创建结构化 GitHub issue；创建失败时可提供报告供手动提交。

主要功能

  1. 01收集结构化缺陷信息
  2. 02获取平台与版本信息
  3. 03整理统一格式的报告
  4. 04通过 GitHub CLI 创建 issue
  5. 05提供手动提交备用方案

适用场景

  1. 01报告插件命令或技能故障
  2. 02记录 MCP 服务问题
  3. 03在缺陷报告中附上环境信息
  4. 04GitHub issue 创建失败时准备报告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/everyinc/compound-engineering-plugin --skill ce-report-bug

安装后在 Claude Code 中输入/ce-report-bug确认已加载。

详细介绍

报告 Compound Engineering Plugin Bug

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

第 1 步：收集 Bug 信息

使用平台的阻塞式提问工具向用户提出以下问题：在 Claude Code 中使用 AskUserQuestion（如果尚未加载其架构，先调用 ToolSearch 并设置 select:AskUserQuestion），在 Codex 中使用 request_user_input，在 Gemini 中使用 ask_user，在 Pi 中使用 ask_user（需要 pi-ask-user 扩展）。只有在运行环境中没有阻塞式工具或工具调用出错时（例如 Codex 编辑模式），才在聊天中使用带编号的选项作为后备方案；不能仅仅因为需要加载架构而使用后备方案。绝不要默默跳过提问：

问题 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 版本标志

如果其中任何一项获取失败，记为“unknown”并继续 — 不要因此阻止报告。

第 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 `/ce-report-bug` 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 有关的技术信息。

评论

支持 Markdown