Files
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

75 lines
4.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 评审高频扣分点与真实失败案例库
> 本文件是 `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 符号在位)
- [ ] 待确认清单状态已更新(未决 / 已决 / 作废)