SuperAPI AI 工具集

improve-architecture

通用与其它

查看项目

更新于 10-16 01:11

技能介绍

用途:逐步改善系统结构,避免日后大规模重写。该技能只做诊断与提案,不会自行重写代码。

方法:先绘制当前形态,梳理入口、模块、数据流与调用关系,可复用 module-map 获得一屏概览,不要跳过直接下判断。再寻找承重问题而非风格细节,包括:被所有模块导入却难以安全修改的上帝模块;模块越过表面接口深入他人内部造成的泄漏边界;同一规则以三种方式实现且逐渐漂移的重复逻辑;在不应弯折处拆分、在应弯折处融合的错误接缝;循环依赖;与领域相冲突的结构(可参考 domain-modeling,代码边界应跟随语言边界)。

针对每个问题提出缓解它的最小改动:抽取边界、合并重复、反转依赖、移动接缝,优先采用一系列安全步骤而非一次大改。按收益排序,说明哪些现在安全、哪些需要先有测试网(可配合 tdd)。对将来读者会质疑的结构性变更,在 docs/decisions/NNNN-slug.md 写决策记录,包含背景、选择、被否方案与原因。

护栏:只诊断不重写,交付物是用户批准后才动代码的计划;不为口味制造改动,每个改动必须缓解已命名的问题;三行相似代码优于过早抽象,除非重复确实在漂移;保持行为不变,结构改动属于重构,应在测试通过的前提下落地。

输出:一份按优先级排列的清单,每项包含问题、最小改动、风险以及是否需要先建测试网,并为重大改动附决策记录。用户选定前不做任何代码修改。

限制:资料未提供具体安装命令、收费方式、支持平台或效果数据。