Files
doc-writing-standard/references/review-failure-cases.md
T
snowgitea 14ac1cd768 feat: doc-writing-standard v1.7.0(首次纳入版本控制)
全流程(六阶段):0-A 八类资料登记表 → 0-B 三张清单(涉及/不涉及/待确认)
→ 0-C 模板骨架与逐小节饱满度分档 → 0-D 骨架核对 + 公开渠道补全
→ 0-E 来源三元组 → 分批成文 → 人工审校 → 交付前一致性门禁

正文写作铁律 7.1–7.5:
- 7.1 来源分级 A/B/C(事实 / 编制口径 / 合理推演)
- 7.2 用语正反对照表(禁用「详见第 X 章」「按行业通行做法」「与附件 X 口径一致」等)
- 7.3 扩写两方向(向前找证据 / 向后找影响),不横向注水
- 7.4 饱满度四档:D 一句话 ≤50 字 / C 交代 ≥100 字 / B 论证 ≥200 字 / A 清单(不看字数)
- 7.4.1 三问定档流程、7.4.2 模板小节标题 → 档位速查表、7.4.3《饱满度分档表》为阶段 0-C 强制产出物
- 7.5 成文自检清单(按档位判字数达标)

配套文件:
- references/review-failure-cases.md:梓潼初设 6 例真实评审失败 + docx 落地 6 条技术红线 + 交付前自查清单
- scripts/md2docx.py:md → 宋体(四处字体全设)/ 小四 / 首行缩进 2 字符 / 1.5 倍行距 docx

其他:第十三节阶段产物落盘规范(目录树 + 命名 + 留痕纪律)、第十四节评审高频扣分点库。
2026-09-11 23:31:48 +08:00

4.0 KiB
Raw Blame History

评审高频扣分点与真实失败案例库

本文件是 doc-writing-standard 的配套参考。每次评审被抓后先更新本文件,再回填 SKILL.md 第十四节的汇总表。 更新时间:2026-09-11 · 维护:Jony


一、真实失败案例(全部在项目中被评审/需求方当场抓住)

案例 1:来源级标注缺失(梓潼法院安防初设 · 3.4(3))

  • 原文写法:「无主动监测告警」
  • 问题:未标性质。看似勘察发现,实为编制口径。需求方追问"这话从哪来的",无法当场回答。
  • 定性:B 级(编制口径)被写成了 A 级(事实)。
  • 纠正:回到 7.1 定级,正文改为可溯源的表述或标注编制口径;自检表登记出处。

案例 2:无出处修饰语(梓潼初设 · 3.6)

  • 原文写法:「对照等级保护基本要求」
  • 问题:引用"等级保护基本要求"却给不出具体标准号与版本,属于无真实出处的推断;评审一问即破。
  • 纠正:找到真实现行标准出处(写明标准号+年份)再引用;找不到就删除,改为锚定项目自身已确认口径。

案例 3:交叉引用重复错误(梓潼初设 · 全文)

  • 原文写法:「对应 5.2.3、5.2.2、5.3.2、5.2.2」
  • 问题:5.2.2 重复出现;章节号还会随排版变动而失效,交叉引用必然出错。
  • 纠正:全文检索「详见第」「对应」并清零;章节间对应关系只在《编写依据对照自检表》维护,正文自成一体。

案例 4:冗余指向句(梓潼初设 · 结论段)

  • 原文写法:「与附件三口径一致」
  • 问题:需求方判为"多余"。口径对应关系属于编写层信息,不该进正文。
  • 纠正:删除。口径一致性在自检表维护。

案例 5:引用标准已废止(梓潼初设 · 引用清单)

  • 原文写法GB/T 28181-2016
  • 问题:该标准已被 2022 版代替,编制时未察觉。
  • 纠正:引用标准一律联网核查现行有效性;被代替/废止的必须更正为现行版本并记录核查日期。

案例 6:章节注水(梓潼初设 · 声明型章节)

  • 表现:声明型/占位型章节(如"本项目不涉及此项")被硬撑成整段篇幅。
  • 问题:饱满度与章节职能不匹配,读起来"虚"。
  • 纠正:按 7.4 表降档——声明型一句话+依据即可。

二、docx 落地技术红线(卫健委运维方案项目实战)

转 Word 阶段踩过的坑,与内容无关但会直接导致交付失败:

# 红线 说明
1 非 ASCII 符号经有损编码会直接丢失 曾出现全文 被吞掉只剩双空格(本文档 v1.5.2 即受害),落地前必须逐字符核验
2 Windows 下 python 脚本一律写 .py 文件执行 内联 -c 易踩引号/转义地狱
3 XML 插入锚点不能以 <w:p ...> 开头结尾夹住插入点 会把内容插进段落内部产生非法嵌套 <w:p>;锚点应以 </w:p> 结尾
4 PYTHONUTF8=1 不设会出现编码相关的诡异报错
5 字体四处全设 w:ascii / w:hAnsi / w:eastAsia / w:cs,只设 font.name 会回落成等线/Calibri
6 首行缩进用 Pt(24) 小四 12pt × 2 字符;不要用字符数 API,跨版本不稳

三、扣分点自查速查(交付前逐项过)

  • 每个论断都能回答"这话从哪来的"(A/B/C 已定级)
  • 无「详见第 X 章」「对应 X.X 节」「与附件 X 口径一致」
  • 无「按行业通行做法」「对照 XX 要求」这类无出处修饰语
  • 引用标准均为现行有效版本(已联网核查,记核查日期)
  • C 级推演内容不含数字
  • 同一数字在不同章节取值一致(回数据台账核对)
  • 声明型章节没有注水
  • 正文文件无符号丢失( / 等非 ASCII 符号在位)
  • 待确认清单状态已更新(未决 / 已决 / 作废)