architecture-governance
Installation
SKILL.md
架构治理
这个 skill-unit 处理的是“架构边界与演进质量”问题。它不替代具体职责拆分;当问题已经落到文件、类、函数职责边界时,应联动
single-responsibility。
核心原则
1. 分层与依赖方向 —— 单向流动
- 依赖方向必须单向流动:上层依赖下层,禁止反向依赖。
- 禁止跨层直连:上层通过明确的应用接口或服务访问下层能力。
- 基础设施实现不得承载业务决策。
- 每个模块都应能回答:自己属于哪一层、依赖谁、被谁依赖。
2. 架构变更影响面 —— 先看上下游
- 变更前先标注所在层级、主要职责、上游调用方、下游依赖与数据流。
- 任何接口变更都必须说明兼容策略:兼容、适配、版本化,至少占一种。
- 分层结构调整、依赖方向变化、数据流主路径重排,都属于高风险架构变更。
- 不能只看当前改动点本身,还要看它会把风险传播到哪里。