用途:nuke-debug 用于对单个 bug、回归、失败测试、flaky 行为或无法解释的输出做根因分析并修复,而不是快速打补丁。它纠正“在症状出现处修补、用防御性代码包裹崩溃点”的做法,流程为 reproduce → localize → fix → verify,前一阶段未产出证据则不进入下一阶段。
主要能力:支持 light(默认)、full、plan 三种模式;plan 只运行预检、打印计划块后停止,不写入任何内容。参数可传 bug 描述、失败测试路径或名称、或确切失败命令;--ask 会在预检计划处暂停确认,默认无门禁直接运行。角色分 clerk/worker/session/top 层级,light 与 full 在复现者、定位者数量、裁决者、修复者、验证者层级、假设波次上限(3/3)和修复-验证循环上限(3/5)上不同。
使用方式:运行目录为 .nuke/<YYYY-MM-DD>-<HHmmss>-debug-<slug>/,每次新建,不重用或恢复旧目录;若路径已存在则追加 -2、-3 等直到 mkdir 成功。产出 plan.md(预检输出)与 debug.md(复现、波次日志、根因与追踪、修复记录、清扫结果)。流程为 Phase 0 预检、Phase 1 复现、Phase 2 定位(波次上限 3)、Phase 3 修复、Phase 4 验证与清扫,最后给出结论。
限制与约束:无复现不得修复;无法复现则停止并报告缺失信息。修复须落在根因处,不得在崩溃点加 null 检查、重试、try/catch 或 sleep 等防御性补丁。一次只改一个变量,所有结论标注为事实或假设。禁止 git add、git commit、git stash,不生成 .bak 文件,工作树留给人工审查。主上下文保持精简,不传递文件内容。不得静默升降角色层级。达到上限时如实报告波次/循环日志,不得声称“可能已修复”。若修复不断扩散,建议改用 nuke-audit。其他平台细节、模型层级与栈适配器规则见其引用文档,资料未提供具体内容。