docs(规约): 删除编号规范.md,生效规则并入文档规范 §7.1
用户裁定:docs/编号规范.md 在项目里已无意义,删除。 依据:该文 253 行里真正仍生效的只有两条规则(新条目一律不发编号、 人读文档存量编号继续清退)和一张存量族表;其余内容早有归属——两道 编号门禁的退役记录在 docs/门禁说明/id-check.md 与 id-check-new.md, 手工普查与恢复机器面在 scripts/archive/id_gate/README.md。留着就是 第二真相源,同一事实写在两处迟早漂移。 处理: - docs/文档规范.md 新增 §7.1「条目与编号:一律不发」,承接规则、 场景表、三条硬规矩、存量族表、已停发旧号族清单、不是编号的清单、 清理动作与「没有机器门禁兜底」四段。 - 活跃引用 62 处逐条改指 §7.1 或归档 README:AGENTS.md 2 处、 门禁说明三篇 18 处、其余文档 11 篇、代码与脚本 10 处、rename_maps 七个 record 字段、.dsh/skills 四个文件 8 处。 - 归档区 107 处去掉 docs/ 前缀当纯文本提及;编号治理历史.md 45 处 改为「原编号规范 §N」,避免被 doc-links 当自引用解析。 - 顺带修正 scripts/archive/id_gate/README.md 里仍称旧文为现行规范 的表述。 门禁:check_doc_links --all --sections-strict 220 篇全通过、无法判定 0; pre-commit 全 Passed。
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批 1(2026-10-20 已 --apply)",
|
||||
"applied_by": "scripts/rename_ids.py",
|
||||
"record": "docs/编号规范.md §8.3",
|
||||
"record": "当时的编号规范 §8.3",
|
||||
"note": "映射表即审计轨迹:谁改的、改了什么、作用域多大,全部可复演",
|
||||
"batches": [
|
||||
{
|
||||
@@ -13,7 +13,7 @@
|
||||
"scripts/check_coding_standard.py",
|
||||
"docs/代码规范/pre-commit使用说明.md"
|
||||
],
|
||||
"note": "批 1:代码规范条款号单词化(S1~S19 → CODE-RULE-nn)。原裸形 S 号与登记簿 S-x、UI 像素状态 S0~S7、2026-10-02 复审专项条目 S-x 四义撞形(docs/编号规范.md §1.2)"
|
||||
"note": "批 1:代码规范条款号单词化(S1~S19 → CODE-RULE-nn)。原裸形 S 号与登记簿 S-x、UI 像素状态 S0~S7、2026-10-02 复审专项条目 S-x 四义撞形(当时的编号规范 §1.2)"
|
||||
},
|
||||
{
|
||||
"family": "MENU-STATE",
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批 2(模块码单词化,16 个有歧义的码)",
|
||||
"applied_by": "scripts/rename_ids.py",
|
||||
"record": "docs/编号规范.md §6 模块码表 + §8.3 迁移批次记录",
|
||||
"record": "当时的编号规范 §6 模块码表 + §8.3 迁移批次记录",
|
||||
"note": "字面量已完全限定(TC-<旧码>-<nnn>),故别名全局生效;裸形族才需要 scope",
|
||||
"batches": [
|
||||
{"family": "TC-ADCIN", "old": "\\bTC-AI-(?P<n>[0-9]{1,4}[a-zA-Z]?)\\b", "new": "TC-ADCIN-{n}", "global_alias": true, "files": ["*", "*/*", "*/*/*", "*/*/*/*", "*/*/*/*/*", "*/*/*/*/*/*"], "note": "批 2:模块码 AI → ADCIN(App/algo/adc_input;与 AH 只差一个字母)"},
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批 3-Trap(2026-10-21)",
|
||||
"applied_by": "scripts/rename_ids.py",
|
||||
"record": "docs/编号规范.md §8.3 / §7.1",
|
||||
"record": "当时的编号规范 §8.3 / §7.1",
|
||||
"note": "陷阱号统一为 TRAP-<模块码>-<nn>:数字不变、只补模块码(§7.1)。作用域按文件切分,因为同一空格形在不同文件里指向不同族的属主文档——GD5F 的属主是 GD5F2GQ5UE_Trap_Records.md,README.txt/scripts/README.md 里的 Trap 21/19 指向 CH395F_Trap_Records.md(NET 域),SD2506 的中文形按 §4.2 归 RTC 域。刻意不改:docs/环境与部署/并行任务工作树方案.md:39 的 wip/trap22-fix 是分支名不是编号;docs/UI设计/菜单页面设计.md:501 的「§8.2 陷阱 1」是本文小节内第 1 条(另走平实语言改写);:896 是变更记录行(§8.1 冻结不改写)。",
|
||||
"batches": [
|
||||
{
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批 6(2026-10-21 板级 NET 用例号标注)",
|
||||
"applied_by": "scripts/rename_ids.py",
|
||||
"record": "docs/编号规范.md §8.3",
|
||||
"record": "当时的编号规范 §8.3",
|
||||
"note": "追溯器分档后暴露的真问题:板级 NET 用例的**实现体里标的是裸形**(TC204 / TC-201 / TC1501 / TC1502b…),文档侧写的是合规号 TC-NET-204 等 → 双向追溯对不上,看上去像「文档声明了没实现」,实际是**标注形态烂**。本批只补模块码、序号一位不改(§7.1),作用域限定 5 个真载体文件;改完 @build 验证(改到 test/board 与 Drivers/BSP/CH395F 注释)。刻意不含别的模块(host 侧 TC-00x 那批属另一个模块,另批处理)。",
|
||||
"batches": [
|
||||
{
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批次一 F-* 收口(2026-10-27):网络设计条目号转语义短语",
|
||||
"applied_by": "scripts/rename_ids.py",
|
||||
"record": "docs/编号规范.md §9.1(F-* 行)",
|
||||
"record": "当时的编号规范 §9.1(F-* 行)",
|
||||
"note": "§7 表保留 12 条编号仅作历史对照;正文/代码注释改用「§7 + 条目名」。作用域刻意只列 2 个文件,不写 glob:docs/硬件平台/ 的 T1/T2/T3 位号与 docs/芯片手册/ 的时序记号同属裸形高发区,而各文档 Mermaid 图里有单字母节点名(F/EV/LN…),故 old 一律带上下文、限定完整三段形态。变更记录行(BSD_Socket_API_使用指南.md:1488)由 SKIP_LINE 豁免、不改写(§8.1 历史快照)。",
|
||||
"batches": [
|
||||
{
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schema": 1,
|
||||
"batch": "批次四(2026-10-27 实测清点):复审残号 S-REVIEW + 两条无主死号的残留引用收口(删号留事实)",
|
||||
"applied_by": "scripts/rename_ids.py --no-alias",
|
||||
"record": "docs/编号规范.md §4.1.1(复审残号 S1~S14 / E-xx → 写条目本身)、§4.5、§7.3",
|
||||
"record": "当时的编号规范 §4.1.1(复审残号 S1~S14 / E-xx → 写条目本身)、§4.5、§7.3",
|
||||
"note": "只清「号当标识用」的标注与待办用法;别名表**故意不写**:这些裸形(S1/S4/S5/S7/S9/S11)在 .c/.h 注释、.pre-commit-config.yaml 与在飞的 docs/测试说明/流程与规范/自动化测试流程.md 里还有活引用,写进别名表等于把那些残留一起洗成「已解析」(§4.1.1:部分死号故意不进别名表,好让门禁继续咬残留引用)。刻意不碰:① 属主登记处 docs/任务规划/测试与架构专项.md(§2.1 S12 定义行 + 首行指针;删行销项属 Ask-first);② 变更记录行与「原复审项 S4,已闭环」这类显式历史标注;③ 任何 .c/.h(改注释也要重跑 @build,本批零代码);④ 工作区里别人在飞的脏文件;⑤ 实机测试实施指南.md:5「(S7、A1~A4)」——A1~A4 与本文 A 表(前置检查 A2~A6)同形、语义待属主确认,按 §7.3 第 3 条不猜。",
|
||||
"batches": [
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user