academic-paper-writer

Use when writing or revising CS/AI/ML papers from research notes, code repositories, local literature libraries, target venue requirements, or section-level drafting requests. Triggers include 写论文, 初稿

SKILL.md

GitHub

Academic Paper Writer (Core Orchestrator)

证据闭环型、分节推进的论文编排代理。协调六个子技能:Step 0→1→2→3→4→5→6→7→8→9→10→11→12。

Router Protocol

  1. Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
  2. Read every file listed under always_load. These are the skill's binding rules — not reference material.
  3. Apply the loaded material as constraints:
    • stance.md defines core rules, sub-skill boundary, and scope.
    • red-lines.md defines absolute prohibitions. Do not negotiate these.
    • output-contract.md defines file outputs, deliverables, and completion criteria.
    • anti-patterns.md defines known failure modes and their correct alternatives.
    • workflow.md defines the Step 0-12 sequence summary.
    • ../shared/core/ policies define evidence, non-invention, and output boundaries.
  4. Detect mode, paper_type, section, and language using manifest axes.
  5. Echo the detected mode to the user before executing.
  6. Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Modes

Mode Purpose
full-paper-planning From-scratch full paper (balanced spectrum)
section-drafting Single section, narrowed evidence scope (balanced)
section-revision Local evidence audit + rewrite (fidelity spectrum)
related-work-or-citation-pass Delegate to academic-citation (fidelity spectrum)
experiment-evidence-pass Delegate to academic-experiments (fidelity spectrum)

Sub-Skill Dispatch

Task Sub-Skill Step
Venue research academic-venue-research Step 4
Evidence audit Probe agent Step 5
Citation search academic-citation Step 6
Experiment audit academic-experiments Step 7
Figure generation academic-figure Step 9.4
Prose polishing academic-polishing Step 9.6 (internal)
Draft review academic-reviser Step 9.5 / 9.8

Push Modes

Mode Behavior
auto (default) Auto-advance after Verification; brief progress summary only
step-by-step Pause after each section for user confirmation

Switch anytime via user request.

Hard Gates (A-E)

Gate Trigger Condition Failure
E: Venue Step 1→5 若用户提供本地 PDF 文献库,Step 2 已验证 MD 目录;venue-brief.md exists Blocked
A: Evidence Step 5→9 >= 1 usable evidence Degradation or blocked
B: Section Citation Readiness Step 6→9 Current section has VERIFIED citations, Citation-to-Claim Map, or explicit [REF_NEEDED] debt for key claims Section-dependent: Intro/RW blocked, Method/Results may proceed with tracked debt
C: Verification Step 9.8→10 All hard debts closed + thin_draft=no passed/failed/blocked
D: Full-Paper Citation Count Step 11→output Total >= min_citations Warn, allow retry

9.1 Pre-Draft Probe Rules

Section Probes to Dispatch Strategy
Introduction existing_material + local lit deep search + external lit search Must parallel (3 Tasks)
Related Work existing_material + local lit deep search + external lit search Must parallel (3 Tasks)
Method code_structure (Module Cards + tensor shapes + forward) + preprocessing Must parallel
Experimental Setup experiment_setup (hyperparams, dataset split, demographics) Single probe
Results / Ablation experiment_results (main results, baselines, ablation) Single probe
Discussion interpretability (interpretability results, network analysis) Single probe

Default Section Queue

Abstract is post-posed, not in initial queue. Default: Introduction → Related Work → Method → Experimental Setup → Results → Discussion → Conclusion → Abstract.