| name | document-qa |
| description | 对已成稿的中文公文做结构与质量校验。Use when the user wants to check/review/lint a 公文 draft——校验章节是否齐全、标题层级是否跳级或混编、篇幅与标题深度是否匹配、一是/二是 是否被误用为正式标题、文种是否用对、结尾用语是否匹配、有无未经提供的事实。是「检查」而非「起草」。 |
公文质检
对已成稿的中文公文做结构与质量校验。和「起草」相反方向：不生成内容，只检查稿子哪里不齐、哪里不规范。
文件索引
src/scripts/check_sections.py # 章节齐全度 + 层级结构 + 篇幅自动校验（CLI）
docs/references/style-rules.md # 「质量检查清单」与行文规范（人工核对项）
prompts/core/doc-type-guardrails.md # 防编造强制约束（事实性核对的依据）
prompts/doc-types/<id>-<文种>/spec.md # 各文种应有板块与职责（结构核对依据）
自动校验（脚本）
src/scripts/check_sections.py 覆盖全部 22 个文种（与 assets/templates/ 下 22 份文种模板一一对应），自动检查：
- 章节齐全度：缺少约定板块直接报错。
- 层级结构：标题跳级、
一是/二是/三是 被当正式标题、10 页以内却下钻到三级标题等给出提醒。
- 内容机检：占位符残留、结尾用语是否与文种匹配。
- 格式红线（GB/T 9704）：发文字号是否用六角括号〔〕且不加「第」不补零、成文日期月日是否补零、标题是否误加句号、是否残留「主题词」。
- 0 幻觉审计（
--strict-facts）：列出成稿里非占位的具体值（文号/日期/百分比/金额/数量），供逐项核对来源——把「不编造」从口号变成可核对清单；提示性、不影响退出码。
--strict-structure 把结构提醒按错误处理。
python3 src/scripts/check_sections.py notice 成稿.md
python3 src/scripts/check_sections.py report 成稿.md --strict-structure
python3 src/scripts/check_sections.py report 成稿.md --strict-facts
人工核对（清单）
脚本覆盖不到的语义项，按 docs/references/style-rules.md 的「质量检查清单」逐条核对：
- 文种是否正确、行文方向是否合理
- 标题是否单一聚焦、有无不必要标点或回行不当
- 段落层级是否清楚、结尾用语是否匹配文种
- 落款和日期是否齐全、日期书写是否规范
- 是否出现未经用户提供的事实、数据、依据（对照
prompts/core/doc-type-guardrails.md）
默认流程
- 判断稿子文种 → 先跑
check_sections.py <文种> 成稿.md 拿结构结论（22 个文种均覆盖）。
- 再加
--strict-facts 跑一遍 0 幻觉审计，拿到「非占位具体值」清单，逐项核对是否有可核实来源（无来源的应改占位或标「待核实」）。
- 再按「质量检查清单」做语义核对。
- 输出「缺什么板块 / 哪里结构不规范 / 哪些具体值疑似无依据」，并指明对应主源规则。
- 只报问题与依据，不擅自改写；需要修订时交回「公文写作」skill。
边界
- 脚本覆盖全部 22 个文种的必备章节，但只校验结构、不判断语义；内容是否成立仍需人工核对清单。
REQUIRED_SECTIONS 只收必备板块，（可选） 板块（附件、附注等）不计；章节名以模板主源 spec.md 为准，若脚本与模板脱节，以 spec.md 为准并视为脚本待补项（tests/test_template_sections.py 守护两者同步）。
