Chapter Lead Writer

Triggers & routing

• Trigger: chapter lead writer, section lead writer, H2 lead, lead paragraph, 章节导读, 章节导语.
• Use when: you have H2 chapters with multiple H3 subsections and the draft reads like paragraph islands across subsections.

Purpose

This skill writes the body-only lead block that sits under an H2 heading and makes a chapter with multiple H3 subsections read like one argument.

This SKILL.md is now the package router, not the full method manual.

Migration status

This package is in P0 compatibility-preserving migration:

• references/ and assets/ now hold the intended knowledge and contract layers.
• scripts/run.py remains in compatibility mode for active generation.
• a later script-thinning pass should move more judgment and exemplars out of Python and leave the script with deterministic execution and validation only.

For now, preserve the existing output contract and treat scripts/run.py as the execution source of truth.

Inputs

Required:

• outline/outline.yml
• outline/chapter_briefs.jsonl
• citations/ref.bib

Optional:

• outline/writer_context_packs.jsonl

Outputs

For each H2 section with H3 subsections:

• sections/S<sec_id>_lead.md

Output contract

Keep these file-shape rules stable:

• each lead file is body-only and contains no headings
• each lead file previews the chapter lens and connects multiple H3s as one argument
• each lead file stays within the chapter's existing citation scope
• each lead file adds no new facts that are not supported later in the chapter

Load Order

Always read:

• references/overview.md
• references/lead_block_archetypes.md