SuperAPI AI 工具集

simplify

编程与开发

查看项目

更新于 10-16 09:53

技能介绍

用途:在代码或工作流改动完成后,找出并移除该次改动引入的多余复杂度,仅做保持行为不变的最小清理,使最终改动更易维护。适用于实现和评审之后,或修复越改越大的场景。

主要能力:先绑定改动范围,记录原始需求、评审基线、变更路径与当前 diff 或内容哈希,并阅读完整 diff 及相关上下文;清理范围限于当前任务 diff,不触碰无关的既有代码。随后只针对几类问题检查:本次改动引入的重复、需求不需要的抽象/分支/配置/错误处理、本次改动引入的无用导入、变量、函数、文件或间接层、可在不改变公开契约前提下更清晰的控制流或命名,以及不符合注释规则的注释。优先删除并用直接代码,而非新增辅助函数;可复用已有本地模式来消除分叉;保留必需的守卫、证据、恢复行为、测试与用户确认的决定。

注释扫描:仅保留导出符号上一行 /** */ 契约注释,或带 URL、规范章节、ADR 或 docs/ 路径、issue 编号的一行引用注释;其余注释一律删除,包括解释代码做什么、为何如此、会破坏什么的注释。会用规则中的 grep 扫描 diff 并删除命中注释。项目规则可收紧但不可放松此扫描。

使用方式与限制:仅应用代码与现有测试能支持等价性的清理;若清理会改变行为、需求、公开输出、持久化、授权或失败语义,则作为单独提案返回,不直接应用。重新运行因清理而失效的检查,将最终 diff 与原始需求比较;若清理改动了已完成评审覆盖的内容,则通过 converge-reviews 只使该覆盖失效并重跑,陈旧收敛结果不能验证简化后的 diff。报告所做编辑,或“无需简化”,并给出准确验证结果。判定完成的条件:diff 不超出需求范围、每行保留都有任务理由、适用检查仍通过。