SuperAPI AI 工具集

clean-code

编程与开发

查看项目

更新于 10-15 21:43

技能介绍

用途:对既有代码做原地审计与重构,提升可读性和可维护性,移除死代码、AI 生成冗余、未使用依赖与生产浪费资源,同时保持行为不变,并产出带日期的清理记录。核心判断标准是“该改动是否纯结构性、零行为影响”。

主要能力:采用多智能体编排(8 个智能体、2 层:4 个并行扫描器 → 安全移除 → 重构 → 验证 → 评审),支持单智能体回退;扫描代码、依赖与资源,识别垃圾文件、空目录、大目录、未使用代码、未使用/损坏/重复资源及未优化媒体。

使用方式:独立使用,无上游门禁。启动前做模式解析(deep 预算,≤5 文件范围自动降级为 fast,--fast 强制单智能体,安全门禁优先于 --fast),读取实现路线图、.forsvn/index/manifest.json 与 docs/forsvn/experience/technical.md。产物路径为 docs/forsvn/artifacts/meta-clean-code-<YYYY-MM-DD>-cleanup-<slug>.md,同日同 slug 重跑追加 .v[N]。

五条黄金规则:保持行为、小步增量、先查既有约定、每次改动后跑测试、具备回滚意识。会话限制约 30 处改动,15 处后生成中期摘要;若每个修复引发 2 个以上新问题则停止重估。

适用场景:代码库积累死代码、AI 冗余、未使用依赖或生产浪费资源;重大功能新增后、发布里程碑前、测试运行时间增长时;新成员入职因结构冗余受阻时。

限制:不得与功能改动混合(始终分开提交);无测试覆盖且需保持行为时先写测试;存在与清理无关的既有测试/构建失败时状态为 BLOCKED;不会再被阅读或修改的代码不建议投入;重复的运营机制(相同 SDK 设置、重试循环、I/O 管道)应使用 /extract-service,clean-code 不设计服务边界。完成状态包括 DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT。