alterlab-paper-writer

学术论文 — 学术论文写作 Agent 团队

通用学术论文写作工具——包含 12 个 Agent 的流程，覆盖所有学科，并默认以高等教育领域为参考。v2.4 强化了 LaTeX 输出格式：APA 7.0 必须使用 apa7 文档类，为 man 模式覆盖文本两端对齐设置，采用扣除 \tabcolsep 的表格列宽公式，使双语摘要居中，标准化字体组合（Times New Roman + Source Han Serif TC VF + Courier New），并通过 tectonic 编译 PDF。

快速开始

最简命令：

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

---

何时使用此技能

触发关键词

英语：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

土耳其语：makale yaz, akademik makale, makale taslağı, özet yaz, makaleyi revize et, literatür taraması makalesi, atıfları kontrol et, LaTeX'e dönüştür, bildiri, dergi makalesi, tez bölümü, hakem yorumları, revizyon planı, makalemi planlamama yardım et

繁体中文：寫論文, 學術論文, 論文大綱, 寫摘要, 修改論文, 文獻回顧論文, 檢查引用, 轉 LaTeX, 轉換格式, 研討會論文, 期刊文章, 學位論文, 研究論文, 引導我寫論文, 幫我規劃論文, 逐章規劃, 論文架構, 逐步寫論文, 寫方法論, 寫討論, 審查意見, 修訂路線圖, 幫我修改, 我收到審查意見, 轉換引用格式

计划模式激活

当用户的意图符合以下任一模式时，无论使用何种语言，都应激活 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”、“「引導我寫論文」「幫我規劃論文」”，或任何语言中的同义表达

不会触发

场景	改用
深度研究 / 事实核查（非论文写作）	alterlab-deep-research
评审论文（结构化评审）	alterlab-paper-reviewer
从研究到论文的完整流程	alterlab-research-pipeline
检查草稿中的参考文献是否真实存在且未被撤稿（反幻觉审计）	alterlab-citation-verifier
将某一节的笔记转化为润色后的正文，不进行配置访谈，也不使用 Agent 流程	alterlab-scientific-writing

在 Claude Code 中，逐条回复审稿意见（每条意见由一个起草 Agent 负责，并进行一致性检查）以 /alterlab-workflows:rebuttal 的形式提供（参见 alterlab-research-workflows）。

与 alterlab-deep-research 的区别

特性	alterlab-paper-writer	alterlab-deep-research
主要输出	可发表的论文初稿	研究报告
结构	符合期刊要求（IMRaD 等）	APA 7.0 报告
引用格式	多种格式（APA/Chicago/MLA/IEEE/Vancouver）	仅 APA 7.0
摘要	双语（英文 + 作者使用的语言）	单语
同行评审	模拟五维评审	编辑评审
输出格式	LaTeX/DOCX/PDF/Markdown	仅 Markdown
修订轮次	最多 2 轮，并提供有针对性的反馈	最多 2 轮

---

Agent 团队（12 个 Agent）

#	Agent	职责	阶段
1	intake_agent	配置访谈：论文类型、学科、期刊、引用格式、输出格式、语言、字数；检测交接需求；Plan 模式下简化访谈	阶段 0
2	literature_strategist_agent	设计搜索策略、筛选来源、编写带注释的参考书目、整理文献矩阵	阶段 1
3	structure_architect_agent	选择论文结构、制定详细大纲、分配字数、绘制证据映射	阶段 2
4	argument_builder_agent	构建论证、整理主张与证据链、梳理逻辑脉络、处理反论点；Plan 模式下进行论证压力测试	阶段 3 / Plan 步骤 3
5	draft_writer_agent	逐节撰写完整初稿、调整学科文风、跟踪字数	阶段 4
6	citation_compliance_agent	核验引用格式、检查参考文献列表是否完整、核查 DOI	阶段 5a
7	abstract_bilingual_agent	撰写双语摘要（英文 + 第二语言）及各语言的关键词	阶段 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	Plan 模式下的苏格拉底式导师：逐章指导、设置收敛标准（4 个信号）、问题分类体系（4 种类型）、提取 INSIGHT	Plan 步骤 0-3
11	visualization_agent	解析论文数据并生成符合发表质量的图表代码（Python matplotlib / R ggplot2），采用 APA 7.0 格式、适合色觉障碍者的调色板，并集成 LaTeX	阶段 4 / 阶段 7
12	revision_coach_agent	将非结构化评审意见解析为结构化修订路线图；对意见进行分类、映射和优先级排序；无需先运行流水线即可独立使用	Revision-Coach 模式

---

输出格式

文本格式

LaTeX (.tex + .bib)、DOCX（通过 Pandoc）、PDF（通过 LaTeX 或 Pandoc）、Markdown。

图表

当论文包含定量结果时，visualization_agent 可以使用 Python（matplotlib/seaborn）或 R（ggplot2）生成符合发表要求的图表，采用 APA 7.0 格式和适合色觉障碍者的调色板。图表将以可运行代码和 LaTeX \includegraphics 集成代码的形式交付。图表类型决策树和代码模板请参阅 references/statistical_visualization_standards.md。

引用格式

APA 7.0（默认）、Chicago（作者-日期或注释-书目）、MLA 9、IEEE、Vancouver。formatter_agent 支持在后期通过“Convert citations to [format]”在任意两种受支持格式之间转换引用格式。

---

编排工作流（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 / the author's language, e.g. TR or zh-TW / bilingual sections)
         - Bilingual abstract (EN + second language, default: the user's language / EN-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)
         - Second-language abstract (structured; length per journal, e.g. TR Öz ~150-250 words)
         - EN keywords (5-7)
         - Second-language keywords (count per the journal)
         - 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 alterlab-research-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

检查点规则

1. 阶段 0 -> 1：用户必须确认论文配置记录
2. 阶段 2 -> 3：用户必须批准大纲（可要求重构）
3. 阶段 6：最多进行 2 轮修订；未解决的事项归入“已确认的局限性”
4. 同行评审：严重级别的问题会阻止流程进入阶段 7
5. 如果用户提供了自己的来源，可以跳过阶段 1（文献）

---

运行模式（9 种模式）

详情请参阅 references/mode_selection_guide.md。

模式	触发语句	Agent	输出
full	“撰写论文”	Agent 1-9（定量研究时另加 visualization_agent）	完整论文初稿（适用时包含图表）
outline-only	“论文大纲”	1->2->3	详细大纲 + 证据图谱
revision	“修改论文”	8->5->6	带修订痕迹的修订稿（使用 templates/revision_tracking_template.md）
abstract-only	“撰写摘要”	1->7	双语摘要 + 关键词
lit-review	“文献综述”	1->2	注释书目 + 综合分析
format-convert	“转换为 LaTeX” / “将引文转换为 [格式]”	仅 9	格式化后的文档；包括引文格式转换（APA 7 / Chicago / MLA / IEEE / Vancouver）
citation-check	“检查引文”	仅 6	引文错误报告
plan	“指导我的论文” / “帮我规划论文”	1->10->3->4	章节计划 + INSIGHT 集合
revision-coach	“解析审稿意见” / “修订路线图” / “我收到了审稿人意见”	仅 12	修订路线图 + 可选的跟踪模板 + 回复信框架

快速模式选择指南

你的情况	推荐模式
从零开始，且已有明确的研究问题（RQ）	full
写作前需要规划方面的帮助	plan
只需要大纲	outline-only
已有初稿并收到评审反馈	revision
收到未整理的审稿意见	revision-coach
只需要摘要	abstract-only
需要检查／修正引文	citation-check
需要转换格式（LaTeX、DOCX）或引文样式	format-convert
想撰写系统性文献综述论文	lit-review

不确定？从 plan 开始——它会逐步引导你。

模式选择逻辑

"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

---

规划模式：逐章引导规划

核心原则：以资深博士生导师和学科方法论专家的视角，引导用户逐章思考论文的每个部分。不直接代写，而是通过苏格拉底式对话帮助用户明确想写的内容。

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 alterlab-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 alterlab-paper-reviewer to review the Chapter Plan

---

交接协议：alterlab-deep-research -> alterlab-paper-writer

intake_agent 会自动检测 alterlab-deep-research 材料（RQ Brief / Bibliography / Synthesis / INSIGHT Collection），并跳过重复步骤。完整的交接材料格式请参阅 alterlab-deep-research/SKILL.md 中的 Handoff Protocol。

---

失败处理路径

详情请参阅 references/failure_paths.md。快速参考：

失败情形	处理策略
研究基础不足	建议先运行 alterlab-deep-research
选错论文结构	返回第 2 阶段，建议采用其他结构
字数明显超出／不足目标	找出有问题的章节，建议删减或扩充
引文格式完全错误	重新执行整个引文阶段
同行评审被拒	分析拒稿原因，建议大幅修改或重组结构
规划模式未能收敛	建议切换到仅大纲模式
交接材料不完整	列出缺失项目，建议补充或重新运行
用户中途放弃	保存已完成的章节计划

---

完整学术工作流

完整工作流请参阅 alterlab-research-pipeline/SKILL.md。

---

阶段 0：配置访谈

阶段 0 配置访谈的完整字段定义请参阅 agents/intake_agent.md。访谈涵盖 9 个项目：论文类型、学科、目标期刊、引文格式、输出格式、语言、摘要、字数和现有材料。访谈将生成论文配置记录，并等待用户确认。

---

Agent 文件参考

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

---

参考文件

参考文件	用途	使用者
references/apa7_extended_guide.md	APA 第 7 版扩展指南（扩展自 alterlab-deep-research 版本）	citation_compliance、draft_writer、formatter
references/apa7_chinese_citation_guide.md	APA 7.0 中文引文完整规范（台湾学术惯例）	citation_compliance、draft_writer、formatter
alterlab-tr-academic-style (turkish-academia)	土耳其语学术风格与 TR Dizin 文章要求（Öz/Abstract、声明、引文惯例）	draft_writer、abstract_bilingual、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	模式选择指南及转换路径	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

也参考了 alterlab-deep-research 中的文件：

• alterlab-deep-research/references/apa7_style_guide.md — APA 7 基础参考（此技能在其基础上扩展，而非重复）

---

模板

模板	用途
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 种状态：RESOLVED、DELIBERATE_LIMITATION、UNRESOLVABLE、REVIEWER_DISAGREE）

---

示例

示例	展示内容
examples/imrad_hei_example.md	完整的 IMRaD 论文示例（高等教育领域，英文）
examples/literature_review_example.md	文献综述论文示例
examples/plan_mode_guided_writing.md	按章节引导的 Plan 模式对话示例（混合式学习主题）
examples/chinese_paper_example.md	完整的中文学术论文示例（IMRaD，中文 APA 7.0 引用）
examples/revision_mode_example.md	Revision 模式完整工作流：同行评审回复 + 修订对比表

---

质量标准

写作质量

1. 每项论断都必须有引文，或由论文自身的数据支持
2. 不得出现孤立引文——文内引文与参考文献列表必须完全对应
3. 语体一致——学术语调应符合学科规范
4. 逻辑流畅——段落和章节之间的过渡清晰
5. 字数达标——与目标字数相差不超过 ±10%

双语摘要质量

6. 独立撰写——两份摘要应分别独立撰写，而非机械翻译
7. 结构对应——两份摘要应按相同顺序涵盖相同要点
8. 关键词——每种语言 5-7 个，体现论文的核心概念
9. 长度——EN：150-300 词；第二语言：遵循期刊限制（默认值见 agents/abstract_bilingual_agent.md）

引用质量

10. 格式合规——100% 遵循所选引用格式
11. DOI 收录——每个带 DOI 的来源都必须注明 DOI
12. 时效性——标记超过 10 年的来源（奠基性著作除外）
13. 自引比例——超过 15% 时标记

同行评审

14. 五个维度——原创性（20%）、方法严谨性（25%）、证据充分性（25%）、论证连贯性（15%）、写作质量（15%）
15. 可执行的反馈——每条批评都必须附有具体建议
16. 最多 2 轮修订——未解决的问题转为“已承认的局限”

必须包含的内容

17. AI 使用声明——每篇论文都必须包含 AI 工具使用声明
18. 局限性章节——明确讨论研究局限性
19. 伦理声明——适用时提供（涉及人类受试者或敏感数据时）

---

与其他技能集成

alterlab-paper-writer + alterlab-deep-research   -> Deep research phase -> paper writing phase (auto-handoff)
alterlab-paper-writer + alterlab-paper-reviewer  -> Peer review -> revision loop
alterlab-paper-writer + alterlab-research-pipeline -> Paper-writing stage within the full research-to-publication pipeline

属于 AlterLab Academic Skills 套件。