docs(v2): YAO-144 全书重排 — 34 章 NN 对齐 §5 + 目录前言重写

[luyao618]

Summary

把 v1 26 文件 + 8 篇新章按 V2-REVISION-SPEC §5 的 8 篇 / 34 章顺序统一重排 NN 槽位（C04→04、C13→13、C17→17、C24→24、C25→25、C28→28、C29→29、C30→30）。NN 不再被"写作时序"绑住，而是直接对应 §5 章节顺序——读者翻开任意 NN 文件就是 §5 表里的那一章。

也就是说，v2 的 8 篇骨架从「spec 上的目标」变成了「main 上的现实」。

同步改造

• 34 个 H1 全部替换为「第 N 章：xxx — yyy」（按 v2 编号）
• 33 个章末「下一章预告」 全部重写，指向新文件、新标题、新预告文案
• 所有正文交叉链接 更新为新文件名（grep 二次验证：0 残留）
• 00-目录与阅读指引.md 完整重写，按 §5 8 篇骨架排列 34 章，附录 A–F 单列，新增「远程与企业路线（5 章）」阅读路线
• V2-REVISION-SPEC.md §9.3.1 落地文件名表更新（YAO-144 备注）
• scripts/check-code-ratio.ts 的 NEW_CHAPTER_FILES 同步
• 清理三个临时调研文件（QUICK_REFERENCE.txt / stop_hook_payload_analysis.md / STOP_HOOK_PAYLOAD_VERIFICATION.md）

顺带解决的历史问题

问题	解决
C12/C13 都落在 NN=27 前缀冲突	C12→12、C13→13
C29 命名 spec 写「人格」实际「宠物」	文件名对齐为 docs/29-Buddy人格.md
v1-00 目录前言未按 §6.1 更新	重写为 v2 8 篇骨架前言
docs/ 混入 3 个 untracked 调研文件	删除

Test plan

• bun run check:no-frontmatter ✅ 34/34 章节无 frontmatter
• bun run check:code-ratio ✅ 8 个新章源码占比 11.6%–24.9%，全部 < 25%
• bun run check:section-titles ✅
• grep 验证正文里无旧文件名残留链接（0 hit）
• git 重命名识别率 97–99%，history 保留
• reviewer 抽样阅读 3 章，确认 H1 / 预告 / 链接三件套一致

注意

• 本 PR 是纯组织重排 + 元数据同步，不动任何 v1 文章正文叙事——按 §0.5.3 最小修改原则。
• 章节内 H1 与下一章预告属于"指向性元数据"，重排时必须同步更新，不属于 §0.5.3 禁止的"文风改写"。
• C12 在本次重排前以 docs/27-文件-代码-与-LSP-协作族.md 落地（与 C13 NN 冲突），现重排为 docs/12-文件-代码-与-LSP-协作族.md，回归 §5 章序。

🤖 Generated with Claude Code