用途:针对 bug 和异常行为展开诊断循环,找到从触发原因到可观察症状的完整因果链后,在用户选择的情况下以测试优先的方式修复。
主要能力:按固定五阶段执行——0 分诊、1 调查、2 根因、3 修复、4 交接。除简单 bug 快速路径外不可跳过阶段。要求用 file:line 证据说明因果链,无缺口后才能进入修复;一次只验证一个假设、只改一处,避免散弹式调试。若穷尽 2-3 个假设仍无确认,或 3 次修复尝试失败,则升级转为诊断原因,而非继续重试。
使用方式:以失败描述、mode 令牌或 issue 引用(#123、org/repo#123、issue URL)调用。默认交互模式:调查后进入阶段 2 的修复选择门,再由阶段 4 交接。mode:pipeline 由编排器设置,完全非交互运行,返回值状态固定为 fixed-and-pushed、fixed-not-pushed、diagnosed-no-fix、flaky-infra 或 needs-human。mode:return-to-caller 同样非交互,由调用方接管修复之后的一切,返回值状态为 fixed、diagnosed-no-fix、needs-human 或 blocked。两种模式的 token 拼写不可改名或缩写。需要向用户提问时应使用宿主已有的阻塞式提问工具,缺失时回退为编号选项,不得静默跳过问题。
阶段 2 会先完整写出发现块(因果链、拟议修复与改动文件、相关测试建议、关联工单或 PR),再提问选择:立即修复、仅诊断、或转 ce-brainstorm 重新设计。
限制与注意:调试会暴露命令输出、负载和日志,须从命令构造时就检查密钥,用环境变量而非命令行传凭据,输出可能含密钥时写入文件并只展示脱敏片段,以 <REDACTED> 替换。产物根目录 <root> 取自仓库 .compound-engineering/config.yaml 的 docs_root,未设置则为 docs,并校验其为仓库内相对目录。git 相关操作有分支、提交范围与推送的安全约束。非 git 仓库则不提交。官方文档未提供更多安装命令、收费或平台信息。