SuperAPI AI 工具集

nuke-fix

测试与质量

查看项目

更新于 10-15 17:23

技能介绍

用途:执行修复规范(fix spec),按阶段推进,直到规范内的全部任务达到执行器上下文记录的质量门槛。它是 nuke-audit 与 nuke-review 的对应执行端,也可处理任何带有执行器上下文、按路径前缀划分的 Gates 表、依赖排序的阶段、可并行批次和逐任务验收标准的规范(结构见 references/fix-spec-template.md)。核心原则为“非对称验证”:弱生成+强验证+修复循环=强输出,验证者始终比实现者高一个层级。

用法:参数含 [mode](light|full|plan,缺省时按规范头部记录的 mode,无则默认 light;plan 只跑预检、打印计划块后停止不写文件)、<spec-path>(修复规范路径,如 fix-spec.md 或 nuke-spec 的 spec.md;若同级已有 fix-progress.md 则从首个未完成阶段续跑)、--yes(跳过预检确认门)。

主要能力:Phase 0 预检读取规范全文、跑一遍 Gates 表基线、打印计划块(范围、模式、阶段×批次、层级分配、成本估算)等待确认;确认后写 fix-plan.md 与 fix-progress.md。每个阶段按“实现波→验证(全新且高一层级的代理)→修复循环→标记完成”推进,任何失败标准、失败门、升级任务或新发现都进入修复循环。全部阶段结束后做最终验证与报告,追加校准行到 .nuke/calibration.log,并给出结论。

限制与约束:不得静默升降级角色层级;实现者不得自验;不执行 git add/git commit/git stash,不产生 .bak 文件;无门禁输出证据不得声称成功;任务验收不可机械检查时应升级而非猜测;修复循环每阶段有上限(light 3 次、full 5 次),触顶即停止并如实记录。平台差异与层级机制见 references/model-tiers.md、references/preflight.md 等;具体命令与分层细节暂未在资料中完整提供。