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 其他：第十三节阶段产物落盘规范（目录树 + 命名 + 留痕纪律）、第十四节评审高频扣分点库。
This commit is contained in:
@@ -0,0 +1,74 @@
|
||||
# 评审高频扣分点与真实失败案例库
|
||||
|
||||
> 本文件是 `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 符号在位）
|
||||
- [ ] 待确认清单状态已更新（未决 / 已决 / 作废）
|
||||
Reference in New Issue
Block a user