ce-report-bug 的用途是向上游维护者报告使用 compound-engineering 插件时遇到的问题。它会以结构化方式收集信息,并创建一个 GitHub issue。
主要能力与流程:技能先通过平台的阻塞式提问工具向用户提问(Claude Code 用 AskUserQuestion,Codex 用 request_user_input,Gemini 用 ask_user,Pi 用 ask_user;仅当运行环境没有阻塞式工具或调用报错时才退回聊天中的编号选项)。问题涵盖缺陷类别(智能体、命令、技能、MCP 服务器、安装问题或其他)、具体组件名称、实际行为、预期行为、复现步骤与错误信息。随后自动采集环境信息:用 uname -a 获取操作系统,读取插件清单或已安装插件元数据获取插件版本(如 Claude Code 的 ~/.claude/plugins/installed_plugins.json),并用各平台的版本命令获取智能体 CLI 版本(如 claude --version、codex --version);采集失败则记作 unknown 并继续,不阻断上报。
使用方式:技能把上述信息格式化为包含缺陷描述、环境、实际行为、预期行为、复现步骤、错误信息和补充上下文的报告,然后用 GitHub CLI 创建 issue:gh issue create --repo EveryInc/compound-engineering-plugin --title "[compound-engineering] Bug: [Brief description]" --body "[Formatted bug report]" --label "bug,compound-engineering";若标签不存在,则去掉 --label 参数。创建成功后显示 issue URL 并致谢。
限制与边界:若 gh CLI 未安装或未认证,会先提示安装或登录;若创建 issue 失败,则展示格式化报告供用户手动提交;若缺少必需信息,会重新询问对应字段。技能声明不收集个人信息、API 密钥或凭据、项目私有代码,以及除基本操作系统信息之外的文件路径。