四好农村路证明材料生成（通用模板 · 数据层外置）
把某地区"四好农村路"考核指标的判断题，变成结论明确、每一段都能溯源到
原文件特定页码 的 Word 证明材料（黑体标题 + 仿宋正文，严格三段总分总）。
本 skill 是可复用的通用模板：不绑定任何区县，数据层完全由用户提供。
〇、首次使用引导（每次触发先走这里）
技能被触发时（用户首次提到"想生成四好农村路说明文档 / 证明材料"等），不要直接动手，
先按以下流程与用户达成共识，再进入正式生成：
-
提示技能存在：先告知用户——
> 检测到你想生成"四好农村路"相关证明材料。我这里有一个「四好农村路证明材料」技能，
> 能把考核判断题转成结论明确、每段可溯源到原文件特定页码的 Word 文档。需要我帮你用吗？
并说明：数据层（材料、材料库、指标数据）由用户提供，技能会自动搭建工作区、读取并处理材料。 -
取得许可后再建文件夹：用户明确同意后，再询问工作区放哪（给默认建议路径，
如E:\某区四好农村路），确认后运行init_workspace.py自动建好
materials/ evidence/ output/与_skill_config.json骨架。未经许可绝不自动创建任何目录或文件。 -
引导提交材料：打印下方"材料类型清单"，请用户把对应证明材料放进
materials/。
说明接受 PDF / Word / Markdown / 图片；低清扫描件（文字层为空）需同时提供官网 HTML 原文，
避免 OCR 不可用导致伪造证据。 -
自动登记数据层：用户放好材料后，读取
materials/转录为evidence/materials.json
（逐份登记material_index、发文机关、日期、文号、可证明的指标doc_code列表），
并把_skill_config.json的region（地区名）、doc_title（文档标题）、indicators（实际指标清单）填上。 -
之后走正式生成流程（见第四、五节：pre_check → validate → build）。
详细初始化步骤见「三、首次使用：初始化数据层」。
一、适用判断
同时满足以下三点才走本流程：
- 对象是某地区"四好农村路"相关事项（地区由用户提供的数据层决定，不写死）；
- 是判断题：是否纳入规划 / 是否建立机制 / 是否落实保障 / 是否达到比例 / 是否获得称号；
- 需要产出文字佐证 / 证明材料（Word）。
不问评分规则本身、不做纯排版/数据分析、不写 PPT、不回答其他区县未提供数据的事项。
二、数据层结构（自动搭建）
首次使用前，先在工作区初始化（见第三节"首次使用：初始化数据层"）。初始化后目录如下，数据层与成果层分处不同子文件夹：
<workspace>/
materials/ 用户提交的原始材料（数据层·原料） ← 与成果分离
evidence/ 材料库 materials.json + 指标数据 evidence.json + 知识库索引（数据层·加工）
output/ 生成的 {doc_code} 说明.docx（成果层）
_skill_config.json 项目配置（标题、指标清单等）
三、首次使用：初始化数据层
- 询问用户：工作区放在哪（绝对路径）？确认后运行：
bash
python -X utf8 "<skill>/scripts/init_workspace.py" --workspace "E:\某区四好农村路"
脚本自动建好 materials/ evidence/ output/，并写入 _skill_config.json 骨架与
materials/材料提交说明.txt。
-
提示用户提交何种类型的文件（见下方清单），请用户把材料放进
materials/。 -
用户提交后，读取
materials/下的文件，转录为evidence/materials.json
（逐份登记：material_index全局编号、doc_name、issuer、date、doc_no/note_no、
以及该材料可证明的指标doc_code列表）。同时把_skill_config.json的indicators
填成用户实际的指标清单、doc_title填成文档标题、region填成地区名。
材料类型清单（应提示用户提交）
按指标性质分三类，缺哪类就会卡住哪类指标：
- 规划类 —— 证明"是否纳入规划"
- 国民经济和社会发展规划纲要（如"十四五"规划纲要）
- 综合交通运输发展规划 / 高水平交通强区实施方案
- 农村公路网布局规划
- 体制机制 / 管理办法类 —— 证明"是否建立机制 / 落实保障"
- 农村公路养护与管理办法
- 路长制 / 三级路长制文件
- 交通运输发展专项资金管理办法及政策解读
- 实绩 / 达标类 —— 证明"是否达到比例 / 获得称号"
- 年度交通工作总结、四好农村路年度部署文字
- 统计台账、比例表、完工/验收通报（须为盖章正式表，内部梳理稿不可单独作佐证）
- "四好农村路"示范县/示范区称号文件、新闻报道（仅作补充，不顶替规划或建成证明）
文件格式：PDF、Word（.docx/.doc）、Markdown（.md）、图片。低清扫描件（文字层为空）请同时
提供官网 HTML 原文，避免 OCR 不可用导致伪造证据。
> 现成示例：本 skill 自带 samples/wucheng/（金华市婺城区完整数据层）。
> 需要婺城区数据时，把 samples/wucheng/ 整个目录复制为用户的工作区即可直接复用。
四、生成流程
对每一个要生成的指标，依次走完：
Step 1 · 判定结论（最高优先：安全红线）
- 是否纳入规划 / 是否建立机制 / 是否落实保障：属"打算做/已部署"类，用规划、办法、
实施方案原文佐证；结论"是"。 - 是否实际建成 / 达标 / 获得称号：属"已发生事实"类，必须用统计台账、完工通报、验收材料、
现状数据佐证。红线：规划目标（"到2035年达100%"）不能证明"现已建成"，否则判"否"。 - 找不到有效佐证 → 结论"否"，并在
no_proof_note写明缺什么、需补什么口径。
两种作答模式（见 references/format-spec.md）：
- 是否类（默认）：题干行带
☑是 □否/□是 ☑否，编号加粗。 - 比例数字类：
evidence条目加"answer_type": "ratio"，首行为编号加粗 + 数据直陈句，
无勾选框；缺证子项在score_statement与no_proof_note中点明，并在回复中另起一段提示。
Step 2 · 填写 evidence.json 条目
字段与模板见 assets/evidence_entry.template.json。核心字段：
doc_code / conclusion / lead（总领） / materials[]（引用+pages） / summary_end（总结）。
比例类用 answer_type: ratio + score_statement。完整字段纪律见 references/writing-rules.md。
Step 3 · 前置检查（环境 + 数据就绪）
python -X utf8 "<skill>/scripts/pre_check.py" --workspace "E:\某区四好农村路"
不通过就中止——环境问题不解决，生成的文档也是错的。
Step 4 · 校验指标数据（人与脚本分工）
python -X utf8 "<skill>/scripts/validate_evidence.py" --workspace "E:\某区四好农村路" --only 1.1.1
- ERROR（编号缺失、字段缺
lead/summary_end、比例类无score_statement）→ 退出码 2，阻断生成； - WARN（页码/文号需人工核实）→ 只提示，绝不自动改写数据。
Step 5 · 生成 Word 文档
python -X utf8 "<skill>/scripts/build_evidence_docx.py" --workspace "E:\某区四好农村路" --only 1.1.1
向 <workspace>/output/ 写出 {doc_code} 说明.docx。日常一律带 --only，避免覆盖已润色文档。
五、红线纪律（引用历史坑位，详见 references/pitfalls.md）
- 页码核对三步法：定位章节标题 → 查目录页码 → 确认该页码确实归属该章节，非相邻附表/附图；
.md目录页码不一定等于 PDF 物理页码。 - 低清扫描件不可 OCR 时，取官网 HTML 原文转录，不要生成"看似合理"的正文。
- 内部梳理稿（含"说明/核心结论"主观段、无文号、署期矛盾）不可单独作佐证。
- 文号含
*占位原样保留，不要编造。 - 实际建设类严禁用规划顶替建成证明。
- 结论"否"时不生成材料段与注释段，仅在回复中告知材料缺失。
六、参考资料索引
references/writing-rules.md—— 四条写作纪律（比例类先直陈、禁侧面证明、缺证必提示、总领禁套话）references/format-spec.md—— Word 版式规范（字体/三段/注释/落款）references/pitfalls.md—— 历史坑位与核对方法assets/evidence_entry.template.json—— 单指标字段骨架（三类）samples/wucheng/—— 金华市婺城区完整可运行示例（数据层 + 评估用例）
