SuperAPI AI 工具集

nuke-split

智能体与模型

查看项目

更新于 10-15 17:24

技能介绍

用途:当规格中的任务对执行它的智能体来说过大时,nuke-split 会重新切分已有规格(如 nuke-audit 或 nuke-review 的 fix-spec、nuke-spec 的 build spec,或任何遵循 references/fix-spec-template.md 的文件),目标是“一个关注点约等于一个文件”,执行层级的预算是上限而非目标。原文件不会被修改。nuke-exec 在预检发现任务过大时也会内联应用同一协议;独立 split 用于在交给外部执行器或新会话前预先切分。

主要能力:按执行层级设定大小上限(clerk:每任务 1 文件、约 300 行,每批 ≤2 任务;worker 默认:≤3 文件、约 1.5 KLOC,每批 ≤3 任务;top:按规格原样,仅对超过约 10 文件的单任务切分)。切分顺序为文件边界优先,其次文件夹边界分组批次,最后才在单个超大文件内按区域(行范围)切分。切分沿依赖接缝进行,不穿过接缝;契约变更子任务排在最前;一个子任务只含一个关注点;定义与其测试同行;有顺序的子任务同批或连续阶段;区域切分落在符号边界。每个子任务携带父级发现/需求 ID、文件或区域列表及自己的机械 Accept。

使用方式:先完整读取规格,测量每个任务的文件数与 touched-file mass(用 wc -l 实测),已达目标的原样通过;其余按接缝规则再切分并重新分批,更新覆盖映射,写出 <original-name>.split.md(头部增加 split-from 与 budget),最后运行 nuke exec <path>.split.md。

限制:除单个 .split.md 输出外只读,不执行 git 命令、不改源码或原规格;不得弱化 Accept,否则拒绝该任务的切分并建议提高执行层级;判断依据是计数而非感觉。若任务已达目标、问题在于歧义而非大小,或需要为新规格定尺寸,则不应使用本工具。