用途：在 TypeScript 项目中把 SOLID、DRY、KISS、YAGNI 作为约束而非教条，用于设计可扩展架构、编写可维护代码或进行代码评审，优先考虑可度量的可维护性。
适用时机：重构存在耦合与重复的复杂模块；评审架构决策或 PR 质量；设计可复用的 TypeScript 服务或组件。
主要原则：SOLID 包含 SRP（每个单元只有一个变更原因）、OCP（在不修改稳定核心的前提下扩展行为）、LSP（子类型必须保持契约行为）、ISP（面向消费者的小接口）、DIP（依赖抽象而非具体细节）。辅助规则：DRY 去除重复业务逻辑；KISS 偏好简单控制流与明确命名；YAGNI 避免推测性抽象。
重构流程：检测坏味道（过大的函数或类、依恋情结、重复条件分支、时间耦合）；围绕当前行为编写或扩展测试；抽取边界（接口、服务、适配器）；减少职责与依赖；重新运行测试并对比行为。
代码评审清单：该变更降低还是提高耦合；契约是否明确稳定；重复是否被有意义地减少；是否在需要处反转依赖；复杂度是否低于此前。
对智能体的输出要求：以文件级证据指出具体坏味道；推荐最小安全重构顺序；说明权衡与迁移风险；提供保持行为的测试策略。
参考资料：详细示例与前后对比重构见 references/guide.md。限制：资料未提供安装命令、平台支持、收费或价格信息。