🤷
无从下笔
模型代码已经跑通，但面对空白文档，不知道如何落笔
Why it exists
论文不是做完就会自然写出来
很多研究者真正卡住的地方，不是没有做工作，而是无法把工作转化为 reviewer 能理解、能相信的论证
📐
表述不准
算法和公式在脑中只是大概思路，写出来容易含糊或过度概括
🎨
图表头秃
实验数据很多，但不知道如何变成论文级、可解释的可视化
🔍
缺少支点
直觉上知道工作有意义，却缺少能支撑 claim 的文献和实验锚点
核心思想: 把论文写作拆成多个可独立验证的环节，通过证据审计 → 文献检索 → 实验复核 → 起草 → 质量门 → 验证的闭环逐节推进证据不足时，系统会阻塞、降级或保留占位符，而不是强行写成已验证结论
Skill System
Core 编排器 + 5 个专项 Subskills
主 Agent 保持论文叙事风格一致，子 skill 只提供文献、实验、审修、润色和图表等工具型输出
🧠
academic-paper-writer
核心编排器，负责完整论文起草、section loop、Hard Gates 和子 skill 调度
写论文paper draftorchestrator
🔍
academic-citation
文献检索、核验、Citation-to-Claim 映射、本地文献库优先搜索与全文阅读
找引用citation passVERIFIED
🔬
academic-experiments
盘点实验日志、checkpoint 和结果表，并用最小可复核方式确认实验事实
复核实验verify resultsrisk audit
✅
academic-reviser
以审稿人视角执行证据审查、三轮自审和 Verification 判定
审修self reviewverification
✨
academic-polishing
执行 Prose Quality Gate、Claim Strength Audit 和论文语气打磨
润色claim strengthprose gate
📊
academic-figure
生成实验数据图的 Python 代码，并辅助构思架构图提示词
绘图训练曲线architecture
Workflow
逐节闭环，失败就回退
每一节都必须经过占位符审计、证据合规审查、文体质量门、内容密度检查与最终验证
✏️ Draft v1允许占位符
📌 Placeholder Audit记录和追踪 debt
⚖️ Evidence Checkclaim 与证据匹配
✨ Prose Gate可读性与学术语气
📏 Expansion内容密度检查
✅ Self Review三轮自审
🔒 Verification通过才推进
Gate A · 证据完备
至少存在一条可引用证据，否则降级或阻塞
Gate B · 引用就绪
Introduction / Related Work 零 VERIFIED 引用时必须阻塞
Gate C · Verification
所有 debt 闭合且内容达标后，才能进入下一节
Gate D · 引用数量
全文默认要求去重引用不少于 35 篇
Dispatch Model
编排器派发 sub-agent，各司其职
核心编排器不直接处理所有任务——写作前通过并行 probe-agent 探查项目，调研阶段顺序派发引用核验和实验复核，章节循环中按需派发图表生成和终审验证；润色则由编排器内化调用规则自行完成，确保文体风格一致
主编排器 ──┬── 引用核验 ──── 文献检索与 VERIFIED 判定 ├── 实验复核 ──── 实验日志与结果表核验 ├── 润色 ──────── Prose Gate · Claim 强度审计 (内化执行) ├── 图表生成 ──── 数据可视化与架构图代码 └── 终审验证 ──── 审稿人视角 · 三轮自审 并行探查 → 顺序调研 → 章节循环 · 统一 Gate 管控
Quick Start
三步走：
加载 → 派发 → 汇总
① 加载编排器
加载核心 SKILL.md，自动注册 5 个 built-in sub-agent 及其能力边界
② 按阶段派发
并行探查（probe-agent）→ 并行文献阅读（reader-agent）→ 顺序调研（citation、experiments）→ 章节循环（figure、reviser）
③ 汇总验证
编排器收集各 agent 输出，执行 Hard Gates 验证，通过后推进到下一节
# 将以下命令复制到你的 agent 中执行
git clone https://github.com/joshua-zyy/academic-paper-writer.git
load skills/academic-paper-writer/SKILL.md
# 编排器按阶段派发 sub-agent
# 并行探查（写作前，同时 dispatch 3 个 probe-agent）
task("code_structure", probe-agent)
task("data_artifacts", probe-agent)
task("config", probe-agent)
# 并行文献阅读（同时 dispatch N 个 reader-agent）
task("lit_read", literature-reader-agent)
# 调研阶段（顺序执行）
task("引用核验", academic-citation)
task("实验复核", academic-experiments)
# 章节循环（每节重复，顺序执行）
task("图表生成", academic-figure)
task("终审验证", academic-reviser)
# 润色由编排器内化执行
Fit
适合什么，不适合什么
✅ 适合
- 已有代码仓库、实验日志、结果表、草稿或研究笔记
- 需要逐节推进完整论文，而不是一次性成稿
- 希望明确区分“能写的”和“暂时不能下结论的”
- 需要对文献、实验和 claim 强度做显式控制
❌ 不适合
- 非 CS / AI / ML 领域论文
- 只想要一个一次性生成全文的通用 prompt
- 纯排版或 LaTeX 调整任务
- 要求无视证据边界，把不确定内容写成已验证结论
Project Structure
清晰的文档分层和项目结构
战略层负责规则与边界，战术导航负责定位具体执行文件，战术执行文件按阶段拆分，避免一次加载过多上下文
项目结构 ──┬── 战略层 ──── SKILL.md │ 规则与边界 ├── 战术导航 ── orchestration-workflow.md │ 定位具体执行文件 └── 战术执行 ──┬── workflow-step-0-4.md ├── workflow-step-5-8.md └── workflow-step-9-12.md 按阶段拆分，避免一次加载过多上下文
Safety Boundary
最重要的不是写得快，而是不越界
系统允许输出“当前最佳草稿”，但不允许输出“伪装成已验证完成稿的草稿”
🚫
不编造
禁止编造文献、作者、年份、DOI、实验结果、图表、命令或日志
⚠️
不混淆
不把 UNVERIFIED 文献写成 VERIFIED，也不把 user claim 写成可引用证据
📛
不夸大
不把内部验证包装成 SOTA、generalization 或 strong evidence
📌
不静默
缺失信息必须显式保留 REF_NEEDED、RESULT_NEEDED 等占位符
References
参考项目
🚧 Development Progress
项目正在积极迭代以下功能
图片绘制
文字润色
文献检索
引用管理
欢迎 researcher 提交真实使用反馈
如果你遇到 workflow 卡住、gate 误判、文档不清晰，或者希望增加新的 skill / probe，可以通过 GitHub Issues 描述复现步骤或期望行为