improve-codebase-architecture

Installation
SKILL.md

架构审查

找出架构上的问题点,提出加深模块的机会:把浅模块重构为深模块。目标是提高可测性,并让 AI 更容易理解和定位代码。

本命令以项目的领域模型为依据,并使用一套共享的设计术语:

  • 使用 codebase-design skill 获取架构术语(模块接口深度接缝适配器杠杆局部性)及其原则(删除测试、“接口就是测试面”、“有两个适配器时接缝才真实存在”)。描述模块设计时一致地使用这些术语;组件、服务、API、边界等词只在符合其原义时使用,不用来替代这些术语。
  • CONTEXT.md 中的领域语言用于为接缝命名;docs/adr/ 中的 ADR 记录了本命令不应重新争论的决定。

过程

1. 探索

先确定范围,再扫描(YAGNI)。 加深模块的回报在于以后修改它更容易,所以优先关注代码库中最近经常变化的部分。开始查看之前,先决定看哪里

  • 用户指定了方向(某个模块、子系统或痛点)时,按用户的方向进行,跳过下面的推断。
  • 否则,查看较长一段提交历史(git log --oneline),找出代码库的热点:反复被修改的文件和区域,优先关注这些路径。改动分散、没有明显热点时,扩大范围。

先阅读项目的术语表(CONTEXT.md)和涉及区域的 ADR。

Installs
3
First Seen
8 days ago
improve-codebase-architecture — hydrz/dev-skills