用途:确保关于系统的每个事实只存在于一个地方,其他部分都从中读取。该原则优先于便利性。使用时需具备 principal-engineering 技能作为背景。
主要能力与做法:添加数据前先确认谁已拥有它,扩展既有归属者而非另起炉灶;能派生就不存储,若平台或现有来源能在读取时回答,就直接读取,不要复制到第二个来源;顺路吸收重复,遇到代码硬编码文件已知内容(或相反)时把两者合并,而不是留下第三个变体;条目缺失要显式失败,单一来源只有在缺失即错误时才有权威性,绝不能静默取默认值;标注生成物与手工编辑物,绝不要编辑生成输出,每个产物都要说明属于哪种;词汇要有类型,代码分支所依赖的标识符、种类、状态和名称应为常量、枚举、密封类型或注册表条目,拼写两次的自由字符串等于两个来源之间夹着拼写错误;两个来源不一致时要明说,暴露矛盾是第一步修复,完整修复需确定哪个值是活的、合并为一个来源并删除失败者,绝不能静默跟随任一方;在声明为关键路径上,活跃的不一致应直接通知负责人,不能只留一条工单。
边界:当派生自动且陈旧度有界可观测时,缓存和读模型是合法的派生副本;规则禁止的是需要人手工同步的副本。测试夹具可以有意冻结现实副本,fixture 一词就是这种标注。文档遵循同样规则(索引负责路由而非决策),在已安装 technical-writer 插件处由其 technical-writing 技能承担。
常见错误:临时复制阈值、URL 或映射(临时副本与其上 TODO 寿命相同);创建 thing-v2 而非就地编辑;代码中的默认值遮蔽配置文件的值(改配置无效往往因此);两个服务里两个枚举拼写相同状态,一方新增状态时边界会变成静默过滤器。