Official Doc Revise

使用前必做

1. 读取对应 workspace/review/<project-slug>/review.md
2. 按严重级别区分 Must Fix / Should Fix
3. 逐项定位受影响文件
4. 核对 workspace/plan/<project-slug>/facts-ledger.md 中相关事实口径

强制规则

• 优先修复 Must Fix，再处理 Should Fix
• 不得绕过 review 清单直接大改全文
• 不得为了“修完”而补造事实
• 无法确认的事实继续保留 【待补】
• 修订后要同步更新 workspace/plan/progress.md
• 若 Must Fix 包含高优先表图缺失，必须优先补表 / 补图，再回修正文引用
• 若 Must Fix 包含章节配比失衡，必须优先修正章节展开深度，再处理措辞润色
• 若 review 指出“正式稿中的信息比散件文件更空”或“已知事实被回退成 【待补】”，必须优先修复该回退问题，再做其他润色
• 若 review 指出总字数不达标，必须先判断是整体过长还是过短，再按章节轻重规则定向压缩或补足
• 若 review 指出正文存在列表化、加粗小标签或机械过渡词，必须优先改回自然段表述，再进入装配

回修顺序

默认按以下顺序推进：

1. 修标题、编号、固定模板结构错误
2. 修章节配比问题
3. 补高优先表图缺失
4. 修正文与表图引用、术语、数字口径
5. 修台账与进度记录
6. 运行风格检查，确认明显 AI 痕迹已清理

不要一上来就只改文字表述，先解决结构性问题。

典型修订动作

• 标题与编号修订
• 正文与表图引用统一
• 项目名称、单位、负责人、周期、预算等口径统一
• 将 review 指出的空泛段落改成更贴近模板要求的正式表述
• 将缺失说明补回台账，而不是只在对话中说明
• 将列表化正文、加粗小标签和机械过渡词改写为连续自然段

回修优先级

若 review 指出以下问题，应按此顺序修：

1. 标题、编号、章节结构错误
2. 事实与来源等级错误
3. 总字数或章节轻重失衡
4. 缺失表图或装配位置错误
5. 正文与表图引用、术语、数字口径不一致
6. 已知事实被回退成 【待补】
7. 语言、风格、冗余重复问题

风格回修后的检查

正文回修后，优先运行：

powershell -ExecutionPolicy Bypass -File scripts/style_check.ps1 -FilePath <文件路径>

如果脚本仍命中以下项，默认说明回修未完成：

• 正文列表行
• 正文加粗小标签
• 机械过渡词

与 table / figure skill 的协同

如果 review 明确指出某个高优先表图缺失，不要只在 review 文件里标记“待补”：

• 缺高优先表时，应主动调用 official-doc-table
• 缺高优先图时，应主动调用 official-doc-figure
• 表图补齐后，必须回修正文中的引用句、编号和说明文字
• 回修默认以“当前受影响章节”为单位推进：
  • 先修正文
  • 再修本章表图
  • 再修引用、术语和口径
  • 不要在一次回修里顺手扩写多个未计划章节

revise 的职责不是回避补件，而是把 review 发现的问题真正落到文件上。

交付要求

至少说明：

• 已修复哪些问题
• 哪些问题因材料缺失仍保留 【待补】
• 当前是否可以进入 official-doc-assemble

若这些问题来自装配后 final review，还要明确说明：

• 是否需要重新装配
• 哪些修订会直接影响当前 formal-draft

如果仍不能进入 official-doc-assemble，要明确列出剩余阻断项：

• 未修复的 Must Fix
• 未补齐的高优先表图
• 仍失衡的重章节 / 轻章节

交付后动作

• 更新 workspace/plan/progress.md
• 若 Must Fix 已处理完，默认下一步进入 official-doc-assemble