academic-paper-writer

📝 Academic Paper Writer 证据驱动 · 分节闭环 · 模块协作 · 硬门控 · 可验证

---

Academic Paper Writer 是面向 CS / AI / ML 论文写作场景的 模块化、证据驱动 的 Agent Skill 集合。

你是否也遇到过这些论文写作焦虑？

🤷 无从下笔 — 模型代码全部跑通，对着空白文档却不知第一句话写什么

📐 表述不准 — 算法和公式在脑中模糊，只有大概的思路

🎨 图表头秃 — 实验数据堆了一桌子，论文级的可视化不知道从何画起

🔍 缺少支点 — 直觉上知道自己的工作有意义，但找不到让 reviewer 信服的论证锚点

这不是一个简单的一次性生成整篇论文的 prompt，而是一套工程化写作系统： 先把论文拆成多个可独立验证的环节，按证据审计 → 文献检索 → 实验复核 → 起草 → 质量门 → 验证的闭环逐节推进。每个环节都设硬门控，证据不足就阻塞或降级，绝不硬写。

核心思想在于将各位researcher从枯燥的论文写作中解放出来，将更多的时间与经历投入到对于论文/模型创新点的思考与设计当中。

---

💬 反馈与改进

独自迭代与维护这个项目，必然会陷入思维逻辑的困境 非常重视与欢迎各位 researcher 提出在实际使用中遇到的问题以及对项目的改进想法

🐛 遇到问题 💡 有改进建议 🤔 有疑问

工作流卡住、gate 误判、文档不清晰 觉得某个步骤可以优化、需要新的 skill 或 probe 不确定某个设计为什么这样、或者想了解最佳实践

每条 issue 描述清楚复现步骤或期望行为即可，我会定期查看并纳入迭代计划

---

🚧 开发进度

项目正在积极优化中，欢迎各位 researcher star 和 fork 项目，一起推动项目发展

---

📑 目录

• Skills 一览
• 快速开始
  • Claude Code 插件安装
  • Codex CLI 安装
  • 手动加载
• 推荐配置
• 核心设计
• 编排器核心工作流
• 使用示例
• 适用场景
• 文档分层
• 项目结构
• 安全边界
• 维护与验证
• 参考项目

---

📋 Skills 一览

Skill	角色	用途	典型触发词
🧠 academic-paper-writer	核心编排器	完整论文起草、section loop、Hard Gates、子 skill 调度	写论文、paper draft
🔍 academic-citation	文献取证	文献检索、核验、Citation-to-Claim 映射、本地文献库优先搜索、subagent 全文阅读、Exemplar Set	找引用、citation pass
🔬 academic-experiments	实验取证	实验证据盘点、最小可复核执行、协议风险审计	复核实验、verify results
✅ academic-reviser	审稿人	证据审查、三轮自审、Verification 判定	审修、self review
✨ academic-polishing	文体打磨	Prose Quality Gate、Claim Strength Audit、去 AI 化	润色、claim strength
📊 academic-figure	数据图生成	实验数据图（Python 代码）、图表审查与修改；架构图只记录手工绘制需求	绘图、训练曲线、消融实验
🏛️ academic-venue-research	期刊调研	调研目标 venue 投稿要求与写作风格，产出标准化 Venue Brief	期刊调研、venue research、投稿要求
📐 academic-latex-layout	latex排版	学术论文 LaTeX 布局、图表浮动体放置、模板适配与布局修复（独立调用）	LaTeX 布局、float placement、layout repair

---

🚀 快速开始

方式一：Claude Code 插件安装（推荐）

选项 A：开发版（自动更新）

使用 main 分支，每次启动 Claude Code 自动获取最新版本。

# 1. 添加 marketplace（main 分支）
/plugin marketplace add joshua-zyy/academic-paper-writer

# 2. 安装插件
/plugin install academic-paper-writer@academic-paper-writer

💡 自动更新：main 分支版本无需手动更新，每次启动 Claude Code 会自动检测并同步最新代码。

选项 B：稳定版（手动更新）

使用 stable 分支，只获取经过测试的稳定版本。

# 1. 添加 marketplace（stable 分支）
/plugin marketplace add joshua-zyy/academic-paper-writer@stable

# 2. 安装插件
/plugin install academic-paper-writer@academic-paper-writer

⚠️ 手动更新：稳定版需要手动执行更新命令：

/plugin update academic-paper-writer@academic-paper-writer

版本对比

版本	分支	更新方式	适用场景
开发版	main	自动更新	开发者、早期用户、想要最新功能
稳定版	stable	手动更新	生产环境、稳定性要求高的用户

安装后可用命令

• /academic-paper-writer - 完整论文工作流
• /academic-citation - 文献检索与核验
• /academic-experiments - 实验复核
• /academic-reviser - 审稿验证
• /academic-polishing - 文体打磨
• /academic-figure - 图表生成
• /academic-venue-research - 期刊调研
• /academic-latex-layout - LaTeX 布局与浮动体放置

方式二：Codex CLI 安装

选项 A：开发版（main 分支）

# 克隆到用户级目录（推荐）
git clone https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer

选项 B：稳定版（stable 分支）

# 克隆 stable 分支到用户级目录
git clone -b stable https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer

选项 C：指定版本（tag）

# 克隆特定版本
git clone -b v1.0.0 https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer

更新插件

# 进入 skill 目录
cd ~/.agents/skills/academic-paper-writer

# 拉取最新代码（main 分支）
git pull

# 或切换到 stable 分支
git checkout stable
git pull

# 或切换到特定版本
git checkout v1.0.0

版本对比

版本	分支/标签	更新方式	适用场景
开发版	main	git pull	开发者、早期用户
稳定版	stable	git pull	生产环境
指定版本	v1.0.0 等	手动切换	需要锁定版本

方式三：手动加载

git clone https://github.com/joshua-zyy/academic-paper-writer.git

在支持 Skill 机制的 Agent 平台中加载对应 SKILL.md：

场景	加载方式
📄 完整论文工作流	加载 skills/academic-paper-writer/SKILL.md
🎯 单一专项任务	直接加载对应子 skill 的 SKILL.md

本项目本身不依赖额外 Python 包或 Node 运行时，主要内容是 skill 文档、reference、schema 和辅助脚本。

可选依赖

以下 Python 脚本为可选工具，按需安装：

脚本	用途	依赖
skills/academic-citation/scripts/convert-pdfs-to-md.py	将本地 PDF 文献转换为 Markdown（默认使用 MinerU API，含图片提取与索引生成）	Python 3.10+, MinerU API Token
scripts/check_schemas.py	验证跨技能 schema 一致性	Python 3.12+

3. 准备输入材料

越完整的输入，skill 的表现越稳定：

📂 代码仓库路径 🏛️ 目标会议 / 期刊 🌐 写作语言 📊 实验日志 / CSV 📄 已有草稿 / outline 📝 研究摘要 / 贡献点

---

⚙️ 推荐配置

推荐模型

模型	说明
🚀 gpt-5.5	anyRouter中提供免费的api，需要使用vpn+教育邮箱/linux do账号注册，地址: https://anyrouter.top/register?aff=hZXa
🚀 claude-4.8	agentRouter中提供免费的api，需要使用github账号注册，地址: https://agentrouter.org/register?aff=Wpuc
🚀 DeepSeek V4 Flash	token价格低，且是推理模型支持1m上下文，可以用于测试skill效果，缺点是无多模态能力

推荐 Agent 平台

| 平台 | 安装方式 | 更新方式 | 说明