用途
Chapter Briefs（H2 写作卡片）用于研究综述写作流水线中，把每个包含 H3 子节的 H2 章节转化为一张章节级写作卡片。其目标是让最终综述读起来像一篇论文：具备章节导读（chapter lead）与跨 H3 的一致性，同时不膨胀目录（ToC）。该产物属于内部写作意图，不是面向读者的正文（NO PROSE）。
触发词包括：chapter briefs、H2 briefs、chapter lead plan、section intent、章节意图、章节导读、H2 卡片。
适用时机：当 outline/outline.yml 与 outline/subsection_briefs.jsonl 已存在，且希望章节更厚实（更少标题、更多逻辑）时使用。
主要能力
- 为每个含 H3 的 H2 章节生成章节级写作卡片，使写作者能够：添加章节导读段落块（保证连贯性）；在全章保持一致的比较轴；避免“8 个小岛”式的写法，即每个 H3 都从头重启。
- 防止“段落孤岛”失败模式：没有主线时，每个 H3 会重新开始并重复开头。
- 将 throughline 与 lead_paragraph_plan 视为决策约束，而非可直接复制的句子。
输入与输出
输入：
- outline/outline.yml
- outline/subsection_briefs.jsonl
- 可选：GOAL.md
输出：
- outline/chapter_briefs.jsonl
输出格式为 JSONL，每个含 H3 子节的 H2 章节对应一个对象。必填字段：
- section_id、section_title
- subsections（按大纲顺序排列的 {sub_id,title} 列表）
- synthesis_mode（取值之一：clusters、timeline、tradeoff_matrix、case_study、tension_resolution）
- synthesis_preview（1–2 条要点；说明本章将如何跨 H3 综合，避免模板化的“Taken together…”）
- throughline（3–6 条要点）
- key_contrasts（2–6 条要点；在可用时从各 H3 的 contrast_hook 提取）
- lead_paragraph_plan（2–3 条要点；仅为计划，不是正文）
- bridge_terms（5–12 个词元；各 H3 bridge terms 的并集）
每条要点都应针对具体章节，并提及具体抓手（轴 / 对比钩子 / 评估视角）。避免“第 1 段：介绍本章”这类未指明比较对象的通用衔接语。
使用方式
工作流：
- （可选）阅读 GOAL.md 以确定范围/受众，并将该约束注入章节 throughline。
- 阅读 outline/outline.yml，列出含 H3 子节的 H2 章节。
- 阅读 outline/subsection_briefs.jsonl，按 section_id 分组。
- 为每个章节产出：throughline（整章试图比较/解释什么）；key contrasts（跨多个 H3 的 2–6 个对比）；synthesis_mode（在各章之间强制综合方式多样化，避免重复相同的收尾段落形态）；lead paragraph plan（2–3 个段落目标，说明章节导读必须做什么）；bridge_terms 集合（在各 H3 间保持术语稳定）。
- 写入 outline/chapter_briefs.jsonl。
C5 如何使用（章节导读契约）：写作者使用 outline/chapter_briefs.jsonl 起草 sections/S<sec_id>_lead.md（仅正文，无标题）。契约要求（论文式，不引入新事实）：预览本章的比较轴（2–3 个）以及各 H3 如何连接，不要复述目录；复用 key_contrasts / bridge_terms 作为抓手（而非模板），使章节读起来连贯，而不必处处重复“Taken together”；保持有据可依（后续 C5 中至少 2 处引用；此处不要虚构新论文）。
脚本运行：
快速开始： uv run python .codex/skills/chapter-briefs/scripts/run.py --help uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>
全部选项： --workspace <dir> --unit-id <U###> --inputs <semicolon-separated> --outputs <semicolon-separated> --checkpoint <C#>
示例： 默认 IO： uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>
显式 IO： uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace> --inputs "outline/outline.yml;outline/subsection_briefs.jsonl;GOAL.md" --outputs "outline/chapter_briefs.jsonl"
精修标记（推荐；防止反复改动）：当你对章节卡片满意时，创建 outline/chapter_briefs.refined.ok。这是一个明确的“我已审阅/精修”信号：防止脚本重新生成并覆盖你的工作；（在严格运行中）可作为完成信号，避免静默接受引导脚手架。
质量检查清单
- 每个含 H3 的 H2 章节一条记录。
- 无占位符（TODO/…/(placeholder)/模板指令）。
- throughline 与 key_contrasts 针对具体章节（非复制粘贴的通用内容）。
- lead_paragraph_plan 要点明确预览 2–3 个比较轴，以及 H3 子节如何划分它们（无通用章节引言套话）。
适用场景与限制
适用场景：研究综述写作流水线中，需要为 H2 章节生成写作卡片、保证跨 H3 连贯性、避免段落孤岛时。
限制：该产物为内部写作意图，不是面向读者的正文；不引入新事实；此助手为引导脚手架，必要时需手动精修。关于收费、价格、平台等信息，资料中暂未提供。