Academic Paper Writer

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.

1. Detect mode, paper_type, section, and language using manifest axes.
2. Echo the detected mode to the user before executing.
3. 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 + thindraft=no | passed/failed/blocked | | D: Full-Paper Citation Count | Step 11→output | Total >= mincitations | 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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: joshua-zyy
• Source: joshua-zyy/academic-paper-writer
• License: MIT

Install and usage instructions live in the source repository linked above.