Skills

Subsection Writer

Write survey prose into per-section files under `sections/` so each unit can be QA'd...

Install

npx skills add WILLOSCAR/research-units-pipeline-skills --skill subsection-writer -g -a claude-code -y
Category
Testing
Updated
1mo ago
License
See repository
Context cost
Mediumabout 1,592 tokens
Runs scripts
Yes, review before use

What it does

Write survey prose into per-section files under `sections/` so each unit can be QA'd independently before merging.

Subsection Writer (compatibility router)

Triggers & routing

  • Trigger: subsection writer, per-section writing, split sections, sections/, 分小节写, 按章节拆分写作.
  • Use when: Approve C2 is recorded and writer packs exist (outline/writer_context_packs.jsonl); you want evidence-bounded drafting without a monolithic one-shot draft.

Purpose: write or refine per-section survey prose under sections/ while keeping the current pipeline contract unchanged.

Compatibility mode:

  • output paths stay the same
  • scripts/run.py still handles approval checks, missing-file bootstrap, and sections/sections_manifest.jsonl
  • writing guidance now lives in references/ instead of being encoded primarily in the script

Load Order

Always read:

  • references/overview.md
  • references/paragraph_jobs.md
  • references/paragraph_job_archetypes.md when adjusting paragraph-role behavior or refactoring writer policy out of Python
  • references/bootstrap_assembly.md when reasoning about compatibility-mode bootstrap behavior

Read as needed:

  • references/opener_catalog.md when paragraph 1 sounds generic or narrated
  • references/contrast_moves.md when building A-vs-B comparison paragraphs
  • references/eval_anchor_patterns.md when making performance / robustness / benchmark claims
  • references/limitation_moves.md when adding caveats or local conclusions
  • references/examples_good.md and references/examples_bad.md for calibration only

Machine-readable contract:

  • assets/subsection_writer_context.schema.json
  • assets/bootstrap_paragraph_templates.json
  • assets/paragraph_job_templates.json

Inputs

Required:

  • DECISIONS.md (must include Approve C2)
  • outline/outline.yml
  • outline/writer_context_packs.jsonl (preferred)
  • citations/ref.bib

Optional but useful:

  • outline/subsection_briefs.jsonl
  • outline/evidence_drafts.jsonl
  • outline/evidence_bindings.jsonl
  • outline/anchor_sheet.jsonl
  • outline/chapter_briefs.jsonl

Outputs

Read the whole SKILL.md on GitHub

More in Testing