arch-design
Installation
SKILL.md
架构设计
planning 阶段的 skill,只做架构层面的概要设计。spec 定了"做什么",这个 skill 定"怎么做"——但只到架构层面(模块、依赖、分层、接缝),不下沉到代码细节。之后由 incremental-impl 把设计切片落地。
spec-design → arch-design → incremental-impl
(为什么 + 做什么) (怎么做 —— 本 skill) (切片 + 实现)
为什么需要这一步:软件有两份价值——它现在的行为,和它未来改起来有多便宜。后者就是架构。架构设计的目的不是"现在能跑",是让系统保持"软"。这条立意同时反对两件事:草草不设计(欠下的债未来加倍偿还)和过度设计(为想象中的需求堆抽象,每一层都要在以后每次阅读代码时付利息)。这个 skill 的每条规则,都服务于在这两者之间找到"刚好够"的设计。
什么时候用
两个独立入口都进这个 skill,都在架构高度:
| 入口 | 触发 | 上游输入 |
|---|---|---|
| 新功能架构设计 | 一个新功能走完 spec-design,规模分诊判定它跨边界、或验收标准超过 5 条、或跨模块,需要真正的设计 |
docs/specs/<topic>/spec.md + validation-contract.md |
| 既有系统架构升级 | 一段已有代码结构有问题,想改进它的架构,但不改变对外可见行为 | 目标代码 + 一句具体的结构抱怨 |