architecture-governance

Installation
SKILL.md

架构治理

这个 skill-unit 处理的是“架构边界与演进质量”问题。它不替代具体职责拆分;当问题已经落到文件、类、函数职责边界时,应联动 single-responsibility

核心原则

1. 分层与依赖方向 —— 单向流动

  • 依赖方向必须单向流动:上层依赖下层,禁止反向依赖。
  • 禁止跨层直连:上层通过明确的应用接口或服务访问下层能力。
  • 基础设施实现不得承载业务决策。
  • 每个模块都应能回答:自己属于哪一层、依赖谁、被谁依赖。

2. 架构变更影响面 —— 先看上下游

  • 变更前先标注所在层级、主要职责、上游调用方、下游依赖与数据流。
  • 任何接口变更都必须说明兼容策略:兼容、适配、版本化,至少占一种。
  • 分层结构调整、依赖方向变化、数据流主路径重排,都属于高风险架构变更。
  • 不能只看当前改动点本身,还要看它会把风险传播到哪里。
Related skills

More from qiao-925/qiao-skills

Installs
19
First Seen
Feb 9, 2026