用途:这是一份重构与模块化原则指南,针对 LLM 在重构任务中反复出现的系统性盲点,核心观点是:LLM 往往优化代码“看起来像什么”(结构相似性),而好的模块化应优化代码“如何一起变化”(时间内聚性)。适用于模块抽取、文件拆分、降低耦合、代码审查、架构决策等场景。
主要能力:提供检测启发式表,把代码信号映射到对应的坏味道与原则,例如数据泥团、特性依恋、缺失多态、导入环、布尔参数、死代码、时间耦合、泄漏集成、错误泄漏、伪模块化、上帝服务等。原则分五大类:结构耦合(接缝识别、connascence 谱、稳定性度量、发散式变化与散弹式修改的区分、数据所有权、易变性隔离);类型级设计(解析而非校验、让非法状态不可表示、newtype、type-state);架构(函数式核心与命令式外壳、防腐层、绞杀者模式、Mikado 方法、组合根);模块边界(按特性分包、无环依赖、共同闭包、接口隔离、不变量强制、错误边界翻译);战术动作(删除即重构、三次法则、先内联再重抽、扩展-收缩、布尔参数禁止、显式配置依赖、特征化测试、康威定律对齐、过度模块化检查、模块文档模板)。另有 Rust 与 Swift/macOS 专项参考。
使用方式:按“检测—诊断—计划—执行—验证”流程推进;多文件改动(超过 3 个文件)用 Mikado 方法,共享接口用扩展-收缩。该技能为自演化型,若指令有误、参数漂移或需要绕过,应即时修正文件,且仅针对真实可复现问题更新。
限制:资料未提供具体安装命令、平台要求或收费信息;内容以原则与流程为主,不含可直接套用的完整示例代码。