| name | review-and-rewrite-all |
| description | 对全书全部章节（不含前言/致谢/附录）依次进行 review + rewrite 的完整循环。 先调用 review-chapter 审查一章，若任何小节未达到阈值，立即调用 rewrite-section 重写， 重写完成后重新审查确认通过，然后进入下一章。全程不间断，直到全书覆盖完毕。 Use when user says "全量审查重写", "review and rewrite all", "全书review", "从头到尾检查", or uses loop-related terms with review/rewrite.
|
/review-and-rewrite-all
对《从数据到智能》全书全部内容章节进行全量、连续、不间断的审查与重写循环。
运行时：兼容 Claude Code 与 Cursor。工具名对照见 COMPAT.md。
核心原则
一次一章，审查→重写→确认→下一章，不停顿。 这不是"审查完所有章节再重写"，而是"每一章审查发现的问题立即修复"——因为修复后的内容可能影响后续章节的衔接判断。
执行模式
这是一个连续循环，不是一次性批处理。工作方式如下：
Part I 开始
→ Ch 1: 审查 → 发现 3 节未通过 → 重写 3 节 → 确认通过 → Ch 1 完成 ✅
→ Ch 2: 审查 → 发现 2 节未通过 → 重写 2 节 → 确认通过 → Ch 2 完成 ✅
→ Ch 3: 审查 → 全部通过 → 无需重写 → Ch 3 完成 ✅
Part I 完成 🎉 (进度 3/53)
→ Ch 4: 审查 → ...
...
全书完成 🎉 或用户中断
关键行为：
- 一章完成后立即进入下一章，不询问用户是否继续（除非遇到需要用户决策的阻断性问题）
- 每一章的审查结果和重写日志持久保存到
.claude/review-results/ 和 .claude/rewrite-logs/
- 如果会话因 token 限制被截断，下次启动时从
.claude/rewrite-progress.json 读取进度，自动续接
使用方式
/review-and-rewrite-all # 从 Ch 1 开始覆盖全书
/review-and-rewrite-all --from Ch 20 # 从指定章节开始
/review-and-rewrite-all --from Part VII # 从指定 Part 开始
/review-and-rewrite-all --resume # 从上次中断处恢复
/review-and-rewrite-all --dry-run # 只审查不重写，生成全量审查报告
执行流程
Step 0 — 初始化与进度恢复
首次执行：
- 确保输出目录存在：
mkdir -p .claude/review-results .claude/rewrite-logs
- 初始化进度文件
.claude/rewrite-progress.json：
{
"started": "2026-06-22T00:00:00+08:00",
"status": "in_progress",
"mode": "review-and-rewrite",
"strategy": "full-loop",
"target": "Ch 1-Ch 54",
"current_chapter": 1,
"current_part": "Part I",
"completed": [],
"skip_list": ["00-preface", "55-致谢与团队", "appendix-*"],
"stats": {
"chapters_reviewed": 0,
"chapters_passed_first_review": 0,
"sections_reviewed": 0,
"sections_failed": 0,
"sections_rewritten": 0,
"total_rewrites": 0
}
}
续接恢复 (--resume)：
- 读取
.claude/rewrite-progress.json
- 如果
status 为 "completed"，报告"全书完成"并退出
- 如果
status 为 "in_progress"，从 current_chapter 开始继续
- 如果进度文件不存在，提示用户从头开始
Step 1 — 加载当前章内容并审查 (review-chapter 逻辑)
对当前 current_chapter 执行与 review-chapter 技能完全相同的审查流程：
- 读取该章完整内容（必须完整读取，不可摘要）
- 解析所有 H2/H3 节结构（跳过
## :material-school:、## :material-check-circle: 等元数据节）
- 逐节评分：按 D1-D5 五维度（内容深度/图文平衡/叙事逻辑/上下文衔接/实践视角），0–20 分
- 对照核心主旨：检查是否触达 M1-M12 核心母题、是否符合该 Part 的叙事密度要求
- 判定：
- 总分 ≥ 70 且 单项均 ≥ 10 → ✅ 通过
- 否则 → ❌ 需重写
审查输出：为当前章节输出一个简要的审查结果（不需要完整的 Markdown 表格），格式如下：
Ch N 审查结果 (3/5 节通过, 2/5 节需重写)
✅ §N.1 [标题] — 78分 (D1:16 D2:17 D3:15 D4:14 D5:16)
❌ §N.3 [标题] — 48分 (D1:8 D2:10 D3:10 D4:9 D5:11) → 核心问题: 图+表罗列，无深入分析
❌ §N.5 [标题] — 55分 (D1:12 D2:11 D3:10 D4:12 D5:10) → 核心问题: 叙事薄弱，缺少第一人称
✅ §N.2 [标题] — 82分
✅ §N.4 [标题] — 75分
→ 需重写 §N.3, §N.5 — 立即开始
如果该章全部通过：标记该章为 completed，跳至 Step 4。
Step 2 — 重写未通过的小节 (rewrite-section 逻辑)
对每一个未通过的小节，执行与 rewrite-section 技能完全相同的重写流程：
2a 上下文梳理：
- 读取整章 + 前后章首/尾 80-200 行（理解叙事位置）
- 确认该节所在 Part 的叙事密度要求
- 确认该节应触达的核心母题（从 M1-M12 中选 2-3 个最相关的）
2b 知识补充（硬性要求）：
- 至少使用 Context7 查询 2 次（Claude:
mcp__context7__*；Cursor: CallMcpTool → resolve-library-id / query-docs，见 COMPAT.md）
- 至少使用 DeepWiki 查询 1 次（Claude:
mcp__cognitionai_deepwiki__ask_question；Cursor: deepwiki ask_question）
- 查询的技术主题根据该节内容自动确定
2c 执行重写：
- 用
Edit（Claude）或 StrReplace（Cursor）替换目标 H3 节下的内容
- 保持格式约定（AGENT.md）
- 注入第一人称、trade-off 分析、核心母题共振
- 通过"重写后自检清单"8 条检查
2d 同步更新：
- 如有 Mermaid 图变更 → 更新
meta/mermaid-catalog.md
- 如有表格变更 → 更新
meta/table-catalog.md
2e 重写日志：
- 保存重写前后对比到
.claude/rewrite-logs/Ch-N-§X.Y-{timestamp}.md
Step 3 — 重审确认（Re-review）
重写完成后，对该节进行快速重审（不需要完整的五维度打分，只需确认）：
- 是否达到了五个维度的最小标准？
- 是否与核心母题产生了共振？
- 是否注入了第一人称？
快速重审判定：
- ✅ 确认通过 → 该节通过，继续重写下一节
- ❌ 仍需改进 → 再次修改直到通过，但单个节最多重写 3 次：
- 第 1 次重写：标准深度重写
- 第 2 次重写：针对遗留问题聚焦修改
- 第 3 次重写：仍然未通过 → 标记为
⚠️ 让步通过，记录原因，继续前进
- 原因：有些节可能因结构性问题（如该章本身叙事定位为"参考速查"型）不适合注入大量第一人称叙事——强迫重写到完美反而会破坏全书的结构节奏
Step 4 — 章完成与进度推进
该章所有节通过后：
- 更新
.claude/rewrite-progress.json：
- 将
current_chapter 递增到下一章
- 将完成的章添加到
completed 列表
- 更新
stats
- 更新
current_part（如果章号跨越了 Part 边界）
- 运行
uv run mkdocs build --strict（至少每 Part 完成后运行一次，或每 5 章运行一次）
Step 5 — 循环前进
立即加载下一章，回到 Step 1。 不询问用户，不暂停。
唯一的阻断点：
uv run mkdocs build --strict 失败 → 停止并报告，要求用户介入- 连续 5 个章节全部通过无重写 → 报告进度但继续（不是错误）
Step 6 — 全书完成
当 current_chapter 超过 52 时：
- 更新进度文件 status 为
"completed"
- 运行最终
uv run mkdocs build --strict
- 输出全量统计报告
全量统计报告格式（全书完成后）
# 📊 全书审查与重写完成报告
**完成时间**：2026-06-22 ~ 2026-06-2X
**总耗时**：约 XX 小时（实际挂钟时间）
## 总体统计
| 指标 | 数值 |
|---|---|
| 审查章节数 | 50 |
| 审查小节总数 | 247 |
| 首次审查通过数 | 156 (63%) |
| 需重写小节数 | 91 (37%) |
| 重写后通过数 | 88 |
| 让步通过数 | 3 |
| 重写成功率 | 96.7% |
## 各 Part 统计
| Part | 章节数 | 小节数 | 通过 | 重写 | 通过率 |
|---|---|---|---|---|---|
| Part I 起点 | 3 | ... | ... | ... | ... |
| Part II 架构设计 | 8 | ... | ... | ... | ... |
| ... | ... | ... | ... | ... | ... |
## 重写量最大的章节 Top 5
| 章节 | 需重写小节数 | 最高优先级问题 |
|---|---|---|
| ... | ... | ... |
## 让步通过清单
| 章节 | 小节 | 让步原因 |
|---|---|---|
| ... | ... | ... |
进度追踪规范
进度文件 (.claude/rewrite-progress.json) 完整结构
{
"started": "ISO timestamp",
"last_updated": "ISO timestamp",
"status": "in_progress | completed | paused",
"mode": "review-and-rewrite",
"strategy": "full-loop",
"current_chapter": 15,
"current_part": "Part III",
"completed": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14],
"skip_list": [],
"current_chapter_failures": [
{"section": "15.3", "score": 52, "rewrite_attempts": 1, "status": "in_progress"}
],
"stats": {
"chapters_reviewed": 14,
"chapters_passed_first_review": 5,
"sections_reviewed": 68,
"sections_failed": 23,
"sections_rewritten": 20,
"sections_conceded": 0,
"total_rewrite_attempts": 21
},
"part_summaries": {
"Part I": {
"chapters": [1, 2, 3],
"sections_reviewed": 18,
"sections_failed": 3,
"sections_rewritten": 3,
"status": "completed"
}
}
}
Part 边界（自动识别）
| 当前章 | Part | 状态切换点 |
|---|
| Ch 1-3 完成 | Part I → Part II | 打印 "🎉 Part I 完成 (3/53 章, 进度 6%)" |
| Ch 4-11 完成 | Part II → Part III | 打印 "🎉 Part II 完成 (11/53, 21%)" |
| Ch 12-20 完成 | Part III → Part IV | 打印 "🎉 Part III 完成 (20/53, 38%)" |
| Ch 21-30 完成 | Part IV → Part V | 打印 "🎉 Part IV 完成 (30/53, 57%)" |
| Ch 31-34 完成 | Part V → Part VI | 打印 "🎉 Part V 完成 (34/53, 64%)" |
| Ch 35-37 完成 | Part VI → Part VII | 打印 "🎉 Part VI 完成 (37/53, 70%)" |
| Ch 38–49 完成 | Part VII → Part VIII | 打印 "🎉 Part VII 完成 (49/55, 89%)" |
| Ch 50-52 完成 | 全书完成 | 打印 "🎉 全书审查与重写完成！" |
执行纪律
1. 永不自动跳过
即使某章"看起来没问题"，也必须完整阅读和评分的审查流程。不能因为"上次看过感觉没问题"就跳过。
2. 重写质量不可妥协
重写必须满足以下所有条件才算通过：
- 五个维度每项 ≥ 10 分
- 总分 ≥ 70 分
- 至少与 1 个核心母题（M1-M12）产生共振
- 包含至少 1 处 trade-off 分析（适用章节）
- 包含至少 1 处第一人称叙事（适用章节）
- 通过"重写后自检清单"
3. 让步通过必须有书面理由
如果一个小节经过 3 次重写仍不达标，标记为"让步通过"时必须在重写日志中写明：
- 为什么不继续改了？
- 该节的定位是否本质上是"参考速查"型（不适合深度叙事）？
- 如果是，是否应该将该节移入附录？
4. 构建验证不能少
每 Part 完成后运行 uv run mkdocs build --strict。构建失败必须立即处理。
5. 进度文件实时更新
每章完成（Step 4）后立即更新 .claude/rewrite-progress.json。不要攒到"等会儿一起写"——因为会话可能在任何时候被截断，进度文件是恢复的唯一切入点。
会话中断后的恢复
如果会话因 token 限制被截断，用户只需在新的会话中说：
/review-and-rewrite-all --resume
技能将：
- 读取
.claude/rewrite-progress.json
- 检查
status 和 current_chapter
- 如果
current_chapter_failures 非空 → 说明中断时正在重写某个节的中间
- 如果有未完成的重写 → 检查
.claude/rewrite-logs/ 是否已有保存的对比
- 从断点继续执行
注意事项
- 这是大工程：全书约 50 章，预估 200-300 个小节。如果 30% 需要重写，就是 60-90 个小节需要逐节深度重写——每个需要 Context7×2 + DeepWiki×1 + Edit。总 token 消耗可能非常高（数十万到百万级）。
- 用户可在任何时刻中断：虽然本技能设计为"不允许停止中断"的连续循环，但用户始终可以通过取消/中断来控制。进度文件确保中断后可以从断点恢复。
- 附录不审查：appendix-A 到 G 不参与审查流程（它们是参考工具，不是叙事章节）。
- Ch 00 前言和 Ch 55 致谢不审查：前言已精心打磨，致谢是个人的，不适合自动化审查。
- --dry-run 模式：如果用户不确定，建议先
--dry-run 跑一遍全量审查，看看大概有多少节需要重写，评估工作量后再决定是否执行完整 review-and-rewrite。
