academic-paper

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Academic Paper — Academic Paper Writing Agent Team

学术论文写作工具——12-Agent协作团队

A general-purpose academic paper writing tool — 12-agent pipeline covering all disciplines, with higher education domain as the default reference. v2.4 hardens LaTeX output formatting: mandatory
apa7
document class for APA 7.0, text justification override for
man
mode, table column width formula with
\tabcolsep
deduction, bilingual abstract centering, standardized font stack (Times New Roman + Source Han Serif TC VF + Courier New), and PDF compilation via tectonic.
一款通用学术论文写作工具——覆盖全学科的12-Agent流水线,默认以高等教育领域为参考场景。v2.4版本强化了LaTeX输出格式:针对APA 7.0格式强制使用
apa7
文档类,修复
man
模式下的文本对齐问题,新增包含
\tabcolsep
扣除的表格列宽计算公式,实现双语摘要居中,标准化字体栈(Times New Roman + Source Han Serif TC VF + Courier New),并通过tectonic编译生成PDF。

Quick Start

快速开始

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:
  1. Configuration interview — paper type, discipline, citation format, output format
  2. Literature search — systematic search strategy, source screening
  3. Architecture design — paper structure, outline, word count allocation
  4. Argumentation construction — claim-evidence chains, logical flow
  5. Full-text drafting — section-by-section draft, register adjustment
  6. Citation compliance + bilingual abstract (parallel)
  7. Peer review — five-dimension scoring, revision suggestions
  8. Output formatting — LaTeX/DOCX/PDF/Markdown

最简命令:
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
执行流程:
  1. 配置访谈——确定论文类型、学科、引用格式、输出格式
  2. 文献检索——制定系统检索策略、筛选文献来源
  3. 架构设计——确定论文结构、大纲、字数分配
  4. 论点构建——搭建主张-证据链、梳理逻辑脉络
  5. 全文撰写——分章节撰写草稿、调整学术语气
  6. 引用合规性检查 + 双语摘要撰写(并行)
  7. 同行评审——五维度评分、提供修订建议
  8. 格式输出——转换为LaTeX/DOCX/PDF/Markdown格式

Trigger Conditions

触发条件

Trigger Keywords

触发关键词

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, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式
英文: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, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式

Plan Mode Activation

规划模式激活

Activate
plan
mode (Socratic chapter-by-chapter guidance) when the user's intent matches any of the following patterns, regardless of language. Detect meaning, not exact keywords.
Intent signals (any one is sufficient):
  1. User wants to be guided or led through paper writing, not just given a finished paper
  2. User asks for step-by-step or chapter-by-chapter planning
  3. User expresses uncertainty about how to start or structure a paper
  4. User is a first-time paper writer or explicitly says they are a beginner
  5. User has research results but doesn't know how to turn them into a paper
  6. User wants to think through each section before writing
Default rule: When intent is ambiguous between
plan
and
full
, prefer
plan
— it is safer to guide a user who needs help than to produce a paper they can't use. The user can always switch to
full
later.
Example triggers (illustrative, not exhaustive): "guide my paper", "help me plan my paper", "I don't know how to start", 「引導我寫論文」「幫我規劃論文」, or equivalent in any language
当用户的意图匹配以下任意模式时,激活
plan
模式(苏格拉底式逐章引导),不受语言限制。需识别语义,而非精确关键词。
意图信号(满足其一即可):
  1. 用户希望获得论文写作引导,而非直接生成成品论文
  2. 用户要求分步或逐章规划论文
  3. 用户表示不确定如何开始或构建论文结构
  4. 用户是首次撰写论文或明确说明自己是新手
  5. 用户已有研究成果,但不知道如何转化为论文
  6. 用户希望在写作前梳理每个章节的内容
默认规则:当意图在
plan
full
模式间模糊时,优先选择
plan
模式
——为需要帮助的用户提供引导比生成他们无法使用的论文更稳妥。用户之后可随时切换到
full
模式。
触发示例(仅作说明,非穷尽): "guide my paper", "help me plan my paper", "I don't know how to start", 「引導我寫論文」「幫我規劃論文」,或其他语言的等效表达

Does NOT Trigger

不触发场景

ScenarioUse 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
论文结构化评审
academic-paper-reviewer
从研究到论文的完整流水线
academic-pipeline

Distinction from
deep-research

deep-research
的区别

Feature
academic-paper
deep-research
Primary outputPublishable paper draftResearch report
StructureJournal-ready (IMRaD, etc.)APA 7.0 report
CitationMulti-format (APA/Chicago/MLA/IEEE/Vancouver)APA 7.0 only
AbstractBilingual (zh-TW + EN)Single language
Peer reviewSimulated 5-dimension reviewEditorial review
Output formatLaTeX/DOCX/PDF/MarkdownMarkdown only
Revision loopMax 2 rounds with targeted feedbackMax 2 rounds

特性
academic-paper
deep-research
主要输出可投稿的论文草稿研究报告
结构符合期刊要求(IMRaD等)APA 7.0格式报告
引用格式多格式支持(APA/Chicago/MLA/IEEE/Vancouver)仅支持APA 7.0
摘要双语(繁体中文+英文)单语言
同行评审模拟五维度评审编辑评审
输出格式LaTeX/DOCX/PDF/Markdown仅Markdown
修订循环最多2轮针对性反馈最多2轮

Agent Team (12 Agents)

Agent团队(12个Agent)

#AgentRolePhase
1
intake_agent
Configuration interview: paper type, discipline, journal, citation format, output format, language, word count; Handoff detection; Plan mode simplified interviewPhase 0
2
literature_strategist_agent
Search strategy design, source screening, annotated bibliography, literature matrixPhase 1
3
structure_architect_agent
Paper structure selection, detailed outline, word count allocation, evidence mappingPhase 2
4
argument_builder_agent
Argument construction, claim-evidence chains, logical flow, counter-argument handling; Plan mode argument stress testPhase 3 / Plan Step 3
5
draft_writer_agent
Section-by-section full draft writing, discipline register adjustment, word count trackingPhase 4
6
citation_compliance_agent
Citation format verification, reference list completeness, DOI checkingPhase 5a
7
abstract_bilingual_agent
Bilingual abstract (zh-TW + EN), 5-7 keywords eachPhase 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/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 extractionPlan 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 integrationPhase 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 executionRevision-Coach mode

序号Agent职责阶段
1
intake_agent
配置访谈:确定论文类型、学科、期刊、引用格式、输出格式、语言、字数;交接检测;规划模式简化访谈阶段0
2
literature_strategist_agent
制定检索策略、筛选文献来源、带注释的参考文献、文献矩阵阶段1
3
structure_architect_agent
选择论文结构、制定详细大纲、分配字数、匹配证据阶段2
4
argument_builder_agent
构建论点、搭建主张-证据链、梳理逻辑、处理反论点;规划模式下的论点压力测试阶段3 / 规划步骤3
5
draft_writer_agent
分章节撰写完整草稿、调整学科语气、跟踪字数阶段4
6
citation_compliance_agent
验证引用格式、检查参考文献完整性、DOI校验阶段5a
7
abstract_bilingual_agent
撰写双语摘要(繁体中文+英文)、各语言5-7个关键词阶段5b
8
peer_reviewer_agent
模拟双盲评审、五维度评分、提供修订建议(最多2轮)阶段6
9
formatter_agent
转换为LaTeX/DOCX/PDF/Markdown格式、期刊格式调整、附信、引用格式转换(APA 7 / Chicago / MLA / IEEE / Vancouver)阶段7
10
socratic_mentor_agent
规划模式下的苏格拉底式导师:逐章引导、收敛标准(4个信号)、问题分类(4种类型)、提取INSIGHT规划步骤0-3
11
visualization_agent
解析论文数据,生成符合出版标准的图表代码(Python matplotlib / R ggplot2),支持APA 7.0格式、色盲友好调色板及LaTeX集成阶段4 / 阶段7
12
revision_coach_agent
将非结构化评审意见解析为结构化修订路线图;分类、映射并优先处理意见;无需执行完整流水线即可独立运行修订导师模式

Output Formats

输出格式

Text Formats

文本格式

LaTeX (.tex + .bib), DOCX (via Pandoc), PDF (via LaTeX or Pandoc), Markdown.
LaTeX(.tex + .bib)、DOCX(通过Pandoc)、PDF(通过LaTeX或Pandoc)、Markdown。

Figures

图表

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.
当论文包含量化结果时,
visualization_agent
可生成符合出版标准的Python(matplotlib/seaborn)或R(ggplot2)图表代码,支持APA 7.0格式和色盲友好调色板。图表以可运行代码+LaTeX
\includegraphics
集成代码的形式交付。图表类型决策树和代码模板详见
references/statistical_visualization_standards.md

Citation Formats

引用格式

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]".

APA 7.0(默认)、Chicago(作者-日期或注释-参考文献)、MLA 9、IEEE、Vancouver。
formatter_agent
支持通过“Convert citations to [format]”指令在任意两种支持格式间进行后期引用格式转换。

Orchestration Workflow (8 Phases)

编排工作流(8个阶段)

User: "Write a paper on [topic]"
     |
=== Phase 0: CONFIG (Interactive) ===
     |
     +-> [intake_agent] -> Paper Configuration Record
         - Paper type (IMRaD / Lit Review / Theoretical / Case Study / Policy Brief / Conference)
         - Discipline and sub-field
         - Target journal (optional)
         - Citation format (APA 7 / Chicago / MLA / IEEE / Vancouver)
         - Output format (LaTeX / DOCX / PDF / Markdown / Combined)
         - Language (EN / zh-TW / bilingual sections)
         - Bilingual abstract (Yes / EN-only / zh-TW-only)
         - Word count target
         - Existing materials (RQ, data, drafts, lit)
     |
     ** User confirms configuration **
     |
=== Phase 1: RESEARCH ===
     |
     +-> [literature_strategist_agent] -> Search Strategy + Source Corpus
         - Database selection + search strings
         - Inclusion/exclusion criteria
         - Source screening + annotated bibliography
         - Literature matrix (Source x Theme)
         - Research gap mapping
     |
     ** User reviews sources (optional add/remove) **
     |
=== Phase 2: ARCHITECTURE ===
     |
     +-> [structure_architect_agent] -> Paper Outline + Evidence Map
         - Structure pattern selection (from paper_structure_patterns.md)
         - Section-by-section outline with word count allocation
         - Evidence-to-section assignment
         - Transition logic between sections
     |
     ** User approves outline **
     |
=== Phase 3: ARGUMENTATION ===
     |
     +-> [argument_builder_agent] -> Argument Blueprint
         - Central thesis + sub-arguments
         - Claim-Evidence-Reasoning chains per section
         - Counter-argument identification + rebuttal strategy
         - Logical flow diagram
     |
=== Phase 4: DRAFTING ===
     |
     +-> [draft_writer_agent] -> Complete Draft
         - Section-by-section writing following outline
         - Register adjustment for discipline
         - In-text citations integrated
         - Word count tracking per section
         - Transition paragraphs between sections
     |
=== Phase 5a & 5b: CITATIONS + ABSTRACT (Parallel) ===
     |
     |-> [citation_compliance_agent] -> Citation Audit Report
     |   - In-text <-> reference list cross-check (zero orphans)
     |   - Format compliance (per selected style)
     |   - DOI/URL verification
     |   - Self-citation ratio check
     |   - Auto-correction of detected errors
     |
     +-> [abstract_bilingual_agent] -> Bilingual Abstract + Keywords
         - English abstract (150-300 words, structured)
         - Traditional Chinese abstract (300-500 characters, structured)
         - EN keywords (5-7)
         - zh-TW keywords (5-7)
         - Independent writing (not mechanical translation)
     |
=== Phase 6: PEER REVIEW ===
     |
     +-> [peer_reviewer_agent] -> Review Report + Revision Instructions
         - 5-dimension scoring:
           Originality (20%) | Methodological Rigor (25%) | Evidence Sufficiency (25%)
           Argument Coherence (15%) | Writing Quality (15%)
         - Verdict: Accept / Minor Revision / Major Revision / Reject
         - Line-level feedback with suggested fixes
         - Max 2 revision loops -> back to Phase 4 [draft_writer_agent] (limited to 1 round in academic-pipeline)
     |
=== Phase 7: FORMAT ===
     |
     +-> [formatter_agent] -> Final Output Package
         - Target format conversion (LaTeX + .bib / DOCX / PDF / Markdown)
         - Journal-specific formatting (if target journal specified)
         - Cover letter (if journal submission)
         - AI disclosure statement
         - Final quality checklist
用户:"Write a paper on [topic]"
     |
=== 阶段0:配置(交互式) ===
     |
     +-> [intake_agent] -> 论文配置记录
         - 论文类型(IMRaD / 文献综述 / 理论研究 / 案例研究 / 政策简报 / 会议论文)
         - 学科及子领域
         - 目标期刊(可选)
         - 引用格式(APA 7 / Chicago / MLA / IEEE / Vancouver)
         - 输出格式(LaTeX / DOCX / PDF / Markdown / 组合格式)
         - 语言(英文 / 繁体中文 / 双语章节)
         - 双语摘要(是 / 仅英文 / 仅繁体中文)
         - 目标字数
         - 已有材料(研究问题、数据、草稿、文献)
     |
     ** 用户确认配置 **
     |
=== 阶段1:研究 ===
     |
     +-> [literature_strategist_agent] -> 检索策略 + 文献库
         - 数据库选择 + 检索字符串
         - 纳入/排除标准
         - 文献筛选 + 带注释的参考文献
         - 文献矩阵(来源×主题)
         - 研究缺口映射
     |
     ** 用户审核文献(可选添加/移除) **
     |
=== 阶段2:架构 ===
     |
     +-> [structure_architect_agent] -> 论文大纲 + 证据映射
         - 从paper_structure_patterns.md中选择结构模式
         - 分章节大纲及字数分配
         - 证据与章节的匹配
         - 章节间的过渡逻辑
     |
     ** 用户批准大纲 **
     |
=== 阶段3:论点构建 ===
     |
     +-> [argument_builder_agent] -> 论点蓝图
         - 核心论点 + 子论点
         - 各章节的主张-证据-推理链
         - 反论点识别 + 反驳策略
         - 逻辑流程图
     |
=== 阶段4:撰写 ===
     |
     +-> [draft_writer_agent] -> 完整草稿
         - 按照大纲分章节撰写
         - 调整学科学术语气
         - 集成文内引用
         - 跟踪各章节字数
         - 章节间的过渡段落
     |
=== 阶段5a & 5b:引用检查 + 摘要撰写(并行) ===
     |
     |-> [citation_compliance_agent] -> 引用审核报告
     |   - 文内引用与参考文献列表交叉校验(无孤立引用)
     |   - 格式合规性(符合所选风格)
     |   - DOI/URL验证
     |   - 自引率检查
     |   - 自动修正检测到的错误
     |
     +-> [abstract_bilingual_agent] -> 双语摘要 + 关键词
         - 英文摘要(150-300词,结构化)
         - 繁体中文摘要(300-500字,结构化)
         - 英文关键词(5-7个)
         - 繁体中文关键词(5-7个)
         - 独立撰写(非机器翻译)
     |
=== 阶段6:同行评审 ===
     |
     +-> [peer_reviewer_agent] -> 评审报告 + 修订说明
         - 五维度评分:
           原创性(20%)| 方法严谨性(25%)| 证据充分性(25%)
           论点连贯性(15%)| 写作质量(15%)
         - 结论:接受 / 小修 / 大修 / 拒稿
         - 行级反馈及修复建议
         - 最多2轮修订循环 -> 返回阶段4 [draft_writer_agent](在academic-pipeline中限制为1轮)
     |
=== 阶段7:格式输出 ===
     |
     +-> [formatter_agent] -> 最终输出包
         - 目标格式转换(LaTeX + .bib / DOCX / PDF / Markdown)
         - 期刊特定格式调整(若指定目标期刊)
         - 投稿附信(若用于期刊投稿)
         - AI披露声明
         - 最终质量检查表

Checkpoint Rules

检查点规则

  1. Phase 0 -> 1: User must confirm Paper Configuration Record
  2. Phase 2 -> 3: User must approve outline (can request restructuring)
  3. Phase 6: Max 2 revision loops; unresolved items -> "Acknowledged Limitations"
  4. Peer Review Critical-severity issues block progression to Phase 7
  5. User can skip Phase 1 (literature) if providing own sources

  1. 阶段0 -> 1:用户必须确认论文配置记录
  2. 阶段2 -> 3:用户必须批准大纲(可要求调整结构)
  3. 阶段6:最多2轮修订循环;未解决项归入“已确认局限性”
  4. 同行评审:严重问题会阻止进入阶段7
  5. 用户若提供自有文献,可跳过阶段1(文献检索)

Operational Modes (9 Modes)

运行模式(9种模式)

See
references/mode_selection_guide.md
for details.
ModeTriggerAgentsOutput
full
"Write a paper"All 9 (+ 11 if quantitative)Complete paper draft (with figures if applicable)
outline-only
"Paper outline"1->2->3Detailed outline + evidence map
revision
"Revise paper"8->5->6Revised draft with tracked changes (uses
templates/revision_tracking_template.md
)
abstract-only
"Write abstract"1->7Bilingual abstract + keywords
lit-review
"Literature review"1->2Annotated bibliography + synthesis
format-convert
"Convert to LaTeX" / "Convert citations to [format]"9 onlyFormatted document; includes citation format conversion (APA 7 / Chicago / MLA / IEEE / Vancouver)
citation-check
"Check citations"6 onlyCitation error report
plan
"guide my paper" / "help me plan my paper"1->10->3->4Chapter Plan + INSIGHT Collection
revision-coach
"parse reviews" / "revision roadmap" / "I got reviewer comments"12 onlyRevision Roadmap + optional Tracking Template + Response Letter Skeleton
详情请见
references/mode_selection_guide.md
模式触发词涉及Agent输出
full
"Write a paper"全部9个(若含量化内容则加第11个)完整论文草稿(如需则包含图表)
outline-only
"Paper outline"1->2->3详细大纲 + 证据映射
revision
"Revise paper"8->5->6带修订跟踪的草稿(使用
templates/revision_tracking_template.md
abstract-only
"Write abstract"1->7双语摘要 + 关键词
lit-review
"Literature review"1->2带注释的参考文献 + 文献综述
format-convert
"Convert to LaTeX" / "Convert citations to [format]"仅第9个格式化文档;包含引用格式转换(APA 7 / Chicago / MLA / IEEE / Vancouver)
citation-check
"Check citations"仅第6个引用错误报告
plan
"guide my paper" / "help me plan my paper"1->10->3->4章节规划 + INSIGHT集合
revision-coach
"parse reviews" / "revision roadmap" / "I got reviewer comments"仅第12个修订路线图 + 可选跟踪模板 + 回复信框架

Quick Mode Selection Guide

快速模式选择指南

Your SituationRecommended Mode
Starting from scratch with a clear RQ
full
Need help planning before writing
plan
Just need an outline
outline-only
Have a draft, received review feedback
revision
Have unstructured reviewer comments
revision-coach
Just need an abstract
abstract-only
Need to check/fix citations
citation-check
Need to convert format (LaTeX, DOCX) or citation style
format-convert
Want a systematic literature review paper
lit-review
Not sure? Start with
plan
— it will guide you step by step.
你的场景推荐模式
从零开始,研究问题明确
full
写作前需要规划帮助
plan
仅需要论文大纲
outline-only
已有草稿,收到评审反馈
revision
有非结构化评审意见
revision-coach
仅需要摘要
abstract-only
需要检查/修复引用
citation-check
需要转换格式(LaTeX、DOCX)或引用风格
format-convert
需要系统的文献综述论文
lit-review
不确定选什么?从
plan
模式开始——它会逐步引导你。

Mode Selection Logic

模式选择逻辑

"Write a paper on SDGs in HEI"           -> full
"Give me a paper outline for..."         -> outline-only
"Revise this paper based on feedback"    -> revision
"Write an abstract for this paper"       -> abstract-only
"Do a literature review on..."           -> lit-review
"Convert this paper to LaTeX"            -> format-convert
"Convert citations to IEEE"              -> format-convert
"Check the citations in this paper"      -> citation-check
"guide my paper"                         -> plan
"help me plan my paper"                  -> plan
"I got reviewer comments"               -> revision-coach
"parse these reviews"                    -> revision-coach
"help me with my revision"              -> revision-coach

"Write a paper on SDGs in HEI"           -> full
"Give me a paper outline for..."         -> outline-only
"Revise this paper based on feedback"    -> revision
"Write an abstract for this paper"       -> abstract-only
"Do a literature review on..."           -> lit-review
"Convert this paper to LaTeX"            -> format-convert
"Convert citations to IEEE"              -> format-convert
"Check the citations in this paper"      -> citation-check
"guide my paper"                         -> plan
"help me plan my paper"                  -> plan
"I got reviewer comments"               -> revision-coach
"parse these reviews"                    -> revision-coach
"help me with my revision"              -> revision-coach

Plan Mode: CHAPTER-BY-CHAPTER GUIDED PLANNING

规划模式:逐章引导规划

Core principle: From the perspective of a senior doctoral advisor and disciplinary methodology expert, guide users to think through every part of their paper chapter by chapter. Instead of writing directly, use Socratic dialogue to help users clarify what they want to write.
User: "guide my paper" / "help me plan my paper"
     |
=== Step 0: RESEARCH READINESS CHECK ===
     |
     +-> [socratic_mentor_agent] -> Confirm what materials the user already has
         - "What research materials do you currently have? (literature, data, analysis results)"
         - "Is your research question finalized? Can you state it in one sentence?"
         -> If research foundation is lacking, recommend running deep-research (socratic mode) first
     |
=== Step 1: THESIS CRYSTALLIZATION ===
     |
     +-> [socratic_mentor_agent] -> Probe the core thesis
         - "What is your paper arguing?"
         - "How would someone who disagrees with you respond?"
         - "After reading your paper, what should the reader think differently about?"
         Extract [INSIGHT: thesis_statement]
     |
=== Step 2: CHAPTER-BY-CHAPTER NEGOTIATION ===
     |
     For each chapter (Introduction -> Literature -> Method -> Results -> Discussion -> Conclusion):
     |
     +-> [socratic_mentor_agent] -> Probe the purpose and content of each chapter
     |
     |   Introduction:
     |   - "What sense of urgency should the reader feel by the end of this chapter?"
     |   - "After reading the Introduction, what should the reader expect to see next?"
     |   - "What is your research gap? State it in one sentence."
     |
     |   Literature Review:
     |   - "How many stories are you telling? What is the relationship between them?"
     |   - "What conclusion should your literature review ultimately lead to?"
     |   - "Is there an important work you disagree with? Why?"
     |
     |   Methodology:
     |   - "If someone challenges your method, how would you respond?"
     |   - "Is there a simpler method that could also answer your question? Why didn't you choose it?"
     |   - "What is the biggest limitation of your method? How do you handle it?"
     |
     |   Results:
     |   - "What is your most important finding? State it in one sentence."
     |   - "Were there any unexpected results? How do you explain them?"
     |   - "Is there any evidence in your data that does not support your hypothesis?"
     |
     |   Discussion:
     |   - "How do your results dialogue with existing literature?"
     |   - "What is the one thing you most want the reader to remember?"
     |   - "What recommendations does your research have for practice/policy?"
     |
     |   Conclusion:
     |   - "If you could only leave one paragraph, what would you say?"
     |   - "What future research directions does your study open up?"
     |
     At least 2 rounds of dialogue per chapter
     After each chapter concludes, [socratic_mentor_agent] extracts a Chapter Summary
     |
     +-> [structure_architect_agent] -> Produce complete outline based on all Chapter Summaries
     |
=== Step 3: ARGUMENT STRESS TEST ===
     |
     +-> [socratic_mentor_agent + argument_builder_agent]
         -> Probe evidence and logic for each sub-argument
         -> "Where is the weakest point in this argument?"
         -> "If you reverse your argument, does it still hold?"
         -> Final output: Chapter Plan (with core argument, supporting evidence, expected word count per chapter)
     |
Output: Chapter Plan + INSIGHT Collection
-> User can then use full mode to produce the complete paper
-> Or use academic-paper-reviewer to review the Chapter Plan

核心原则:以资深博导和学科方法论专家的视角,引导用户逐章思考论文的每个部分。不直接撰写,而是通过苏格拉底式对话帮助用户明确写作内容。
用户:"guide my paper" / "help me plan my paper"
     |
=== 步骤0:研究准备情况检查 ===
     |
     +-> [socratic_mentor_agent] -> 确认用户已有的材料
         - "你目前拥有哪些研究材料?(文献、数据、分析结果)"
         - "你的研究问题是否已确定?能否用一句话表述?"
         -> 若研究基础不足,建议先运行deep-research(苏格拉底模式)
     |
=== 步骤1:论点明确 ===
     |
     +-> [socratic_mentor_agent] -> 探究核心论点
         - "你的论文要论证什么?"
         - "持反对意见的人会如何回应?"
         - "读者读完你的论文后,应该在哪些观点上产生转变?"
         提取[INSIGHT: thesis_statement]
     |
=== 步骤2:逐章协商 ===
     |
 针对每个章节(引言 -> 文献综述 -> 研究方法 -> 研究结果 -> 讨论 -> 结论):
     |
     +-> [socratic_mentor_agent] -> 探究各章节的目的和内容
     |
     |   引言:
     |   - "读者读完本章后应感受到怎样的紧迫性?"
     |   - "读完引言后,读者接下来预期看到什么内容?"
     |   - "你的研究缺口是什么?用一句话表述。"
     |
     |   文献综述:
     |   - "你要讲述几个研究脉络?它们之间的关系是什么?"
     |   - "你的文献综述最终要得出什么结论?"
     |   - "是否有你不同意的重要研究?原因是什么?"
     |
     |   研究方法:
     |   - "若有人质疑你的方法,你会如何回应?"
     |   - "是否有更简单的方法也能回答你的研究问题?你为何不选择它?"
     |   - "你的方法最大的局限性是什么?你如何处理?"
     |
     |   研究结果:
     |   - "你最重要的发现是什么?用一句话表述。"
     |   - "是否有意外结果?你如何解释?"
     |   - "你的数据中是否有不支持假设的证据?"
     |
     |   讨论:
     |   - "你的研究结果如何与现有文献对话?"
     |   - "你最希望读者记住哪一点?"
     |   - "你的研究对实践/政策有哪些建议?"
     |
     |   结论:
     |   - "若只能留下一个段落,你会写什么?"
     |   - "你的研究为未来研究开辟了哪些方向?"
     |
     每章至少进行2轮对话
     每章结束后,[socratic_mentor_agent]提取章节摘要
     |
     +-> [structure_architect_agent] -> 根据所有章节摘要生成完整大纲
     |
=== 步骤3:论点压力测试 ===
     |
     +-> [socratic_mentor_agent + argument_builder_agent]
         -> 探究每个子论点的证据和逻辑
         -> "这个论点最薄弱的环节在哪里?"
         -> "若反转你的论点,是否仍然成立?"
         -> 最终输出:章节规划(包含核心论点、支持证据、各章节预期字数)
     |
输出:章节规划 + INSIGHT集合
-> 用户随后可使用full模式生成完整论文
-> 或使用academic-paper-reviewer评审章节规划

Handoff Protocol: deep-research -> academic-paper

交接协议:deep-research -> academic-paper

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.

intake_agent
会自动检测deep-research材料(研究问题简报 / 参考文献 / 文献综述 / INSIGHT集合),并跳过冗余步骤。完整交接材料格式详见
deep-research/SKILL.md
中的交接协议。

Failure Paths

失败路径

See
references/failure_paths.md
for details. Quick reference:
Failure ScenarioHandling Strategy
Insufficient research foundationRecommend running
deep-research
first
Wrong paper structure selectedReturn to Phase 2, suggest alternative structure
Word count significantly over/under targetIdentify problematic chapters, suggest trimming/expansion
Citation format entirely wrongRe-run the entire citation phase
Peer review rejectionAnalyze rejection reasons, suggest major revision or restructuring
Plan mode not convergingSuggest switching to outline-only mode
Incomplete handoff materialsList missing items, suggest supplementing or re-running
User abandons midwaySave completed Chapter Plan

详情请见
references/failure_paths.md
。快速参考:
失败场景处理策略
研究基础不足建议先运行
deep-research
论文结构选择错误返回阶段2,建议替代结构
字数显著超出/低于目标识别问题章节,建议删减/扩充
引用格式完全错误重新运行整个引用检查阶段
同行评审拒稿分析拒稿原因,建议大修或调整结构
规划模式无法收敛建议切换到outline-only模式
交接材料不完整列出缺失项,建议补充或重新运行
用户中途放弃保存已完成的章节规划

Full Academic Pipeline

完整学术流水线

See
academic-pipeline/SKILL.md
for the complete workflow.

完整工作流详见
academic-pipeline/SKILL.md

Phase 0: Configuration Interview

阶段0:配置访谈

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.

阶段0配置访谈的完整字段定义详见
agents/intake_agent.md
。访谈涵盖9项内容:论文类型、学科、目标期刊、引用格式、输出格式、语言、摘要、字数、已有材料。输出论文配置记录,等待用户确认。

Agent File References

Agent文件参考

AgentDefinition File
intake_agent
agents/intake_agent.md
literature_strategist_agent
agents/literature_strategist_agent.md
structure_architect_agent
agents/structure_architect_agent.md
argument_builder_agent
agents/argument_builder_agent.md
draft_writer_agent
agents/draft_writer_agent.md
citation_compliance_agent
agents/citation_compliance_agent.md
abstract_bilingual_agent
agents/abstract_bilingual_agent.md
peer_reviewer_agent
agents/peer_reviewer_agent.md
formatter_agent
agents/formatter_agent.md
socratic_mentor_agent
agents/socratic_mentor_agent.md
visualization_agent
agents/visualization_agent.md
revision_coach_agent
agents/revision_coach_agent.md

Agent定义文件
intake_agent
agents/intake_agent.md
literature_strategist_agent
agents/literature_strategist_agent.md
structure_architect_agent
agents/structure_architect_agent.md
argument_builder_agent
agents/argument_builder_agent.md
draft_writer_agent
agents/draft_writer_agent.md
citation_compliance_agent
agents/citation_compliance_agent.md
abstract_bilingual_agent
agents/abstract_bilingual_agent.md
peer_reviewer_agent
agents/peer_reviewer_agent.md
formatter_agent
agents/formatter_agent.md
socratic_mentor_agent
agents/socratic_mentor_agent.md
visualization_agent
agents/visualization_agent.md
revision_coach_agent
agents/revision_coach_agent.md

Reference Files

参考文件

ReferencePurposeUsed By
references/apa7_extended_guide.md
APA 7th extended guide (extends deep-research version)citation_compliance, draft_writer, formatter
references/apa7_chinese_citation_guide.md
APA 7.0 Chinese citation complete specification (Taiwan academic conventions)citation_compliance, draft_writer, formatter
references/citation_format_switcher.md
Multi-citation format switching rules (including Chinese formats)citation_compliance, formatter
references/paper_structure_patterns.md
6 paper structure patternsstructure_architect, intake
references/academic_writing_style.md
Academic writing style guidedraft_writer, peer_reviewer
references/hei_domain_glossary.md
Higher education terminology bilingual glossaryall agents (domain context)
references/journal_submission_guide.md
Journal submission guideformatter, intake
references/abstract_writing_guide.md
Abstract writing guideabstract_bilingual
references/latex_template_reference.md
LaTeX template referenceformatter
references/failure_paths.md
Failure path map (12 scenarios + handling strategies)all agents
references/mode_selection_guide.md
8 mode selection guide + transition pathsintake
references/credit_authorship_guide.md
CRediT 14 roles + ICMJE + AI policy + contribution matrixintake, formatter, draft_writer
references/funding_statement_guide.md
Taiwan/international funding formats + statement templatesintake, formatter, draft_writer
references/statistical_visualization_standards.md
APA 7.0 figure guidelines, accessible color palettes, chart type decision tree, matplotlib/ggplot2 code templatesvisualization
Also references from
deep-research
:
  • deep-research/references/apa7_style_guide.md
    — base APA 7 reference (this skill extends, not duplicates)

参考文件用途使用Agent
references/apa7_extended_guide.md
APA 7版扩展指南(基于deep-research版本扩展)citation_compliance, draft_writer, formatter
references/apa7_chinese_citation_guide.md
APA 7.0中文引用完整规范(台湾学术惯例)citation_compliance, draft_writer, formatter
references/citation_format_switcher.md
多引用格式转换规则(含中文格式)citation_compliance, formatter
references/paper_structure_patterns.md
6种论文结构模式structure_architect, intake
references/academic_writing_style.md
学术写作风格指南draft_writer, peer_reviewer
references/hei_domain_glossary.md
高等教育术语双语词汇表所有Agent(领域上下文)
references/journal_submission_guide.md
期刊投稿指南formatter, intake
references/abstract_writing_guide.md
摘要写作指南abstract_bilingual
references/latex_template_reference.md
LaTeX模板参考formatter
references/failure_paths.md
失败路径映射(12种场景+处理策略)所有Agent
references/mode_selection_guide.md
8种模式选择指南+转换路径intake
references/credit_authorship_guide.md
CRediT 14种角色 + ICMJE + AI政策 + 贡献矩阵intake, formatter, draft_writer
references/funding_statement_guide.md
台湾/国际资助格式+声明模板intake, formatter, draft_writer
references/statistical_visualization_standards.md
APA 7.0图表指南、无障碍调色板、图表类型决策树、matplotlib/ggplot2代码模板visualization
同时参考
deep-research
中的文件:
  • deep-research/references/apa7_style_guide.md
    — APA 7基础参考(本工具在此基础上扩展,而非重复)

Templates

模板

TemplatePurpose
templates/imrad_template.md
IMRaD structure template
templates/literature_review_template.md
Literature review template
templates/case_study_template.md
Case study template
templates/theoretical_paper_template.md
Theoretical paper template
templates/policy_brief_template.md
Policy brief template
templates/conference_paper_template.md
Conference paper template
templates/latex_article_template.tex
LaTeX starter template
templates/bilingual_abstract_template.md
Bilingual abstract template
templates/credit_statement_template.md
Author x Role contribution matrix + CRediT statement output
templates/funding_statement_template.md
Funding source registration + statement output
templates/revision_tracking_template.md
Systematic tracker for reviewer comments and resolutions during revision (4 status types: RESOLVED, DELIBERATE_LIMITATION, UNRESOLVABLE, REVIEWER_DISAGREE)

模板用途
templates/imrad_template.md
IMRaD结构模板
templates/literature_review_template.md
文献综述模板
templates/case_study_template.md
案例研究模板
templates/theoretical_paper_template.md
理论研究论文模板
templates/policy_brief_template.md
政策简报模板
templates/conference_paper_template.md
会议论文模板
templates/latex_article_template.tex
LaTeX入门模板
templates/bilingual_abstract_template.md
双语摘要模板
templates/credit_statement_template.md
作者×角色贡献矩阵 + CRediT声明输出
templates/funding_statement_template.md
资助来源登记+声明输出
templates/revision_tracking_template.md
修订阶段评审意见及解决方案的系统跟踪表(4种状态类型:已解决、刻意保留的局限性、无法解决、评审意见分歧)

Examples

示例

ExampleDemonstrates
examples/imrad_hei_example.md
Complete IMRaD paper example (higher education domain, English)
examples/literature_review_example.md
Literature review paper example
examples/plan_mode_guided_writing.md
Plan mode chapter-by-chapter guided dialogue example (blended learning topic)
examples/chinese_paper_example.md
Complete Chinese academic paper example (IMRaD, Chinese APA 7.0 citations)
examples/revision_mode_example.md
Revision mode complete workflow: peer review response + revision comparison table

示例展示内容
examples/imrad_hei_example.md
完整IMRaD论文示例(高等教育领域,英文)
examples/literature_review_example.md
文献综述论文示例
examples/plan_mode_guided_writing.md
规划模式下逐章引导对话示例(混合学习主题)
examples/chinese_paper_example.md
完整中文学术论文示例(IMRaD结构,中文APA 7.0引用)
examples/revision_mode_example.md
修订模式完整工作流:同行评审回复+修订对比表

Quality Standards

质量标准

Writing Quality

写作质量

  1. Every claim must have a citation or be supported by the paper's own data
  2. Zero citation orphans — in-text citations <-> reference list must perfectly match
  3. Consistent register — academic tone appropriate for the discipline
  4. Logical flow — clear transitions between paragraphs and sections
  5. Word count compliance — within +/-10% of target
  1. 所有主张必须有引用支持或由论文自身数据支撑
  2. 无孤立引用——文内引用与参考文献列表必须完全匹配
  3. 语气一致——采用符合学科要求的学术语气
  4. 逻辑连贯——段落和章节间过渡清晰
  5. 字数合规——与目标字数偏差在±10%以内

Bilingual Abstract Quality

双语摘要质量

  1. Independent writing — zh-TW and EN abstracts are independently composed, NOT mechanical translations
  2. Structural alignment — both abstracts cover the same key points in the same order
  3. Keywords — 5-7 per language, reflecting the paper's core concepts
  4. Word count — EN: 150-300 words; zh-TW: 300-500 characters
  1. 独立撰写——繁体中文和英文摘要为独立创作,而非机器翻译
  2. 结构对齐——两种语言的摘要涵盖相同要点且顺序一致
  3. 关键词——每种语言5-7个,反映论文核心概念
  4. 字数要求——英文:150-300词;繁体中文:300-500字

Citation Quality

引用质量

  1. Format compliance — 100% adherence to selected citation style
  2. DOI inclusion — every source with a DOI must include it
  3. Currency — flag sources older than 10 years (unless seminal works)
  4. Self-citation ratio — flag if >15%
  1. 格式合规——100%符合所选引用风格
  2. 包含DOI——所有有DOI的来源必须包含该标识
  3. 时效性——标记10年以上的文献(经典文献除外)
  4. 自引率——若自引率>15%则标记

Peer Review

同行评审

  1. Five dimensions — Originality (20%), Methodological Rigor (25%), Evidence Sufficiency (25%), Argument Coherence (15%), Writing Quality (15%)
  2. Actionable feedback — every criticism must include a specific suggestion
  3. Max 2 revision rounds — unresolved items become Acknowledged Limitations
  1. 五维度评分——原创性(20%)、方法严谨性(25%)、证据充分性(25%)、论点连贯性(15%)、写作质量(15%)
  2. 可执行反馈——每条批评必须包含具体建议
  3. 最多2轮修订——未解决项归入“已确认局限性”

Mandatory Inclusions

强制包含内容

  1. AI disclosure statement — every paper must include a statement on AI tool usage
  2. Limitations section — explicitly discuss study limitations
  3. Ethics statement — when applicable (human subjects, sensitive data)

  1. AI披露声明——每篇论文必须包含AI工具使用声明
  2. 局限性章节——明确讨论研究局限性
  3. 伦理声明——适用时(涉及人类受试者、敏感数据)

Output Language

输出语言

Follows the user's language. Academic terminology is kept in English. Bilingual abstracts are always provided regardless of the main text language.

遵循用户使用的语言。学术术语保留英文。无论正文语言如何,均提供双语摘要。

Integration with Other Skills

与其他工具的集成

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

academic-paper + tw-hei-intelligence  -> 基于真实MOE数据的循证高等教育论文
academic-paper + deep-research        -> 深度研究阶段 -> 论文写作阶段(自动交接)
academic-paper + report-to-website    -> 论文的交互式网页版本
academic-paper + notebooklm-slides-generator -> 基于论文的演示幻灯片
academic-paper + academic-paper-reviewer -> 同行评审 -> 修订循环

Version History

版本历史

VersionDateChanges
2.42026-03-08LaTeX output formatting hardening: mandatory
apa7
document class for APA 7.0 output; text justification fix (
ragged2e
+
etoolbox
to override apa7 man mode
\raggedright
); table column width formula (
(\linewidth - N\tabcolsep) * \real{proportion}
— prevents overflow); bilingual abstract centering (
\begin{center}\textbf{...}\end{center}
); font stack standardized (Times New Roman + Source Han Serif TC VF + Courier New);
xurl
for URL line breaking;
fancyvrb
Verbatim with
fontsize
for wide content; PDF must compile from LaTeX via tectonic (no HTML-to-PDF)
2.32026-03-08NEW visualization_agent (11th: publication-quality figures with matplotlib/ggplot2, APA 7.0, colorblind-safe); NEW revision_coach_agent (12th: standalone reviewer comment parser → Revision Roadmap); Socratic convergence criteria (4 signals: thesis clarity, chapter coherence, evidence mapping, limitation honesty) + question taxonomy (clarifying, probing, structuring, challenging); revision tracking template (4 status types); citation format conversion in formatter_agent (APA 7 ↔ Chicago ↔ MLA ↔ IEEE ↔ Vancouver); Quick Mode Selection Guide; 9th mode: revision-coach
2.22025-03-054-level argument strength scoring with quantified thresholds; plagiarism & retraction screening protocol; F11 Desk-Reject Recovery + F12 Conference-to-Journal Conversion failure paths; Plan -> Full mode conversion protocol; cross-skill reference to
shared/handoff_schemas.md
2.12026-03Added CRediT authorship guide, funding statement guide, 2 new templates (credit_statement_template, funding_statement_template); enhanced intake_agent with co-author + funding questions (Step 9-10); enhanced formatter_agent with CRediT + funding quality checks
2.02026-02NEW plan mode (Socratic guided chapter-by-chapter planning), deep-research handoff protocol, Chinese APA 7.0 citation guide, failure path handling, mode selection guide
1.02026-01Initial release: 9-agent pipeline, 6 paper types, 5 citation formats, bilingual abstracts, multi-format output
版本日期变更内容
2.42026-03-08强化LaTeX输出格式:APA 7.0输出强制使用
apa7
文档类;使用
raggedright
+
etoolbox
修复apa7 man模式下的文本对齐问题;新增
(\linewidth - N\tabcolsep)*\real{proportion}
表格列宽公式(防止溢出);双语摘要居中;标准化字体栈;新增
xurl
用于URL换行;
fancyvrb
环境支持宽内容的
fontsize
设置;PDF必须通过tectonic从LaTeX编译生成
2.32026-03-08新增visualization_agent(第11个:生成符合出版标准的matplotlib/ggplot2图表,支持APA 7.0、色盲友好调色板);新增revision_coach_agent(第12个:独立解析评审意见→修订路线图);苏格拉底式收敛标准(4个信号:论点清晰度、章节连贯性、证据映射、局限性坦诚度)+问题分类(澄清、探究、结构化、挑战);修订跟踪模板(4种状态类型);formatter_agent支持引用格式转换(APA 7 ↔ Chicago ↔ MLA ↔ IEEE ↔ Vancouver);新增快速模式选择指南;新增第9种模式:revision-coach
2.22025-03-054级论点强度评分及量化阈值;抄袭与撤稿筛查协议;F11 desk-reject恢复+F12会议论文转期刊论文失败路径;Plan→Full模式转换协议;跨工具引用
shared/handoff_schemas.md
2.12026-03新增CRediT作者指南、资助声明指南、2个新模板(credit_statement_template、funding_statement_template);intake_agent新增合著者+资助问题(步骤9-10);formatter_agent新增CRediT+资助质量检查
2.02026-02新增plan模式(苏格拉底式逐章引导规划)、deep-research交接协议、中文APA 7.0引用指南、失败路径处理、模式选择指南
1.02026-01初始版本:9-Agent流水线、6种论文类型、5种引用格式、双语摘要、多格式输出