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 密钥或凭证、项目中的私有代码、超出基本操作系统信息的文件路径。报告中只包含与缺陷相关的技术信息。