SuperAPI AI 工具集

report-bug-ce

测试与质量

查看项目

更新于 10-16 07:31

技能介绍

report-bug-ce 是 udecode/plate 中的一项技能,用于报告 compound-engineering 插件中遇到的缺陷。该技能会收集结构化的信息,并为主维护者创建一个 GitHub issue。

用途

用于在使用 compound-engineering 插件过程中遇到问题时进行反馈。技能会引导用户提供缺陷相关的结构化信息,并自动创建 GitHub issue 提交给维护者。

主要能力

该技能按步骤执行以下工作:

第一步:收集缺陷信息。向用户提出以下问题(使用平台的阻塞式提问工具,例如 Claude Code 中的 AskUserQuestion、Codex 中的 request_user_input、Gemini 中的 ask_user,或呈现编号选项并等待回复):

问题 1:缺陷类别。用户遇到的是什么类型的问题?选项包括:Agent 无法工作、Command 无法工作、Skill 无法工作、MCP 服务器问题、安装问题、其他。

问题 2:具体组件。受影响的组件是哪一个?询问 agent、command、skill 或 MCP 服务器的名称。

问题 3:发生了什么(实际行为)。询问:"当你使用这个组件时发生了什么?"获取对实际行为的清晰描述。

问题 4:应该发生什么(预期行为)。询问:"你原本期望发生什么?"获取对预期行为的清晰描述。

问题 5:复现步骤。询问:"在缺陷发生前你执行了哪些步骤?"获取复现步骤。

问题 6:错误信息。询问:"你看到任何错误信息了吗?如果有,请分享。"捕获任何错误输出。

第二步:收集环境信息。自动采集环境详情,检测编码代理平台并收集可用信息:

操作系统信息(所有平台):uname -a

插件版本:读取插件清单或已安装插件元数据。常见位置包括:Claude Code 为 ~/.claude/plugins/installed_plugins.json;Codex 为 .codex/plugins/ 或项目配置;其他平台检查对应平台的插件注册表。

Agent CLI 版本:运行平台的版本命令。Claude Code 为 claude --version;Codex 为 codex --version;其他平台使用相应的 CLI 版本参数。

如果上述任何一项失败,标记为 "unknown" 并继续,不要阻断报告。

第三步:格式化缺陷报告。创建结构清晰的缺陷报告,包含:缺陷描述(组件、摘要)、环境(插件版本、代理平台、代理版本、操作系统)、发生了什么、预期行为、复现步骤、错误信息、附加上下文。结尾标注 Reported via /report-bug-ce skill。

第四步:创建 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]"

第五步:确认提交。issue 创建后:向用户显示 issue URL;感谢用户报告缺陷;告知用户维护者(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.

使用方式

通过 /report-bug-ce 技能触发,按平台提示回答各个问题,技能会自动采集环境信息并创建 GitHub Issue。

错误处理

如果 gh CLI 未安装或未认证:提示用户先安装或认证。如果 issue 创建失败:展示格式化后的报告,供用户手动创建 issue。如果缺少必要信息:针对该具体字段重新询问。

适用场景

适用于使用 compound-engineering 插件并希望反馈缺陷的用户,尤其是遇到 Agent、Command、Skill、MCP 服务器、安装等问题时。

限制

该技能依赖 gh CLI 且需要完成认证,否则无法自动创建 issue。若创建失败,只能由用户手动提交。隐私方面,该技能不会收集:个人信息、API 密钥或凭证、项目中的私有代码、超出基本操作系统信息的文件路径。报告中只包含与缺陷相关的技术信息。