用途
Subsection Briefs 用于在研究写作流程中，为每个 H3 小节构建写作简报卡片。其目标是让后续的起草工作由证据和可核对的比较轴驱动，而不是由大纲占位符驱动。输出明确要求不含叙述性散文（NO PROSE），只提供小节范围内的计划、比较轴、聚类和过渡句柄。
主要能力
- 从 outline + mapping + paper notes 构建确定性的 H3 简报卡片。
- 输出保持兼容性：维持当前 outline/subsection_briefs.jsonl 的字段契约和段落计划形状，同时将短语/领域逻辑移入 references/ 和 assets/。
- 输出记录包含：身份信息（sub_id、title、section_id、section_title）；规划核心（rq、thesis、scope_rule、axes、bridge_terms、contrast_hook、tension_statement）；证据钩子（evaluation_anchor_minimal、required_evidence_fields、clusters）；执行计划（paragraph_plan、evidence_level_summary、generated_at）。
- 通过 assets/ 中的短语包和领域包管理措辞、领域路由、轴清单、聚类纯度和词汇桥接覆盖。
- 使用 bridge_terms 暴露具体的词汇句柄（如 OOD、sim-to-real、world model、failure detector、特定基准家族），供后续证据/排序阶段匹配。
使用方式
快速使用：运行 scripts/run.py 作为确定性物化器。
快速开始命令：
uv run python .codex/skills/subsection-briefs/scripts/run.py --workspace <workspace>
全部选项：
--workspace <dir> --unit-id <id> --inputs <a;b;...> --outputs <a;b;...> --checkpoint <C*>
示例：
uv run python .codex/skills/subsection-briefs/scripts/run.py --workspace <workspace>
输入：
- outline/outline.yml
- outline/mapping.tsv
- papers/paper_notes.jsonl
- 可选：GOAL.md
- 可选：outline/claim_evidence_matrix.md
输出：
- outline/subsection_briefs.jsonl
加载顺序：
始终阅读 references/overview.md。按任务阅读：如果论点感觉重复或可复制，阅读 references/thesis_patterns.md；如果 tension_statement 过于笼统，阅读 references/tension_patterns.md；如果轴较弱或有领域偏差，阅读 references/axis_catalog_generic.md 和 references/axis_catalog_llm_agents.md；如果过渡句柄平淡，阅读 references/bridge_terms.md；用于校准，阅读 references/examples_good.md。
机器可读资产：
- assets/phrase_packs/thesis_patterns.json
- assets/phrase_packs/bridge_contrast.json
- assets/domain_packs/generic.json
- assets/domain_packs/llm_agents.json
- assets/domain_packs/embodied_ai.json
- assets/domain_packs/rag_evaluation.json
- assets/domain_packs/text_to_image.json
脚本首先加载这些包；当问题涉及措辞、领域路由、轴清单、聚类纯度或词汇桥接覆盖时，应先修补这些包，再更改 Python。
适用场景
- 研究论文写作流程中，需要为每个小节生成结构化写作简报。
- 需要确保后续起草由证据和可核对的比较轴驱动，而非大纲占位符。
- 需要与 transition-weaver、writer-context-pack、subsection-writer 等下游组件保持兼容。
- 需要处理领域包括通用、LLM 智能体、具身 AI、RAG 评估、文本到图像等。
限制
- 不编造论文、引用或主张。
- 不输出面向读者的叙述性散文。
- 当资产包可以容纳领域特定句子模板时，不硬编码。
- 如果 outline、mapping 或 notes 缺失，停止运行。
- 如果证据薄弱，保持 thesis/tension_statement 保守，让下游证据技能强化该小节。
- 如果对比聚类坍缩为重叠的论文池，在写作前重新路由：移除桥接论文后，每一侧仍应保留至少 2 篇独特论文。
- 当映射集已足够大以支持不相交聚类时，优先使用领域包 cluster_rules 而非临时引导重叠。
- 不要通过发明更具体的轴或更强的主张来“修复”薄弱证据。
故障排除
- 如果选择了错误的领域包，在更改脚本之前检查 GOAL.md 和资产包。
- 如果简报听起来太笼统，调整短语/领域包，而不是添加更多 Python 散文。
- 如果 papers/paper_notes.jsonl 内容薄弱，重新路由到笔记提取，而不是发明轴。
执行说明
在兼容模式下，scripts/run.py 当前读取：
- outline/outline.yml 用于章节/小节结构
- outline/mapping.tsv 用于论文到小节的覆盖
- papers/paper_notes.jsonl 用于结构化证据
- GOAL.md 用于主题/领域线索
- outline/claim_evidence_matrix.md 作为可选支持上下文（当存在时）
触发词与路由：subsection briefs、writing cards、intent cards、H3 briefs、scope_rule、axes、clusters、写作意图卡、小节卡片、段落计划。
outline/subsection_briefs.refined.ok 仅在标记比简报、声明的输入、领域包和生成器更新时冻结已审查的简报。在备份重新生成之前，过期的标记会被移除。