academic-paper-writer
joshua-zyy · joshua-zyy/academic-paper-writer
A modular, evidence-driven Claude Code agent skill set designed for writing academic papers in CS/AI/ML fields, progressing section by section with hard gates.
面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。
Preview
What you can do with it
- Draft a literature review section for a machine learning paper, driven by evidence.
- Generate an experimental setup section for an AI research paper.
- Verify citations and evidence against a local document library during paper writing.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
📝 Academic Paper Writer 证据驱动 · 分节闭环 · 模块协作 · 硬门控 · 可验证
Academic Paper Writer 是面向 CS / AI / ML 论文写作场景的 模块化、证据驱动 的 Agent Skill 集合。
你是否也遇到过这些论文写作焦虑？
🤷 无从下笔 — 模型代码全部跑通，对着空白文档却不知第一句话写什么
📐 表述不准 — 算法和公式在脑中模糊，只有大概的思路
🎨 图表头秃 — 实验数据堆了一桌子，论文级的可视化不知道从何画起
🔍 缺少支点 — 直觉上知道自己的工作有意义，但找不到让 reviewer 信服的论证锚点
这不是一个简单的一次性生成整篇论文的 prompt，而是一套工程化写作系统： 先把论文拆成多个可独立验证的环节，按证据审计 → 文献检索 → 实验复核 → 起草 → 质量门 → 验证的闭环逐节推进。每个环节都设硬门控，证据不足就阻塞或降级，绝不硬写。
核心思想在于将各位researcher从枯燥的论文写作中解放出来，将更多的时间与经历投入到对于论文/模型创新点的思考与设计当中。
💬 反馈与改进
独自迭代与维护这个项目，必然会陷入思维逻辑的困境 非常重视与欢迎各位 researcher 提出在实际使用中遇到的问题以及对项目的改进想法
🐛 遇到问题 💡 有改进建议 🤔 有疑问
工作流卡住、gate 误判、文档不清晰 觉得某个步骤可以优化、需要新的 skill 或 probe 不确定某个设计为什么这样、或者想了解最佳实践
每条 issue 描述清楚复现步骤或期望行为即可，我会定期查看并纳入迭代计划
🚧 开发进度
项目正在积极优化中，欢迎各位 researcher star 和 fork 项目，一起推动项目发展
📑 目录
📋 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 平台
| 平台 | 安装方式 | 更新方式 | 说明