[!info] related notes

• 相关主题: Deep Module
• 相关 MOC: Matt Pocock Skills MOC, Modularization&Architecture MOC
• 相关 howto: Zoom Out Skill

Improve Codebase Architecture Skill

这是什么

一个不是直接上手重构，而是先找“值得深化的模块边界”的 skill。它关心哪些模块太浅、接口泄漏严重、测试困难、AI 和人都难导航。

适用平台

• 已经出现架构摩擦的中大型代码库
• 想提升可测试性、可演进性和 AI 可理解性的项目

核心特点 / 优势 / 局限

• 生效方式：先读领域文档和 ADR，再提出一组 deepening opportunities 供人选择
• 为什么要用：很多代码库问题不是“少一个模式”，而是模块深度不够
• 背后原理：好架构的价值在于隐藏复杂度，而不是再多造几层名词
• 局限：它会给方向，不会自动替你完成高风险架构迁移

常见用途

• 模块职责模糊、接口肿胀、难以测试
• AI 经常在代码库里迷路
• 旧 ADR 与当前摩擦开始不匹配

相关链接 / 官方入口

• 上游 skill：skills/engineering/improve-codebase-architecture/SKILL.md

Related notes

• Matt Pocock Skills MOC
• Skills 是什么，为什么重要