用途:当 H2 章节下含多个 H3 小节、草稿读起来像互不相连的段落孤岛时,用该技能生成位于 H2 标题下的纯正文导读块,使整章读起来像一条完整论证。触发词包括 chapter lead writer、section lead writer、H2 lead、lead paragraph、章节导读、章节导语。
主要能力:预览章节的比较视角而非复述大纲;把多个 H3 小节连接为一条论证;以高层级方式保留评估或校准视角;避免幻灯片式叙述、规划者口吻和重复的套话开头;在可能时从 lens-first、sequence-first、comparison-first 等多种候选框架中择优,避免全篇套用同一节奏。
输入:必需 outline/outline.yml、outline/chapter_briefs.jsonl、citations/ref.bib;可选 outline/writer_context_packs.jsonl。输出:每个含 H3 的 H2 章节生成 sections/S<sec_id>_lead.md。输出契约:文件仅含正文、无标题;预览章节视角并把多个 H3 连成一条论证;引用不超出本章既有范围;不添加章节后文未支持的新事实。
使用方式:先确认章节符合条件(从 outline.yml 找出含 H3 的 H2,并在 chapter_briefs.jsonl 中定位对应 brief);再读取 references/overview.md 与 references/lead_block_archetypes.md,按需加载 throughline_patterns.md、bridge_examples.md、bad_narration_examples.md;检查引用范围,若存在 writer_context_packs.jsonl 则用于跨章引用,引用键需对照 ref.bib 校验;最后执行脚本。命令:uv run python .codex/skills/chapter-lead-writer/scripts/run.py --workspace <workspace>。可选参数:--unit-id、--inputs、--outputs、--checkpoint。
限制与阻断:若 chapter_briefs.jsonl 缺失、目标 H2 无 H3 小节、brief 过于不完整无法安全推断主线,或所需导读会引入新事实或越界引用,应停止并转上游处理。writer_context_packs.jsonl 缺失时脚本仍可运行,但引用池更薄。当前 scripts/run.py 处于兼容模式,仍是实际生成逻辑所在;资产 assets/lead_block_contract.json 与 assets/lead_block_compatibility_defaults.json 为契约与兼容措辞来源。若生成导读仍有叙述感,应先修改兼容资产与 references,而非改 Python。该包处于 P0 兼容性保留迁移中,后续脚本精简计划暂未提供具体时间。