improve-codebase-architecture

Overview

扫一遍代码库,挑出结构上的痛点,产出 deepening 候选清单 —— 不改代码。

视角:John Ousterhout 的 deep/shallow 模块框架。deep module = 接口简单 + 功能强大;shallow module = 接口跟实现一样复杂。每个候选按这个维度评分,而不是按"行数"或"美学"。

为什么 proposal-only:架构改造是高风险动作,不该在审查 skill 里顺手做。incremental-implementation 才是真正动刀的 skill。本 skill 只产出 docs/architecture-review/<repo-hash>-<date>/review.md(git tracked 项目级 audit log),由你 / 团队决定哪些候选上 Phase 3 切片。

When to Use

Use when: (软触发 — 以下是典型场景,AI 按 description 匹配自决)

• 新接手一个陌生 codebase,在让 agent 大规模介入前先扫一遍
• 周期性回顾(每周 / 每两周 / 每个开发高峰后)
• 怀疑"agent 在烂 codebase 里产出更烂的代码"
• 跨文件耦合信号:加一个 feature 改了 5+ 个文件,感觉不对劲
• 团队扩张 / 新人 on-boarding