SuperAPI AI 工具集

code-compaction

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:当代码、测试或注释的 diff 被评价为臃肿、LLM 垃圾、过度设计、临时拼凑或“不按行数付费”时,使用该技能检测 diff 膨胀,并组织跨模型对抗式审查者进行压缩。具体风格规则(何为臃肿注释、测试膨胀、超大文件、无理由辅助函数、阶段标签、提交/PR 拆分等)位于 .github/instructions/NoBloat.instructions.md,本技能不重复。

主要能力:按 diff 实际信号选择模式,而非用户措辞。触发词只表示技能适用,不决定模式。先运行 Pre-flight Measure;若未提供 diff/PR/分支,则获取一个(git diff 分支 vs git merge-base main HEAD)或询问。然后按表格顺序执行 diff 中出现的每一行信号。信号包括:新增规划 .md、.tools/、一次性设置、阶段/冲刺标签、死代码、新配置/YAML 或注释密集文件,走 Garbage Hunt;测试文件复制粘贴方法、重复设置或缺少参数化,走 Test Compaction;4 个以上新辅助函数、新 AST/IR/语法树遍历器、孪生辅助函数、手写智能构造器或近似重复逻辑,走 Logic Compaction;自包含概念使已很大文件膨胀,优先提取到新文件;其他大量新逻辑,走 Logic Compaction 的 Round 0 复用搜寻。

使用方式:Pre-flight 步骤 1–2 在模式选择器之前运行,用于路由;步骤 3–4 是选定模式后的准备。更新 main 并解决冲突,不要基于陈旧分支判断。用 git merge-base main HEAD 作为 base 进行测量,提供 LOC、注释比例、新辅助函数计数的气味计。固定引导测试:必须通过,且必须因正确原因失败。将测量结果与相关模板打包成一个上下文文件供每个审查者使用。每个模式并行派发 3–5 个后台审查者,绝不串行;跨模型优于跨角度。每个代理从模板中选择一个角度,记录模型×角度×LOC×测试×复用×结论。跨模型一致是信号;单一模型主张需代码引用才能提升。若用户要求红旗设置(如“用同样 3 个模型”“单代理足够”),先按此规则反驳一次,若坚持则遵从,不得静默违反。

应用:选定获胜方案后,在 PR 分支上应用,运行格式化/检查,运行目标测试及该区域测试类作为回归扫描,运行基线更新。若扫描测试失败,先在变更前 SHA 上复现再分类,无证据不得称“预先存在”或“不稳定”。提交拆分/推送前询问见 NoBloat PR 范围规则。

红旗(仅流程失败):跳过模式选择直接“缩小 diff”;串行或同模型审查者;用 grep 找相似函数而非派发真实复用搜寻子代理;获胜方案新增代码却未引用 Round 0 子代理输出中的一个复用辅助函数;在 3 个文件中发现重复形态却添加第 4 份副本。出现这些情况应打开相关模板重跑。

不适用:合法的大型多子系统功能;生成产物;机械性变更(依赖升级、重命名);最小单行修复;GitHub 散文或 PR/issue 文本。