Files
STM32F4-Base/docs/代码规范
wandering1 41c277a8ae docs(门禁): 抢跑等价门禁自查表落地——把「谁漏跑一次,这道检查这次就不存在」写死
今天三次 --no-verify 共放过三类真问题:5 条 CODE-RULE-17(.c/.h 配对)、2 个缺尾换行加
1 个漏提文件(HEAD 一度是「代码已整行独占、旁边 runner 文档串还写着无锁直发」)、
以及共享尾段 +80 B 把 iec104Task 压到 1,024 B ISR 底线之下。根因不是「不该抢跑」,
而是**抢跑时只跑了部分等价门禁**——doc-links、id-check、字节卫生都跑了,唯独漏了
stack_report,而它恰恰是数字与安全边界那一类。

§2.4 三组清单(任何人可用,不是 Lead 特权说明):A 抢跑前必跑(stack_report、
ram_report、ram_baseline --gate 含「跳过不等于有余量」、coding-standard、bom-drift
含「别用有 BOM 就是错的外行判据」、mojibake、受影响模块单测、test-coverage、id-check、
doc-links、generated-fresh 必须 .venv、ci_local 并注明它**不含** stack_report 与
ram_baseline 所以不能当替身);B 手跑代替不了真提交的三类(改写型钩子、要靠 stash
才能正确归因的、只有真提交才碰到的 gitlint 与正文每行 80 列);C 抢跑之后:
git show --stat 对交付清单 + git status 里不该再出现声明过的文件(含 ??,漏提 runner
就是这么发现的),并强制在正文点名「哪些没跑、为什么、谁在飞」。

一条结构性说明:stack_report 与 ram_baseline **不在钩子清单里**,所以「人漏跑一次 =
这道检查这次不存在」;要机械化得先解决「磁盘 .htm/.map 属于最后一次构建的那个人」
——与 stash 覆盖面那条同源,不是加一根钩子就完事。另写明 --all-files **也不 stash**,
会让改写型钩子当场改全库,只能在静默窗口跑、跑完复核。

文档里的命令必须能直接跑:只读等价那条一行式刻意纯 ASCII——Windows PowerShell 5.1 按
ANSI 读无 BOM 的 .ps1,带中文标签的版本会碎成 SyntaxError(作者踩过并复现),改完后
从文档里抽出来重跑验证:checked 40 files (incl untracked),problems 0。

同篇顺手核掉的同源不同源(可单独回滚):§6 钩子数 40 → 50(口径 = YAML 解析条目;
直接 grep 声明行会多算一条被注释掉的候选 = 51)、主机侧单测「16 个合一篇」→ 22 根
专属钩子 + 18 套走 test-coverage 总闸;两处跨行断行的表格行修好,全文 8 个表格块
列数一致(脚本核过)。generated-fresh.md §4 补上解释器解析口径与 [ENV] 输出。
2026-10-26 23:42:41 +08:00
..