# 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 写论文, 初稿, paper draft, write introduction, write method, full paper outline, section-by-section drafting, 证据闭环, 论文起草, 从零写论文, 逐节写作.

- Skill: `joshua-zyy/academic-paper-writer` (Agent Skill, multi-file: 35 files)
- Install (CLI): `npx skillmds@latest add joshua-zyy/academic-paper-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joshua-zyy/academic-paper-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: joshua-zyy (https://skillmd.com/u/joshua-zyy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joshua-zyy/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.
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.