法规考点学习材料生成
Overview
将一部法规（PDF 或文本）转化为可直接复习的三件套：考点笔记、串讲 PPT、练习题（含答案解析）。核心不是"总结内容"，而是在可溯源的前提下组织可考内容——强制区分法条原文与模型归纳，并为每条关键内容标注条号坐标，使读者能随时翻回原文核验。
When to Use
- 用户上传/引用一部法规 PDF（如《危险化学品安全法》《安全生产法》），要求整理"考点""笔记""重点""复习资料"。
- 用户要求把法规内容做成"PPT 串讲""思维导图式讲解"。
- 用户要求出"练习题/题库/自测题"，且需附答案与法条依据。
- 用户要求把已有的 Markdown 笔记/题解转成排版规范的 Word。
不适用：纯学术理论综述、非法规类的通用文献整理（用其他更合适的流程）。
工作流
0. 环境准备（首次或 venv 缺失时）
先加载随包环境探测脚本（自动定位 Python，跨机器可移植，不写死绝对路径）：
source ./scripts/_env.sh # 定义 WB_PY
WB_PY= 建议解释器，优先skills/.venv（跟随 Skill 目录，换机器自动重建），其次受管 venv，最后系统 python。- 依赖清单（pypdf / python-pptx / python-docx）：若运行报
ModuleNotFoundError，在对应 Python 下执行pip install pypdf python-pptx python-docx。 - 后续脚本均用
"$WB_PY" scripts/xxx.py运行。
1. 来源台账与提取
- 建立来源清单：记录文件名、页数、条数、通过/施行日期、文本层是否完整。无第二份材料时声明不存在多源冲突，不臆造对照。
- 提取文本：
"$WB_PY" scripts/extract_pdf.py <file.pdf> outputs/_raw.txt
- 读取全文，核对有无
[PAGE n 无文本层]（扫描页需 OCR，不得猜）。
2. 来源三级分离（贯穿始终）
严格按 references/source_discipline.md 执行：用【原文】/【考点】/【易混】/推断 区分内容；条号即坐标；不预测考题、不伪造记录、不补造法条授权但未写入的内容。
3. 产出三件套
① 考点笔记（Markdown）
按章节梳理，至少含四张汇总表：监管部门职责对照、罚款/责任梯度总表、数字时限速查、备案事项汇总；附易混点辨析。
② 串讲 PPT（python-pptx，16:9）
- 每部法规写一个 build_xxx.py（属当次产物，不进技能库），from ppt_lib import * 后调用 header/footer/bullets/table/keybox。
- 布局铁律见 references/ppt_layout_guide.md：单文本框多段落防叠行、多列显式传 left/width、底部框下沿 ≤ 6.82in。
- 生成后立即校验，三个计数必须全为 0 才交付：
"$WB_PY" scripts/check_ppt.py outputs/xxx_考点串讲.pptx
③ 练习题 + 答案解析（Markdown）
题型：单选 / 多选 / 判断 / 简答 / 案例分析。每题答案后附条、款、项坐标，便于用户回原文核验。
4. Word 转制（用户要求时）
仅改格式、不动内容与标记：
"$WB_PY" scripts/md_to_docx.py 笔记.md 笔记.docx
"$WB_PY" scripts/md_to_docx.py 练习题.md 练习题.docx
md_to_docx.py 落实：宋体正文 / 黑体标题 / A4 页边距 / 页脚页码 / 表头深蓝斑马纹 / 选择题选项按全角空格自动分行。
5. 交付与说明
- 通过
present_files交付；原 Markdown 与 docx 同列。 - 在交付说明中明确：考点为归纳推断、非预测；若考试只考部分章节或需新旧法对照，请告知范围或提供第二份材料。
Resources
scripts/
extract_pdf.py— PDF 文本层提取，页间以===== PAGE n =====分隔，空页标注无文本层。md_to_docx.py— Markdown→Word，中文字体/表格底纹/页码/选项分行。ppt_lib.py— PPT 布局辅助库（header/footer/bullets/table/keybox）+check_ppt()几何校验（含表格、排除背景块层叠）。check_ppt.py— CLI 封装，对成品 PPT 做越界/真实重叠/脚注侵入终检。
references/
source_discipline.md— 原文/转述/归纳/推断 分离规范、红线、答案依据格式。ppt_layout_guide.md— python-pptx 布局三条铁律、逐页 build 骨架、章节主线建议。
