chore(id-check): 退役全库编号语料审计(钩子 52 → 51)
第三步(用户裁定跳过观察期直接做)。第一步bf2a5c21把两根护栏转报告制, 第二步a5832788立起只查新增行的新门禁,本笔把旧的全库语料审计整体退役: 语义标识已是默认形态,这套 99 族语料不再有人需要维护。 移动(保留可复现性,不再进提交门禁): - scripts/check_ids.py → scripts/archive/id_gate/check_ids.py - id_registry.json(87.6 KB,99 族)/ id_aliases.json(187 KB)/ id_known_backlog.json 一并归档;新写 archive README:为什么退役、现在用什么、怎么手工跑、归档纪律。 - 归档脚本改了自定位(仓库根往上 4 层、语料与脚本同目录)与一行退役横幅; 从新路径实跑:811 文件 / 8,051 字面量,--strict rc=0。 钩子:删 id-check(52 → 51)。现役编号门禁只剩 id-check-new(只查新增行、零语料)。 声明数 51 = commit 阶段 50 + gitlint 1,三数已对齐(AGENTS / 门禁索引 / YAML)。 连带改动: - rename_ids.py 的别名表路径指向归档(改名工具本身没退役); - check_ids_new.py 排除面加 scripts/archive/(语料里全是编号字面量,天经地义); - doc-links 跳过 .mnemon/ 与 ci-artifacts/(本地记忆状态与草稿,非项目文档)—— 语料搬家后这些目录里的旧路径引用会假红,它们本来就不该参与文档门禁; - 全库 .md 里的旧路径引用改指 scripts/archive/id_gate/(含两份 skill 手册); - id-check.md 加退役横幅并保留原文作留档;门禁索引把该行标成已退役; - 编号规范 §8 改成「现行只有一道门禁」+ §8.1~§8.4 标为退役留档 + §8.5 ③ 置已完成; 各加一条 2026-10-28 变更记录行。 验证(实测):YAML 口径 51 个钩子、id-check 不在其中;doc-links --all --sections-strict 通过(194 文档);mojibake / bom-guard / coding-standard / git diff --check 全 rc=0; 新门禁自检 5 正例 + 29 反例仍全过。
This commit is contained in:
+7
-32
@@ -667,40 +667,15 @@ repos:
|
||||
files: ^(scripts/board_ui_nav\.py$|simulator/tests/ref/.*\.bin$)
|
||||
pass_filenames: false
|
||||
|
||||
# 13) 编号门禁(2026-10-20 加,docs/编号规范.md §8 的 8 项校验)
|
||||
# 背景:§1.2 用仓内证据列了 10 类编号事故(同字母多义 / 跨文档同号不同义 /
|
||||
# 销项删行后残留悬空引用 / 自造前缀 / 会话临时号入册…),而 36 个钩子里
|
||||
# **只有 TC 一族**有机械检查(check_test_traceability.py,且未挂钩子、正则还漏 [示例]
|
||||
# `TC-AI-01A` [示例] 这类大写后缀)——E/N/S/B/C/D/A/U/O/gen/Trap 全部裸奔。本钩子把
|
||||
# 规范 §8 的 8 项机械化:配置两份 `scripts/id_registry.json`(前缀 → 属主登记处
|
||||
# /形态/冻结/游标,逐项来自规范 §4 总表)+ `scripts/id_aliases.json`(旧号→新号,
|
||||
# 照搬 section_aliases.json 的成功范式)。
|
||||
# 判据要点:「定义」= 字面量出现在该族**属主登记处文档**里;于是 §5.5 的
|
||||
# 「销项 = 删行 + 清全库引用」只做一半,校验 3 立刻报(销项号被重新取走那类撞号正是这条)。
|
||||
# 盲区显式登记在 registry 的 `blind_spots` / `unmanaged_bare`:裸形同字母多义
|
||||
# (§1.2:P1 五义 / L1 四义 / UI 状态机号四义)与元器件位号同形(§4.4),机械全库判定
|
||||
# 必然一边倒误报 → 裸形族只在属主文档内判越游标、文档外降告警;收口属 §9 阶段
|
||||
# 1-② 的迁移批次。**不是「检查通过」,是记在案上的盲区。**
|
||||
# ⚠ 当前 warn-only(§8 上线节奏:先清 backlog → 清零后 entry 加 --strict 拦提交,
|
||||
# 与 doc-links 章节校验同一条路径)。校验 8 的两根护栏(可判定比例 / 不可判定
|
||||
# 绝对数)**自 2026-10-28 起只报告、不拦提交**(用户裁定,退役路线见规范 §8.5);
|
||||
# 硬拦的只有校验 1~6 的台账外新账。
|
||||
# ⚠ pre-commit 4.x 已移除 `always: true` → files 必须覆盖所有能改编号的触发面
|
||||
# (任意 md/c/h/py/yaml/json/txt + 本配置文件);扫描范围恒为全库
|
||||
# (悬空/孤儿/重复定义是跨文件判定,pass_filenames: false)。
|
||||
- id: id-check
|
||||
name: 编号门禁(docs/编号规范.md §8 八项校验)
|
||||
entry: python scripts/check_ids.py --strict
|
||||
language: system
|
||||
files: \.(md|c|h|py|ya?ml|json|txt)$|^\.pre-commit-config\.yaml$
|
||||
pass_filenames: false
|
||||
# 13) 编号门禁的历史:2026-10-20 起曾有一版「全库语料审计」(规范 §8 的 8 项校验 +
|
||||
# 99 族 registry + 别名表)。它 2026-10-28 退役——维护成本高过收益(近 80 笔提交
|
||||
# 61 笔被编号体系牵连),脚本与语料整体移入 `scripts/archive/id_gate/`
|
||||
# (保留可复现性,**不再进提交门禁**)。退役路线与判据替换见规范 §8.5。
|
||||
|
||||
# 14) 编号门禁·第二步(2026-10-28 加):只查**新增行**,零语料
|
||||
# 背景:语义标识已是默认形态,上面那套 99 族全库语料审计的维护成本高过收益
|
||||
# (近 80 笔提交有 61 笔被编号体系牵连),退役路线见 `docs/编号规范.md` §8.5。
|
||||
# 本钩子是新牙:看 git diff 的新增行里有没有**未登记形态**的「字母+数字」标识
|
||||
# 14) 编号门禁(2026-10-28 起是**唯一**的编号门禁):只查**新增行**,零语料
|
||||
# 背景:语义标识已是默认形态,全库语料审计的成本高过收益(见上条历史)。
|
||||
# 判据:看 git diff 的新增行里有没有**未登记形态**的「字母+数字」标识
|
||||
# (自造前缀直接 FAIL;已停发族只 WARN);白名单在脚本里,按实测普查枚举、几乎不增长。
|
||||
# 与 id-check **双跑**一个观察期(老的是全库语料、新的是新增行),观察后再摘掉老的。
|
||||
# 自检:`python scripts/check_ids_new.py --self-test`;范围自查用 `--range A..B`。
|
||||
- id: id-check-new
|
||||
name: 编号门禁·新增行(零语料,拦截新造编号)
|
||||
|
||||
Reference in New Issue
Block a user