Research
Plugin
academic-paper-writer
面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。
Plugin Signal64/100Solid
maintained96
capable46
documented50
adopted44
Install on Claude Code
> /plugin marketplace add joshua-zyy/academic-paper-writer> /plugin install academic-paper-writer@academic-paper-writer
What's inside
Skill(8 skills)
/academic-citationSearch, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work/academic-experimentsAudit, run, or verify experimental evidence for CS/AI/ML papers. Produces Evidence Inventory with evidence_type annotations (newly_run/preexisting_artifact/user_claim) and Protocol Risk assessments. Use when: checking if experiment results are reproducible, auditing existing/academic-figureCreate, revise, or audit academic data/result figures for CS/AI/ML papers. Data/result plots default to Python-generated editable SVG with CS/AI/ML-specific design rules for benchmarks, ablations, training dynamics, robustness, diagnostics, distributions, confusion matrices, and
README
Academic Paper Writer 是面向 CS / AI / ML 论文写作场景的 模块化、证据驱动 的 Agent Skill 集合。
这不是一个简单的一次性生成整篇论文的 prompt，而是一套工程化写作系统： 先把论文拆成多个可独立验证的环节，按证据审计 → 文献检索 → 实验复核 → 起草 → 质量门 → 验证的闭环逐节推进。每个环节都设硬门控，证据不足就阻塞或降级，绝不硬写。
核心思想在于将各位researcher从枯燥的论文写作中解放出来，将更多的时间与经历投入到对于论文/模型创新点的思考与设计当中。
💬 反馈与改进
🚧 开发进度
- Skills 一览
- 快速开始
- Claude Code 插件安装
- Codex CLI 安装
- 手动加载
- 推荐配置
- 核心设计
- 编排器核心工作流
- 使用示例
- 适用场景
- 文档分层
- 项目结构
- 安全边界
- 维护与验证
- 参考项目
| 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 |
选项 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 布局与浮动体放置
选项 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 的表现越稳定：
推荐模型
| 模型 | 说明 |
|---|---|
| 🚀 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 平台
| 平台 | 安装方式 | 更新方式 | 说明 |
|---|---|---|---|
| ⚡ OpenCode | git clone 到 ~/.agents/skills/ | 手动 git pull | 强烈推荐，对于本skill多智能体派发编排最适配，开源 Agent 平台，灵活可扩展 |
| 🤖 Claude Code | /plugin marketplace add + /plugin install | 自动更新（main分支）或手动 /plugin update | Anthropic 官方 CLI 工具，原生支持 Skill 机制，推荐使用 |
| 🔧 Codex CLI | git clone 到 ~/.agents/skills/ | 手动 git pull | OpenAI 代码助手，支持多种编程任务 |
💡 提示：使用支持 Skill 机制的 Agent 平台可获得最佳体验，其他平台也可通过加载 SKILL.md 文件使用本项目。
🔍 证据优先，逐节闭环
每一节经历固定闭环，不允许跳过任何环节：
┌─────────────────────────────────────────────────────────────┐
│ 逐节闭环（每节必须经历） │
│ │
│ ✏️ Draft v1 → 📌 占位符审计 → ⚖️ 证据合规审查 │
│ → ✨ Prose Gate → 📏 Expansion → ✅ Self-Review │
│ → Verification │
│ │ │
│ ├── passed ▶️ 推进下一节 │
│ └── failed 🔁 回到 ⚖️ 证据合规审查 重来 │
└─────────────────────────────────────────────────────────────┘
- 初稿可以带占位符，但占位符必须被记录、审计和追踪
Verification未通过时不能假装通过
🧩 Core + Subskills 架构
核心编排器负责：判断任务模式 → 确认 venue/language → 组织 section queue → 维护 cumulative draft → 吸收子 skill 的专项结果。
| Core 环节 | 委托 Skill | 处理方式 |
|---|---|---|
| 🏛️ 目标 Venue 调研 | academic-venue-research | dispatch 子 Agent |
| 🔍 文献检索与核验（含本地文献库优先 + subagent 全文阅读） | academic-citation + literature-reader-agent | dispatch 子 Agent |
| 🔬 实验证据复核 | academic-experiments | dispatch 子 Agent |
| 📊 数据图 / 实验结果图 | academic-figure | dispatch 子 Agent |
| ✨ Prose Quality Gate | academic-polishing | 内化调用（主 Agent 自行执行） |
| ✅ 证据审查与 Verification | academic-reviser | dispatch 子 Agent |
设计原则：主 Agent 直接撰写论文正文，确保叙事风格一致。子 Agent 仅提供工具型专项输出，不得直接修改 Cumulative Draft。
🚧 Hard Gates + 数据契约
五个不可跳过的基础关卡：
| Gate | 触发位置 | 核心条件 | 失败处理 |
|---|---|---|---|
| 🏛️ E：Venue 调研 | Step 1 → Step 5 | 若用户提供本地 PDF 文献库，Step 2 已验证 MD 目录；venue 确认后必须完成 Step 4 并生成 venue-brief.md | 阻塞，不得进入 Step 5 |
| 🔬 A：证据完备 | Step 5 → Step 9 | 至少一条可引用证据（newly_run 或 preexisting_artifact） | 降级路径或阻塞 |
| 📖 B：当前节引用就绪 | Step 6 → Step 9 | 当前 section 的关键 claims 有 VERIFIED 引用、Citation-to-Claim Map、项目证据或显式 [REF_NEEDED] debt | Intro/RW 阻塞；Method/Results 可带记录的 debt |
| 🚪 C：Verification | Step 9.8 → Step 10 | 所有 hard debt 闭合 + thin_draft=no | passed/blocked/failed |
| 📚 D：全文引用数量 | Step 11 → 输出 | 全文去重引用 >= min_citations | 未达标时提醒，可补充后重检 |
跨 skill 之间通过显式 数据契约 交换信息：
📦 Evidence Inventory # 实验证据盘点 → academic-experiments → orchestrator
✅ Verified References # 核验文献清单 → academic-citation → orchestrator
📖 LiteratureReadingReport # 文献阅读报告 → literature-reader-agent → orchestrator
📋 Verification Report # 验证状态报告 → academic-reviser → orchestrator
🗺️ Citation-to-Claim Map # 引用-主张映射 → academic-citation → orchestrator
File tree
FAQ
academic-paper-writer is a Claude Code plugin with 8 hand-picked skills, indexed on Flowy in the Research category. Install it with the command on its page. It includes academic-citation, academic-experiments, academic-figure. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is academic-paper-writer?
- 面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。
- How do I install academic-paper-writer?
- Run these in Claude Code: /plugin marketplace add joshua-zyy/academic-paper-writer then /plugin install academic-paper-writer@academic-paper-writer. Then prompt normally.
- Does academic-paper-writer auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is academic-paper-writer free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it