跳转至

编号与命名一致性审计报告

审计日期:2026-06-09
审计范围:全书 30 个工作流章节(01-30)+ 索引/导航/状态文件
结论:已发现并修复全部编号碰撞、H1 标题错配、旧占位残留


1. 审计范围

维度 检查内容
文件名编号 vs H1 标题编号 01-30 每章正文 H1 中"工作流 XX"是否与文件名一致
文件名编号 vs 全书索引 00-workflow-map.md 索引编号是否与文件名一致、连续、唯一
文件名编号 vs 导航 mkdocs.yml 导航链接是否指向正确文件
文件名编号 vs 数据文件 data/workflows.yaml 的 chapter 字段是否匹配
README 命名 提示词命名、章节结构是否与正文一致
final-review.md 结论是否与真实状态一致
岗位索引 / 阅读路径 是否引用了错误编号
旧占位 / 待生产 是否仍有旧规划残留

2. 权威编号来源

经判断,本项目权威编号来源为 文件名编号,理由:

  1. 文件名编号(如 02-project-management.md)是 MkDocs 路由与物理事实,改动代价最高、最不应轻易变更;
  2. data/workflows.yaml 的编号规划与文件名编号完全一致,互相印证;
  3. mkdocs.yml 导航顺序也与文件名编号一致。

因此采用最小破坏原则:保持文件名不变,修正正文 H1 标题编号、索引页、README 描述,使其全部对齐文件名编号。不重命名任何章节文件,不重排 01-30 文件编号。


3. 发现的问题清单

问题 A:正文 H1 标题编号与文件名不一致(7 处)

文件 修复前 H1 修复后 H1
02-project-management.md 工作流 09:从混乱需求… 工作流 02:从混乱需求…
03-union-activity.md 工作流 26:从活动素材… 工作流 03:从活动素材…
26-teacher-lesson-prep.md (无编号)从教学主题… 工作流 26:从教学主题…
27-student-learning.md (无编号)从知识点… 工作流 27:从知识点…
28-personal-knowledge.md (无编号)从文章笔记… 工作流 28:从文章笔记…
29-personal-review.md (无编号)从日记周报… 工作流 29:从日记周报…
30-personal-task-management.md (无编号)从零散待办… 工作流 30:从零散待办…

影响文件:上述 7 个章节。01、04-25 的 H1 编号本就正确,未改动。

问题 B:00-workflow-map.md 编号碰撞

  • 编号 02 在文件中出现两次:第一章一行(错误地挂"短剧提案(精简版)"名)+ 第三章一行(正确,项目管理)。
  • 编号 03(工会宣传)被旧占位"角色设定(扩展版)"顶替,真实工作流在索引中缺失。

影响文件:00-workflow-map.md。

问题 C:旧占位与旧规划残留

残留项 位置 处理
02 从关键词到短剧提案(精简版) 00 第一章 已删除
03 从故事文本到角色完整设定(扩展版) 00 第一章 已删除
第七章:知识管理(已合并到第五章) 00 末尾 已删除
"其余为规划中" / "待生产" 00 岗位索引说明 已删除

影响文件:00-workflow-map.md。

问题 D:岗位索引错配

岗位 修复前 修复后
活动宣传人员 07、10、26 03、16、17
工会干部 26 03、17、16

影响文件:00-workflow-map.md。

问题 E:推荐阅读路径错配

路径 修复前 修复后
新手入门 01 → 09 → 15 01 → 16 → 17
内容创作者 01 → 02 → 05 → 06 01 → 04 → 05 → 06
职场效率 15 → 14 → 16 → 28 16 → 17 → 18 → 19 → 20
技术开发者 10 → 11 → 12 → 13 11 → 12 → 13 → 14 → 15

影响文件:00-workflow-map.md。

问题 F:README 命名与结构过时

修复前 修复后
提示词命名 基础/进阶/审查/修正提示词 A 快速生成 / B 专家增强 / C 自查审稿 / D 返修优化
C/D 说明 补充"C/D 是同一节点内部工作模式,不是新角色"
内容结构 旧八章分法(与正文不符) 按编号浏览 + 按专题浏览

影响文件:README.md。


4. 修复策略

  1. H1 标题:按文件名编号,仅修改每章第 1 行 H1,不动正文其他内容。
  2. 00 索引:重写为四层结构 —— 全书编号索引(01-30 连续唯一)、专题分类索引、按岗位索引、推荐阅读路径。仅"全书编号索引"要求编号唯一,其余允许重复引用。
  3. README:仅同步提示词命名与内容结构,不重写整篇。
  4. 状态文件:在 PROJECT_STATE.md 记录权威编号来源;final-review.md 补充本次修复记录。

5. 修复后结果

检查项 结果
01-30 文件全部存在
01-30 文件名编号 = H1 标题编号 ✅ 全部一致
00 全书编号索引 01-30 连续且唯一
编号碰撞(02 重复) ✅ 已消除
旧占位(精简版/扩展版) ✅ 已删除
旧残留(第七章已合并、待生产) ✅ 已删除
岗位索引错配 ✅ 已修复
阅读路径错配 ✅ 已修复
README 提示词命名 ✅ 已统一为 A/B/C/D
mkdocs build --strict ✅ 通过(见 final-review.md)