improve-codebase-architecture

Installation
SKILL.md

Improve Codebase Architecture

发现架构摩擦并提出模块深化机会:把浅模块重构为深模块,提高可测试性和 AI 可导航性。本 Skill 只做只读探索、报告和决策收口,不修改业务代码;用户确认要实施后再进入 impl

流程

1. 加载项目上下文

使用已加载的 CONTEXT 术语与 RULE。尚未加载则按项目知识协议执行;知识不可用时继续并如实说明。项目术语用于命名业务概念,相关 ADR 用于识别不应无故重新打开的既有决策。

完整读取 codebase-design,使用其中的模块、接口、深度、接缝、适配器、杠杆、局部性词汇和判断准则。

2. 探索

先限定扫描范围:YAGNI。 深化模块的收益来自让未来变化更容易,因此优先关注近期频繁变化的区域。

  • 用户指定模块、子系统或痛点时,直接使用该方向。
  • 用户未指定时,查看一段足够长的 git log --oneline,找出反复出现的文件和热点区域;没有明显热点时再扩大范围。
Installs
18
GitHub Stars
1
First Seen
Jul 18, 2026
improve-codebase-architecture — zuozh11/agent-skill-engineering