辩论skill —— 全辩位总入口（debate）
辩论赛备赛产物的统一入口。核心是按辩位路由 + 共用一套脚本流水线。
一、何时使用
- 「帮我准备 X 这个辩题」「给我一套完整辩论稿」「我是二辩，要一份东西」
- 用户给出辩题（+可选：一辩稿、赛制、立场、辩位、模型）
二、开工前必问（缺哪件问哪件）
| 项 | 说明 |
|---|---|
| 辩题 | 必填 |
| 辩位 | 一辩/二辩/三辩/四辩 —— 决定路由到哪个模块与产出什么 |
| 立场 | 正方 / 反方 |
| 赛制 | 必须选定（本技能内置「天问杯2026新赛制」与「通用四人制模板」） |
| 一辩稿 | 二/三/四辩必填；一辩场景无需输入，由脚本生成后用户修订 |
| 模型 | 必须由用户指定，无默认值 |
| 篇幅档位 | --depth training/official，默认 official（正式比赛）。训练赛≤5000字 / 正式比赛6000-9000字 |
三、辩位路由表（核心）
| 辩位 | 模块 | ③ 主产物 | ④ 次产物 | ⑤ |
|---|---|---|---|---|
| 一辩 | references/辩位模块/debate-first.md |
一辩立论稿（950–1050字/3:00） | 四盘一应对预案（6–8条，20秒/答） | 自由辩速查（守定义/判准） |
| 二辩 | references/辩位模块/debate-second.md |
二辩申论稿（950–1050字/3:00，含总结四盘一） | 四盘一总结（240–280字≈1分钟） | 自由辩速查（承接/反击/补强） |
| 三辩 | references/辩位模块/debate-third.md |
三辩质询问题清单（按对方辩位分组+★万能追加） | 三辩质询小结稿（约350字/1:30） | 质询复盘速查（追打回避点） |
| 四辩 | references/辩位模块/debate-fourth.md |
四辩四盘一盘问清单（5问，层层递进） | 四辩总结陈词稿（1600–1750字/3:30） | 自由辩速查（价值收束） |
> ①② 部分（辩题思考与论证思路、论据与数据）四辩位通用，内容一致。
赛制红线（别搞错）
- 三辩不做申论（只做二轮质询 + 质询小结）
- 二辩不做质询（一辩的驳论交给二辩，所以二辩须「总结四盘一」）
- 四辩不做质询（做四盘一盘问 + 总结陈词）
- 一辩不做质询、不做陈词（立论 + 被盘问）
四、底层脚本（四模块共用，不复制）
全部在 debate-case-builder/scripts/：
| 脚本 | 作用 |
|---|---|
run_pipeline.py |
一键全流程（推荐入口） |
debate_gen.py |
分 5 段生成（按 --speaker 自动分叉 ③④⑤） |
evidence_search.py |
Tavily 联网核证论据数据 |
verify_claims.py |
number + unit + evidence_id + claim context 数字绑定 + 证据标签校验 |
mindmap_render.py |
生成思维导图 PNG |
md2docx.py |
出正式版 Word |
trim_report.py |
按档位压缩（注意：模型常拒绝压缩，优先生成时写准） |
preflight.py |
一辩稿↔辩题相符性校验 |
paths.py |
解析真实桌面路径 |
五、一键跑法
python "<SKILL_DIR>\scripts\run_pipeline.py" \
--topic "<辩题>" \
--side 正方 \
--speaker 三辩 \ # 一辩/二辩/三辩/四辩 —— 自动决定 ③④⑤ 产出
--competition "天问杯2026新赛制" \
--model <模型ID> \
--speech-one "<一辩稿.md>" \
--depth official \ # training(训练赛≤5000) / official(正式比赛6000-9000，默认)
--confirmed
> 注意：<SKILL_DIR> 指向 `本包根目录（脚本在 scripts/）。
六、产出（固定五部分深度报告 → Word）
| 部分 | 内容 |
|---|---|
| ① | 辩题思考与论证思路（含思维导图） |
| ② | 论据与数据（逐条带来源机构与链接） |
| ③ | 辩位主产物（见路由表） |
| ④ | 辩位次产物（见路由表） |
| ⑤ | 速查卡 + 万能句（按辩位定制） |
七、篇幅档位（两档，以 5000 字为界）
| 档位 | 参数 | 全文 | 适用 |
|---|---|---|---|
| 训练赛 | --depth training |
≤5000 字 | 日常训练、快速过稿 |
| 正式比赛（默认） | --depth official |
6000–9000 字 | 正式上场备赛 |
> 旧参数名仍可用（simple→训练赛、standard/deep→正式比赛），但建议用新名。
> ⚠️ 辩位稿字数不随档位缩放——由赛制时长锁死（3:00≈1000字，3:30≈1670字，1:30≈350字）。
> 冗余只加在其余部分。
八、质量红线（不可跳）
- 论据必须核证：至少 4 条去重可用证据、其中至少 2 条权威来源；黑名单/未知来源不计数
- 数字绑定校验：终稿重要数字必须同时匹配数值、单位、evidence_id 与事实语境
- 辩位稿字数达标：超了上台念不完
- 语义标签不得伪造：缺立场/类型时定向重生成；仍缺即拒绝交付
- 人工核对：篇幅 / 无重复错位段落 / 引文是否准确呈现原始材料
九、详细规则
完整流程、踩坑记录、验证清单、赛制细节、风格指南：
见 debate-case-builder（本技能族的规则母本）。
十、语料库
语料库位于 debate-case-builder/references/语料库/（队内 232+ 篇稿件），
仅作结构与文风参考，不参与论据核证。自建：
python "<SKILL_DIR>\scripts\build_corpus.py" --run --rotate --per-tag 15 --cap 60
