Subsection Writer（兼容路由）用于在综述写作流水线中按小节撰写或精修正文，输出到 sections/ 目录，保持当前流水线契约不变。
用途 当 Approve C2 已记录且 writer packs 存在（outline/writer_context_packs.jsonl）时使用，实现受证据约束的逐节起草，避免单体式一次性草稿。触发词：subsection writer、per-section writing、split sections、sections/、分小节写、按章节拆分写作。
主要能力
- 将综述正文写入 sections/S<sub_id>.md（H3 正文）。
- 刷新 sections/sections_manifest.jsonl，覆盖三个 writer 技能已产出的所有小节文件。
- 在模型或人工审阅生成的 H3 正文后，生成 sections/h3_bodies.refined.ok，提交 U100 强制验收。
- 兼容模式：输出路径不变；scripts/run.py 仍处理审批检查、缺失文件引导与 manifest；写作指导位于 references/ 而非主要编码在脚本中。
使用方式 加载顺序：始终阅读 references/overview.md、references/paragraph_jobs.md；调整段落角色行为或从 Python 重构 writer 策略时阅读 references/paragraph_job_archetypes.md；推理兼容模式引导行为时阅读 references/bootstrap_assembly.md。按需阅读：references/opener_catalog.md（段落 1 显得泛化或叙述化时）、references/contrast_moves.md（构建 A-vs-B 对比段落时）、references/eval_anchor_patterns.md（提出性能/鲁棒性/基准声明时）、references/limitation_moves.md（添加限定或局部结论时）、references/examples_good.md 与 references/examples_bad.md（仅用于校准）。机器可读契约：assets/subsection_writer_context.schema.json、assets/bootstrap_paragraph_templates.json、assets/paragraph_job_templates.json。
输入 必需：DECISIONS.md（须含 Approve C2）、outline/outline.yml、outline/writer_context_packs.jsonl（首选）、citations/ref.bib。可选：outline/subsection_briefs.jsonl、outline/evidence_drafts.jsonl、outline/evidence_bindings.jsonl、outline/anchor_sheet.jsonl、outline/chapter_briefs.jsonl。
输出 sections/S<sub_id>.md（H3 正文）、sections/sections_manifest.jsonl、sections/h3_bodies.refined.ok。front-matter-writer 负责 Abstract、Introduction、Related Work、Discussion、Conclusion；chapter-lead-writer 负责 H2 引导块；本技能读取这些文件并刷新共享 manifest，但不主张其作者身份。
Writer 策略 活动规则是覆盖论证动作，而非段落配额。小节应覆盖 pack 支持的必要论证动作，证据不足时不应填充到固定数量。开头/结尾策略：从 pack 的实际张力、对比、协议或限制信号生成 2-4 个开头候选，保留最具内容承载力的选项；小节结尾从承载证据的对比/限制材料中自然产生，不附加固定收尾；将内部轴标签规范化为自然读者散文，斜杠式 brief 句柄应保留为规划元数据。
脚本边界 scripts/run.py 仅作辅助：可引导缺失 H3 文件并刷新 manifest；引导散文由 writer packs 与版本化模板资产确定性组装，是可检查的兜底材料，不代表模型作者身份或最终散文质量；不得视为散文形态或语气策略的权威来源；不得自我认证引导散文，脚本从不创建 sections/h3_bodies.refined.ok；该标记仅为 U100 的提交证明，在下游 writer-selfloop 之前创建，因此不代表自循环已通过；强制验收独立比较 H3 句子与 Run 选定的 writer 模板资产，拒绝超过 Pipeline 限制的字面残留；writer-selfloop 调用共享严格小节检查器，在报告 PASS 前重新计算 H3 度量；强制 pipeline-auditor 度量整个合并草稿并写入记分卡；当前 10% 限制是初始策略目标，已发布的当前契约重放对一组保留 Artifact 测得 0/226 残留，而从零开始与跨主题复现仍待验证；若标记早于 writer 输入或 writer 脚本，则已过期，下次运行会在重新生成引导散文前移除它。
快速开始 uv run python .codex/skills/subsection-writer/scripts/run.py --workspace <workspace>
全部选项 --workspace <dir>、--unit-id <id>、--inputs <a;b;...>、--outputs <a;b;...>、--checkpoint <C*>
示例 uv run python .codex/skills/subsection-writer/scripts/run.py --workspace <workspace>
故障排除 若 pack 内容单薄，停止并路由上游，而非填充散文。若小节听起来像叙述，重新加载 references/opener_catalog.md 与 references/examples_bad.md。若声明缺少协议上下文，重写前重新加载 references/eval_anchor_patterns.md。若 DECISIONS.md 缺少 Approve C2，先停止并修复审批。若 outline/writer_context_packs.jsonl 单薄，改路由上游而非填充散文。若引用范围有误，编辑输出文本前重新检查 citations/ref.bib 与 writer packs。
执行说明 兼容模式下 scripts/run.py 当前消费：DECISIONS.md（Approve C2）、outline/outline.yml（枚举章节/小节文件）、outline/writer_context_packs.jsonl（主要起草输入）、citations/ref.bib（范围内引用），以及 outline/subsection_briefs.jsonl、outline/evidence_drafts.jsonl、outline/evidence_bindings.jsonl、outline/anchor_sheet.jsonl、outline/chapter_briefs.jsonl 作为可选增强来源。