编号与命名一致性审计报告¶
审计日期: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. 权威编号来源¶
经判断,本项目权威编号来源为 文件名编号,理由:
- 文件名编号(如
02-project-management.md)是 MkDocs 路由与物理事实,改动代价最高、最不应轻易变更; data/workflows.yaml的编号规划与文件名编号完全一致,互相印证;- 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. 修复策略¶
- H1 标题:按文件名编号,仅修改每章第 1 行 H1,不动正文其他内容。
- 00 索引:重写为四层结构 —— 全书编号索引(01-30 连续唯一)、专题分类索引、按岗位索引、推荐阅读路径。仅"全书编号索引"要求编号唯一,其余允许重复引用。
- README:仅同步提示词命名与内容结构,不重写整篇。
- 状态文件:在 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) |