ssotchk

找出单一事实存在的所有位置，指出它应有的归属，并报告偏差——不做任何更改。

目标

定位单一事实来源（SSOT）违规：同一事实在不同制品或平台中被重复、转述或相互矛盾。一个事实有 N 份副本，就有 N-1 份潜在负担，因为副本会逐渐失去同步。输出是一份映射——事实所在位置、哪份副本应为规范版本，以及其他副本应如何处理——供 ssotize 或人工执行。这是只读操作。

在需要理顺多个制品，尤其是混乱或遗留状态时使用此方法；一旦某项事实已清晰地归于单一来源，就需要维护，而不是再次整合。

工作流

1. 明确范围内的事实——要跟踪的具体事实、值、规范、决策、状态或定义，而非整份文档。
2. 列出给定制品和平台中的每一处出现。
3. 对每处进行分类：完全相同的副本、转述、部分内容、过时内容或相互矛盾。
4. 选定规范归属位置——权威性最高、维护最频繁且最接近事实实际变更之处（值对应代码/配置，决策对应规范，状态对应工单）；绝不可随意决定。
5. 为每处非规范内容确定处理方式：去重（冗余副本）、引用（文档应链接到规范来源，代码应导入/读取/包含规范来源，配置应通过共享读取方式使用规范来源），或 协调（内容不一致——需要人工判断何者正确）。
6. 报告：一张列出各处内容的表格（位置 · 类型 · 处理方式）、附有一句理由的建议规范归属位置，以及需要决策的矛盾/偏差单独列表。

规则

• 只读。提出建议；不要编辑、移动或删除。
• 结果列表为空也完全有效——绝不可为了填满报告而捏造偏差。
• 将矛盾与普通重复分开；绝不可暗中认定哪一个冲突值才是“正确”的。
• 标记仅存在于非规范副本中的任何细节——删除该副本前，必须先将这些细节纳入规范归属位置。
• 尊重边界：如果副本跨越信任/权限范围（私有与公开、内部与面向客户），必须指出，不能忽略。
• 考虑平台差异：有些位置支持嵌入引用，有些只能链接，有些则需要附上引文和链接。

验证

完成前：

1. 用第二种方法重新列举——采用不同的搜索词、同义词或工具——并确认没有遗漏报告中未包含的内容。完整性是 SSOT 的核心风险：你没找到的副本，终将失去同步。
2. 规范归属位置必须有理有据，不能想当然。
3. 报告必须可执行：人工或 ssotize 无须重新发现任何内容，就能据此采取行动。