论文流水线 Linus-Shyu/papercraft

Papercraft

面向 AI 智能体的证据优先论文写作与评审。

Papercraft 是一个可移植的技能和命令行工具，覆盖完整的研究生命周期。给它一个题目，它就跑 调研 → 可行性 → 实验设计 → 执行 → 写作 → 审计 → 评审 → 接收 → 打包，每一步都有明确的检查点，关卡失败即停。

它能在 DSH、Claude Code、Cursor、Codex 里用，也能在任何能读 Markdown 指令文件的编辑器里用。它不是代笔：每个数字、每条引用、每个论断、每张浮动体，都必须能追溯到一份产物。

不保证零错误。 没有任何提示词或工具能保证 AI 永远不犯错。Papercraft 让错误可发现、可定位、可拦截：数字没有出处、引用没有核实、图没有正文引用，流水线就停下来。

为什么选 Papercraft

LLM 写的论文，翻车方式很固定：

- 引用是编的，或者张冠李戴；
- 重跑代码后，数字和代码对不上；
- 图是手工调出来的，看着对，却和正文矛盾；
- 所谓「消融」只是换了几句话，并没有真的删掉模块；
- 浮动体没有任何句子引用；
- 会议规则（页数限制、模板、匿名、检查清单）靠记忆背，而不是从 CFP 里读；
- 评审意见要求做不可能的实验，或者引用根本不存在的论文。

Papercraft 把每种翻车方式都变成一个关卡，配检查器、台账，或者写死的停止条件。

快速开始

纯聊天（推荐）。 装一次，然后直接跟编辑器说话：

git clone https://github.com/Linus-Shyu/papercraft.git
cd papercraft
./install.sh --all

在编辑器里打开一个文件夹，说：

写一篇关于 <题目> 的论文，投 <会议>。

就这一句提示词。默认值：./papercraft-paper、会议 AAAI、3 个问题、H1/H2/H3。如果编辑器没有自动路由，先说 用 papercraft。细节见 CHAT.md。

终端（可选）。

./papercraft new --topic "How should we evaluate step-by-step LLM tutoring?" \
--venue aaai --dir ~/papers/my-paper
./install.sh --project ~/papers/my-paper

在编辑器里打开 ~/papers/my-paper，新建一个对话，粘贴：

Run Papercraft Autopilot for this repo (the topic is in paper_state/plan.json).
读取 /absolute/path/to/papercraft/AUTOPILOT.md 并照它执行。
我只关心选题；最多问我 3 个问题。
不要编造结果或引用。停在 H1、H2、H3。

你最多回答三个问题（venue、constraints、must-use data/code），并批准三个检查点：

| 检查点 | 你会看到 | 你来选 |
| H1 | 3 个可证伪的研究问题 + venue | 选一个，或「你来定」 |
| H2 | 最小可发表单元、资源、go/no-go | go / 改范围 / 停 |
| H3 | PDF、模拟评审、录用风险 | 投稿 / 修改 |

其余全部自动化。如果以你手上的资源做不出来，你拿到的是一份计划和阴性结果，不是编出来的论文。

它做什么

flowchart LR
A[Topic] --> B[Survey]
B --> C[Feasibility]
C --> D[Experiment design]
D --> E[Execute]
E --> F[Template]
F --> G[Write]
G --> H[Audit]
H --> I[Review]
I --> J[Acceptance]
J --> K[Package]

| 阶段 | 产出 | 关卡 |
| 调研 / 新颖性 | 文献矩阵、最接近的 3 篇、delta | G3b |
| 可行性 | MPU、资源、go/no-go | G0 |
| 实验设计 | 卡片、对照、随机种子、判定规则 | G2/G8 |
| 执行 | 命令、输出、哈希 | G8 |
| 模板 | 官方样式文件 + 来源记录 | G6 |
| 写作 | 依据论点与数字生成 LaTeX 草稿 | G1–G4 |
| 审计 | 全部关卡，阻塞项已修复 | G2–G8 |
| 评审 | 3 个评审人设 + 打分 | G9 |
| 录用评估 | 风险备忘 + 风险区间 | G10 |
| 打包 | PDF、源码 zip、工件 zip | G11 |

关卡

| 关卡 | 问题 | 检查脚本 |
| G2 | 每个数字都能追溯到来源 | check_numbers.py |
| G3 | 每条引用都能核实 | check_citations.py |
| G3b | 调研覆盖了最接近的工作 | check_literature.py |
| G4 | 每个浮动体都有标签和正文引用 | check_floats.py |
| G5 | 没有身份或密钥泄露 | check_anonymity.py |
| G6 | 能编译，页数符合限制 | build.sh |
| G7 | 符号有定义、定界符配对、算式校验 | check_math.py |
| G8 | 代码确实跑过，输出对得上 | check_repro.py --run |
| G9 | 评审有证据支撑且前后一致 | score_review.py |
| G10 | 投稿前没有未解决的阻塞项 | score_acceptance.py |

适配哪些工具

| 编辑器 / 智能体 | 加载方式 |
| DSH | ~/.dsh/skills/papercraft（原生） |
| Claude Code | ~/.claude/skills/papercraft + CLAUDE.md |
| Cursor | ~/.cursor/skills/papercraft + .cursor/rules/papercraft.mdc |
| Codex | ~/.codex/skills/papercraft + AGENTS.md |
| Copilot / Cline / Windsurf / Continue | 项目规则（--project） |
| Aider / Zed / Gemini CLI | CONVENTIONS.md / .rules / GEMINI.md |
| 其他任何工具 | 粘贴 SKILL.md 的绝对路径 |

激活方式和 5 分钟冒烟测试见 EDITORS.md。

安装

./install.sh --all # native dirs for DSH, ~/.agents, Claude, Cursor, Codex
./install.sh --project DIR # project dirs + pointers inside one paper repo
./install.sh --list # show the matrix
./install.sh --uninstall --project DIR

对于不支持原生技能的编辑器，--project 是必填项。指针是标记块；已有的用户内容会备份一次，--uninstall 只删除 Papercraft 的块。

会议目录

papercraft venues 按领域、类型和周期列出 37 个活跃 AI 会议。它不附带截稿日期：每一行都是 UNVERIFIED，直到你打开官方 CFP 并标记它。

papercraft venues --area nlp
papercraft venues --type journal
papercraft venues-mark --id acl --status in_review \
--source-url https://... --verified-on 2026-10-17 --dir ~/papers/my-paper

见 guides/conferences.md。

手动使用

自动驾驶是可选的。每个阶段也是一个命令：

papercraft status --dir ~/papers/my-paper
papercraft next --dir ~/papers/my-paper
papercraft mark survey done --note "12 rows, 3 closest"
papercraft template --venue aaai --url https://.../aaai2027-kit.zip
papercraft check --dir ~/papers/my-paper --with-repro
papercraft recommend --dir ~/papers/my-paper --reviews review/*.json
papercraft resubmit --dir ~/papers/my-paper --to acl --url https://.../acl-style.zip
papercraft venues --area nlp
papercraft venues-mark --id acl --status in_review --source-url https://...
papercraft package --dir ~/papers/my-paper

如果论文被拒，recommend 会根据评审类别生成一份会议候选清单，resubmit 会归档旧样式文件、获取新模板、更新项目状态，并写入 RESUBMISSION.md。

文档

| 文件 | 涵盖内容 |
| START_HERE.md | 3 步快速上手 |
| CHAT.md | 纯聊天体验：打开文件夹，提及技能，粘贴一条消息 |
| AUTOPILOT.md | 完整流水线、提示词、检查点、停止条件 |
| EDITORS.md | 各编辑器的激活与故障排查 |
| WRITING.md | 逐节写作手册 |
| REVIEWING.md | 对抗式评审与打分 |
| guides/resubmission.md | 拒稿分诊、会议候选清单、模板切换 |
| conferences/ | 10 个会议配置档 + 模板/匹配元数据 |
| VERIFICATION.md | 实际运行了什么，还有什么未验证 |

仓库结构

SKILL.md skill contract: modes, prime directive, gates
START_HERE.md user quickstart
CHAT.md chat-only UX (no terminal)
AUTOPILOT.md end-to-end runbook
EDITORS.md per-editor activation
WRITING.md writing playbook
REVIEWING.md reviewing playbook
conferences/ venue profiles, template sources, fit signals
guides/ evidence, citations, math, repro, acceptance, resubmission
templates/ 台账、注册表、评审/验收表 scripts/ 检查器、命令行、构建/审计 examples/ 一篇通过所有关卡的小论文 assets/ logo + 社交预览图

安全与限制

- 不编造实验。 如果最小可发表单元跑不起来，Papercraft 停在可行性阶段，交付一份计划。
- 不编造引用。 DOI/arXiv/ACL 页面必须打开；否则该条目记为 UNVERIFIED，不进入 PDF。
- 不猜模板。 conferences/templates.json 出厂时 url: null；你提供一次官方 URL，Papercraft 记录来源。
- 不保证录用。 录用环节是一份风险备忘，不是预测。
- 不替代同行评审。 模拟审稿人是一道检查，不是决定。
- 检查器有局限。 check_math 不证明推导；check_citations 只做结构检查（元数据需要人或智能体打开页面）；check_repro 信任给它的清单命令。

开发

无第三方 Python 依赖。构建测试需要 LaTeX。

make lint # profiles + Python compile
make test # smoke, unit, install, autopilot, template, resubmit
make test-fast # the subset that does not need LaTeX

贡献

见 CONTRIBUTING.md。欢迎的贡献：经过核实的会议配置档、带测试的新检查器、失败模式案例研究、更清晰的规则。请不要添加鼓励隐藏局限或编造结果的规则。

许可证

MIT。见 LICENSE。

引用

@software{papercraft2026,
title = {Papercraft: Evidence-first paper writing and review for AI agents},
author = {{Papercraft contributors}},
year = {2026},
url = {https://github.com/Linus-Shyu/papercraft}
}