12-agent academic paper writing pipeline. 10 modes (full/plan/outline/revision/revision-coach/abstract/lit-review/format-convert/citation-check/disclosure). 6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output. Style Calibration + Writing Quality Check + Anti-Patterns with IRON RULE markers. Triggers: write paper, academic paper, guide my paper, parse reviews, AI disclosure, 寫論文, 學術論文, 引導我寫論文, 審查意見.
A general-purpose academic paper writing tool — 12-agent pipeline covering all disciplines, with higher education domain as the default reference.
v2.5 adds two writing quality features:
shared/style_calibration_protocol.md.references/writing_quality_check.md) — A writing quality checklist applied during the draft self-review step. Catches overused AI-typical terms, em dash overuse, throat-clearing openers, uniform paragraph lengths, and monotonous sentence rhythm. These are good writing rules, not detection evasion.Minimal command:
Write a paper on the impact of AI on higher education quality assurance
Write a paper on the impact of declining birth rates on private university management strategies
Execution flow:
English: write paper, academic paper, paper outline, write abstract, revise paper, literature review paper, check citations, convert to LaTeX, convert format, format paper, conference paper, journal article, thesis chapter, research paper, guide my paper, help me plan my paper, step by step paper, draft manuscript, write methodology, write discussion, parse reviews, revision roadmap, help me with my revision, I got reviewer comments, convert citations
繁體中文: 寫論文, 學術論文, 論文大綱, 寫摘要, 修改論文, 文獻回顧論文, 檢查引用, 轉 LaTeX, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式
Activate plan mode when the user wants guidance, step-by-step planning, or expresses uncertainty about paper structure. Default rule: when ambiguous between plan and full, prefer plan.
See
references/plan_mode_protocol.mdfor full intent signals and activation rules.
| Scenario | Use Instead |
|---|---|
| Deep research / fact-checking (not paper writing) | deep-research |
| Reviewing a paper (structured review) | academic-paper-reviewer |
| Full research-to-paper pipeline | academic-pipeline |
deep-research| Feature | academic-paper | deep-research |
|---|---|---|
| Primary output | Publishable paper draft | Research report |
| Structure | Journal-ready (IMRaD, etc.) | APA 7.0 report |
| Citation | Multi-format (APA/Chicago/MLA/IEEE/Vancouver) | APA 7.0 only |
| Abstract | Bilingual (zh-TW + EN) | Single language |
| Peer review | Simulated 5-dimension review | Editorial review |
| Output format | LaTeX/DOCX (via Pandoc)/PDF/Markdown | Markdown only |
| Revision loop | Max 2 rounds with targeted feedback | Max 2 rounds |
| # | Agent | Role | Phase |
|---|---|---|---|
| 1 | intake_agent | Configuration interview: paper type, discipline, journal, citation format, output format, language, word count; Handoff detection; Plan mode simplified interview | Phase 0 |
| 2 | literature_strategist_agent | Search strategy design, source screening, annotated bibliography, literature matrix | Phase 1 |
| 3 | structure_architect_agent | Paper structure selection, detailed outline, word count allocation, evidence mapping | Phase 2 |
| 4 | argument_builder_agent | Argument construction, claim-evidence chains, logical flow, counter-argument handling; Plan mode argument stress test | Phase 3 / Plan Step 3 |
| 5 | draft_writer_agent | Section-by-section full draft writing, discipline register adjustment, word count tracking | Phase 4 |
| 6 | citation_compliance_agent | Citation format verification, reference list completeness, DOI checking | Phase 5a |
| 7 | abstract_bilingual_agent | Bilingual abstract (zh-TW + EN), 5-7 keywords each | Phase 5b |
| 8 | peer_reviewer_agent | Simulated double-blind review, five-dimension scoring, revision suggestions (max 2 rounds) | Phase 6 |
| 9 | formatter_agent | Convert to LaTeX/DOCX (via Pandoc)/PDF/Markdown, journal formatting, cover letter, citation format conversion (APA 7 / Chicago / MLA / IEEE / Vancouver) | Phase 7 |
| 10 | socratic_mentor_agent | Plan mode Socratic mentor: chapter-by-chapter guidance, convergence criteria (4 signals), question taxonomy (4 types), INSIGHT extraction | Plan Step 0-3 |
| 11 | visualization_agent | Parse paper data and generate publication-quality figure code (Python matplotlib / R ggplot2) with APA 7.0 formatting, colorblind-safe palettes, and LaTeX integration | Phase 4 / Phase 7 |
| 12 | revision_coach_agent | Parse unstructured reviewer comments into structured Revision Roadmap; classify, map, and prioritize comments; works standalone without prior pipeline execution | Revision-Coach mode |
LaTeX (.tex + .bib), DOCX (via Pandoc), PDF (via LaTeX or Pandoc), Markdown.
When the paper contains quantitative results, the visualization_agent can generate publication-ready figures in Python (matplotlib/seaborn) or R (ggplot2) with APA 7.0 formatting and colorblind-safe palettes. Figures are delivered as runnable code + LaTeX \includegraphics integration code. See references/statistical_visualization_standards.md for chart type decision trees and code templates.
APA 7.0 (default), Chicago (Author-Date or Notes-Bibliography), MLA 9, IEEE, Vancouver. The formatter_agent supports late-stage citation format conversion between any two supported formats via "Convert citations to [format]".
Phase 0: CONFIG -> [intake_agent] -> Paper Configuration Record
Phase 1: RESEARCH -> [literature_strategist] -> Search Strategy + Source Corpus
Phase 2: ARCHITECTURE -> [structure_architect] -> Paper Outline + Evidence Map
Phase 3: ARGUMENTATION -> [argument_builder] -> Argument Blueprint
Phase 4: DRAFTING -> [draft_writer] -> Complete Draft
Phase 5a: CITATIONS -> [citation_compliance] ──┐ -> Citation Audit Report
Phase 5b: ABSTRACT -> [abstract_bilingual] ─┘ -> Bilingual Abstract + Keywords (parallel)
Phase 6: PEER REVIEW -> [peer_reviewer] -> Review Report (max 2 revision loops)
Phase 7: FORMAT -> [formatter] -> Final Output Package
See
references/workflow_phase_details.mdfor detailed per-phase agent behavior and output descriptions.
See references/mode_selection_guide.md for details.
| Mode | Trigger | Agents | Output |
|---|---|---|---|
full | "Write a paper" | All 9 (+ 11 if quantitative) | Complete paper draft (with figures if applicable) |
outline-only | "Paper outline" | 1->2->3 | Detailed outline + evidence map |
revision | "Revise paper" | 8->5->6 | Revised draft with tracked changes (uses templates/revision_tracking_template.md) |
abstract-only | "Write abstract" | 1->7 | Bilingual abstract + keywords |
lit-review | "Literature review" | 1->2 | Annotated bibliography + synthesis |
format-convert | "Convert to LaTeX" / "Convert citations to [format]" | 9 only | Formatted document; includes citation format conversion (APA 7 / Chicago / MLA / IEEE / Vancouver) |
citation-check | "Check citations" | 6 only | Citation error report |
plan | "guide my paper" / "help me plan my paper" | 1->10->3->4 | Chapter Plan + INSIGHT Collection |
revision-coach | "parse reviews" / "revision roadmap" / "I got reviewer comments" | 12 only | Revision Roadmap + optional Tracking Template + Response Letter Skeleton |
disclosure (v3.2) | "AI disclosure for Nature" / "generate AI usage statement" | 9 only | Venue-specific AI-usage disclosure paragraph(s) + placement instructions |
| Your Situation | Recommended Mode | Spectrum |
|---|---|---|
| Starting from scratch with a clear RQ | full | balanced |
| Need help planning before writing | plan | originality |
| Just need an outline | outline-only | balanced |
| Have a draft, received review feedback | revision | fidelity |
| Have unstructured reviewer comments | revision-coach | balanced |
| Just need an abstract | abstract-only | fidelity |
| Need to check/fix citations | citation-check | fidelity |
| Need to convert format (LaTeX, DOCX) or citation style | format-convert | fidelity |
| Want a systematic literature review paper | lit-review | fidelity |
| Need a venue-specific AI-usage disclosure statement for submission | disclosure | fidelity |
Spectrum (v3.2): fidelity = template-heavy, predictable output; balanced = default; originality = exploratory, template-light. See shared/mode_spectrum.md for the full cross-skill spectrum table.
Not sure? Start with plan — it will guide you step by step. disclosure is a finishing step — run it after the paper is drafted, targeting the venue you plan to submit to.
See
references/mode_selection_guide.mdfor trigger-to-mode mappings and the full selection flowchart.
Socratic mode that guides users through paper planning one chapter at a time. Builds a complete Paper Blueprint through structured dialogue.
See
references/plan_mode_protocol.mdfor the full chapter-by-chapter dialogue flow and Paper Blueprint structure.
intake_agent automatically detects deep-research materials (RQ Brief / Bibliography / Synthesis / INSIGHT Collection) and skips redundant steps. See deep-research/SKILL.md Handoff Protocol for the complete handoff material format.
See references/failure_paths.md for details. Quick reference:
| Failure Scenario | Handling Strategy |
|---|---|
| Insufficient research foundation | Recommend running deep-research first |
| Wrong paper structure selected | Return to Phase 2, suggest alternative structure |
| Word count significantly over/under target | Identify problematic chapters, suggest trimming/expansion |
| Citation format entirely wrong | Re-run the entire citation phase |
| Peer review rejection | Analyze rejection reasons, suggest major revision or restructuring |
| Plan mode not converging | Suggest switching to outline-only mode |
| Incomplete handoff materials | List missing items, suggest supplementing or re-running |
| User abandons midway | Save completed Chapter Plan |
See academic-pipeline/SKILL.md for the complete workflow.
See agents/intake_agent.md for the complete field definitions of the Phase 0 configuration interview. The interview covers 9 items: paper type, discipline, target journal, citation format, output format, language, abstract, word count, and existing materials. Outputs a Paper Configuration Record, awaiting user confirmation.
Agent definitions: agents/{agent_name}.md — one file per agent (12 total, matching Agent Team table above).
References (19 files in references/):
apa7_extended_guide, apa7_chinese_citation_guide, citation_format_switcheracademic_writing_style, writing_quality_check, writing_judgment_frameworkpaper_structure_patterns (6 types), abstract_writing_guidehei_domain_glossary (bilingual), journal_submission_guide, latex_template_referencefailure_paths (12 scenarios), mode_selection_guide (10 modes), plan_mode_protocol, workflow_phase_detailscredit_authorship_guide (CRediT 14 roles), funding_statement_guide, statistical_visualization_standardsdisclosure_mode_protocol (venue-specific AI-usage statement generation), venue_disclosure_policies (v1 database: ICLR, NeurIPS, Nature, Science, ACL, EMNLP)deep-research/references/apa7_style_guide.md (base reference, extended here)Templates (11 files in templates/): imrad, literature_review, case_study, theoretical_paper, policy_brief, conference_paper, latex_article_template.tex, bilingual_abstract, credit_statement, funding_statement, revision_tracking (4 status types).
Examples (5 files in examples/): imrad_hei_example, literature_review_example, plan_mode_guided_writing, chinese_paper_example, revision_mode_example.
Explicit prohibitions to prevent common failure modes:
| # | Anti-Pattern | Why It Fails | Correct Behavior |
|---|---|---|---|
| 1 | AI-typical overused terms | "delve into", "crucial", "it is important to note" = instant AI detection | Use discipline-specific vocabulary; see references/writing_quality_check.md |
| 2 | Em dash abuse | More than 2 em dashes per page signals AI writing | Use parentheses, commas, or restructure the sentence |
| 3 | Throat-clearing openers | "In this section, we will discuss..." adds no information | Start with the claim or finding directly |
| 4 | Uniform paragraph lengths | Every paragraph is 4-5 sentences = monotonous AI rhythm | Vary paragraph length naturally (2-8 sentences) |
| 5 | ⚠️ IRON RULE: Fabricated citations | Inventing plausible-sounding references that don't exist | Every citation must be verified via DOI or WebSearch; see academic-pipeline/agents/integrity_verification_agent.md |
| 6 | Sycophantic revision | Accepting all reviewer feedback without critical evaluation | Use REVIEWER_DISAGREE status when reviewer is wrong; justify with evidence |
| 7 | Scope creep during revision | Adding unrequested sections/analyses to "improve" the paper | Revision addresses reviewer concerns only; new content requires explicit user approval |
| 8 | Ignoring failure paths | Continuing despite desk-reject signals or fatal methodology flaws | Check references/failure_paths.md; invoke F11 Desk-Reject Recovery when triggered |
⚠️ IRON RULE: Every paper MUST include: Data Availability Statement, Ethics Declaration, Author Contributions (CRediT), Conflict of Interest Statement, Funding Acknowledgment. 17. AI disclosure statement — every paper must include a statement on AI tool usage 18. Limitations section — explicitly discuss study limitations 19. Ethics statement — when applicable (human subjects, sensitive data)
Follows the user's language. Academic terminology is kept in English. Bilingual abstracts are always provided regardless of the main text language.
academic-paper + tw-hei-intelligence -> Evidence-based HEI paper with real MOE data
academic-paper + deep-research -> Deep research phase -> paper writing phase (auto-handoff)
academic-paper + report-to-website -> Interactive web version of the paper
academic-paper + notebooklm-slides-generator -> Presentation slides from paper
academic-paper + academic-paper-reviewer -> Peer review -> revision loop
| Item | Content |
|---|---|
| Skill Version | 3.0.2 |
| Last Updated | 2026-04-15 |
| Maintainer | Cheng-I Wu |
| Dependent Skills | deep-research v1.0+ (upstream), academic-paper-reviewer v1.0+ (downstream) |
See
references/changelog.mdfor full version history.