用途:当变更跨越模块边界、引入模块间依赖方向、触及关键路径,或与已声明原则冲突时,用该技能把架构不变量当作承重契约来守卫。前提背景:需要 principal-engineering 技能。
主要能力:为每条不变量命名并编号以便引用(如“Law 3”),包含与具体技术无关的陈述、理由和影响;理由写成具体的故障叙事,说明违反后会出现哪一类 bug。把稳定部分与易变部分分开:原则文档很少改动且不提类名,其当前实现(规范所有者、守卫、参考设计)放在随代码变化的配套文档中;两者冲突时不变量优先,配套文档被更正。
使用方式:对每条可强制的不变量编写架构测试,使构建失败,覆盖依赖方向、包边界、分层规则、禁止导入;无法用构建强制的内容变成具名评审检查,并引用对应不变量。设计若触及受守护区域,须逐条列出所涉不变量及各自的遵守方式,评审者据此核对而非争论偏好。违规意味着重新设计,不得把例外论证进规范;真正的例外必须提出修正案,说明弯曲了哪条不变量及其边界,静默例外不被允许;临时例外采用带到期条件和所有者签字的限时豁免,记录在易变的实现文档中。无法解释的守卫排除项应上报给不变量所有者,且不构成先例。
常见不变量类型(示例而非强制):每个关注点一个规范所有者;依赖方向,领域层永不导入交付机制;关键路径隔离,热路径上不做 I/O、不接慢或可选依赖;失败关闭边界,无法判定时必须拒绝;迁移不可变性。
限制:资料未提供具体安装命令、平台、收费或价格信息;该技能不能自动判断何为正确架构,需要所有者决策与人工评审配合。