SuperAPI AI 工具集

ssotize

通用与其它

查看项目

更新于 10-24 16:20

技能介绍

ssotize 的目标是落实单一事实来源(SSOT):一个事实只有一个归属地,其他需要它的地方改为引用该归属地,而不是复制。引用不会漂移,副本会。由于该技能会修改产物,因此它刻意谨慎并尽量避免信息丢失。

用途

ssotize 以只读审计开始。它会明确范围内的事实,找出每一处副本,选定规范归属地,并报告确切的整合计划。只有在用户批准该计划后,它才会修改产物。

它可用于建立或修复 SSOT——无论是混乱、遗留还是刚搭建的状态。一旦 SSOT 成立,不要过度使用它:整合是一次性修复,而不是持续维护。当只读检查器和会修改的后续操作已经变成一个不可分割的工作流时,应把检查器并入整合器并保留批准关卡;拆分这种反射只会让更安全的前半部分更容易被跳过。

工作流程

  1. 明确范围内的事实——被追踪的具体事实、值、规格、决策、状态或定义,而不是整个文档。

  2. 先进行只读审计:在给定产物和平台中枚举每一处出现。

  3. 用第二种方法重新枚举——不同的搜索词、同义词或工具——并确认它没有发现第一遍遗漏的出现。

  4. 对每一处出现进行分类:完全副本、改写、部分、过时或矛盾。

  5. 选定规范归属地——最权威、维护最充分、最接近该事实实际变化位置的地方。绝不因为方便就提升一个弱副本;如果不存在规范归属地,就提取一个新的。

  6. 为每个非规范出现决定操作:去重(冗余副本)、引用(文档应链接到规范处,代码应导入/引用/包含它,配置应使用共享读取)或调和(它不一致,需要人工判断)。

  7. 在编辑前报告审计:出现位置表(位置 · 类型 · 操作)、提议的规范归属地及一行理由、必须并入其中的独有细节、需要决策的矛盾,以及确切的修改计划。

  8. 请求明确批准以执行修改计划。如果未获批准,则在只读报告后停止。

  9. 使规范归属地完整且最新——并入只存在于副本中的任何独有细节。绝不因整合而丢失信息。

  10. 先在规范归属地中调和矛盾;当正确值不明确时,在替换任何内容前先确认。

  11. 将每个重复项替换为指向规范归属地的实时引用——对于文档,使用链接、“参见”、带链接的引用,或平台支持时的嵌入;对于代码,使用对共享归属地的导入/引用/包含;对于配置,使用从唯一维护文件进行的共享读取。

  12. 移除现已冗余的副本。如果移除会让读者失去指引,则留下一行指针,而不是直接删除。

规则

  • 如果一次检查没有发现需要整合的散落,则不改变任何内容。
  • 审计阶段是只读的。在用户批准修改计划前,不要编辑、移动或删除。
  • 空的发现列表是有效结果——绝不为了证明整合合理而编造漂移。
  • 将矛盾与普通重复分开;绝不悄悄决定哪个冲突值是“真”的。
  • 标记任何只存在于非规范副本中的细节——在该副本可被删除前,必须将其并入规范归属地。
  • 未经明确确认,不要跨信任/权限边界(私有 → 公开、面向客户 → 内部)进行整合。
  • 以编辑安全方式修改:在触碰每个替换目标前断言其存在(报告 MISS,绝不静默无操作),以 Unicode 安全方式编辑(PYTHONUTF8=1),并逐处操作,绝不笼统扫荡;用语言感知工具或脚本化 AST/解析器编辑进行结构性代码移动,绝不用脚本化文本重写。
  • 注意平台差异:尽可能嵌入,否则链接到读者可跟随的稳定锚点;当平台无法链接回来时,优先使用引用而非硬删除。
  • 当同一项目事实被拆分在只读审计产物和会修改的产物之间,且审计没有独立的持久用途时,将其视为 SSOT 散落:提议把审计并入会修改的产物,然后仅在批准后执行。

验证

完成前:

  • 审计已在修改前报告,并且已获得批准,除非本次运行保持只读。
  • 规范归属地自身包含完整、最新的事实。
  • 每个原副本现在都引用它,且每个引用都能解析。
  • 没有独有细节丢失,也没有任何内容被孤立。
  • 矛盾已调和为一个值,而不是保持重复。
  • 报告整合了什么、规范归属地在哪里、哪些只是被审计,以及哪些仍需要人工决策。