生成式 AI 可以提高文献整理、结构规划和文本修订的效率,但文字完整、表达流畅并不等于研究可靠。科研质量仍取决于一组可追溯的问题:研究问题和方法由谁确认,论文主张由哪些材料支持,引用是否准确反映来源,修订是否真正回应审稿意见,以及发现重大问题后流程能否及时停止。
Academic Research Skills(下文简称 ARS)不是端到端自动写论文系统,而是一套研究者主导、过程可检查、关键节点可暂停的科研工作流。它通过明确的阶段、结构化产物、Material Passport 和完整性闸门,把原本容易遗失在长对话中的决策、证据和失败记录保存下来。其目标不是替研究者作出学术判断,而是降低未经核验的内容在流程中继续传播的风险。
包含 4 个 Skill、27 种模式、39 个已登记 Agent 角色(26 个判断型、13 个执行型)和 16 个斜杠命令。
一、核心设计:AI 是副驾驶,研究者保留状态转换权
ARS 明确拒绝端到端自主研究。它不替研究者提出并选择假设,不在 Pipeline 内编写或运行实验代码,也不会因为看到了程序输出就把它认定为论文证据。其判断标准可以概括为一句话:下一步研究状态由谁决定?
这一区分不是措辞上的保守,而是架构边界。研究问题、方法、论文结构、审稿决定、修订范围和最终输出都设有人工确认点。“full”表示覆盖完整流程,不表示无人值守。四个 Skill 的职责:
| Skill | 主要职责 | 模式数 | 典型产物 |
|---|---|---|---|
deep-research | 问题澄清、检索、综述、事实核验、系统综述 | 8 | RQ Brief、方法蓝图、文献表、证据综合 |
academic-paper | 规划、写作、修订、摘要、引用检查、格式转换 | 11 | 大纲、论文、修订稿、回复信、目标格式文件 |
academic-paper-reviewer | 多视角模拟评审、方法审查、再审与校准 | 6 | 5 份评审报告、编辑决定、修订路线图 |
academic-pipeline | 调度、状态管理、完整性闸门与恢复 | 2 个入口形态 | 阶段产物、Material Passport、过程记录 |
完整 Pipeline 不是简单的“检索—写作—润色”,而是十个有状态的阶段:
这里有两个重要细节。
- 第一,流程允许从中间进入:
- 已有初稿可从完整性检查或评审前置步骤开始,
- 已有审稿意见可从修订阶段开始。
- 第二,修订循环最多两轮,避免模型在同一框架内无止境“优化”;仍未解决的问题应显式进入限制说明,而不是被悄悄抹平。
二、Material Passport:把上下文变成研究状态
长对话最危险的问题不是模型忘记一句话,而是研究状态变得不可追溯。ARS 用 Material Passport 保存单篇研究的关键状态,包括文献语料、引用核验结果、研究者声明的外部实验来源、主张—证据映射、待处理决策和跨会话恢复边界。
Passport 的价值主要有三点:
- 来源显式化:论文中的实验性主张可关联到
experiment_provenance[]中的结果文件、配置、未执行项目、负结果与已知限制。 - 交接结构化:研究、写作、评审和修订不靠整段聊天记录传递,而靠约定的产物和 Schema 交接。
- 跨会话恢复:设置
ARS_PASSPORT_RESET=1后,FULL checkpoint 可写入带哈希的恢复边界;新会话通过resume_from_passport=<hash>继续,降低长上下文的成本和漂移风险。
但 Passport 是来源登记簿,不是事实证明书。它可以记录“研究者声明某实验使用某配置并产生某结果”,却不能证明代码确实运行、原始数据真实完整、分析能够复现。一个内部叙述完全一致但数据造假的研究,理论上仍可能通过所有 ARS 闸门。这是理解整套系统时最不能忽略的边界。
三、完整性不是一次检查,而是分层证据链
ARS 把“引用正确”拆成多个不同问题,避免用 DOI 存在替代主张真实性。
| 层次 | 回答的问题 | 主要机制 | 仍然不能证明什么 |
|---|---|---|---|
| 书目存在性 | 这篇文献是否存在,元数据是否相符? | Semantic Scholar、OpenAlex、Crossref、arXiv,多索引交叉核验与 90 天 SQLite 缓存 | 文献是否真的支持正文主张 |
| 引用与定位 | 文内引用、参考文献、页码或段落定位是否一致? | 双向匹配、三层引用标记、时间线与 PDF 页码检查 | 作者是否准确理解了原文 |
| 主张忠实度 | 来源原文能否支持该项主张,是否违反负约束? | 可选 ARS_CLAIM_AUDIT=1,按主张抽样、检索原文并进行判断 | 未抽到的主张、模型判断之外的真实世界事实 |
| 经验研究一致性 | 论文主张是否与研究者登记的实验结果一致? | experiment_provenance[] 与 claim manifest 关联 | 实验是否真的执行、数据是否真实、代码是否正确 |
Stage 2.5 是审稿前闸门,检查参考文献、引用语境、统计数据、原创性、主张以及七类 AI 研究失败模式。高风险问题会阻断流程;当前协议允许研究者在记录理由后处理部分未决项,但不能静默跳过检查。Stage 4.5 则必须从头独立复验,不能只回查上一轮发现的问题,并要求零问题后才进入定稿。
v3.19.0 还加入了 PDF 读取完整性预检。其原因很实际:PDF 解析器可能修复损坏的交叉引用表、截断页面或报告错误页数,而下游仍生成一个看似合法的页码。对应脚本比较根页面树声明页数、递归枚举页数和阅读器页数;三者一致、数量为正且没有修复警告时才给出 PASS。这不能证明页码上的文字支持主张,但能先保证“页码来自完整读取的文档”。
四、macOS 安装与首次使用
ARS 是 Claude Code 原生插件。macOS 上推荐使用“Claude Code 原生安装器 + ARS Plugin”这一组合:更新简单,并能保留斜杠命令、hooks、写入保护和多 Agent 编排能力。
4.1 安装 Claude Code
打开 macOS 的终端,执行安装命令:
| |
原生安装器不要求预先安装 Node.js,并会自动更新。安装后关闭并重新打开终端,再检查:
| |
首次启动:
| |
根据界面完成登录或 API 凭证配置。也可以只在当前终端会话设置环境变量:
| |
不要把真实 API Key 写入论文、Markdown、Git 仓库或共享截图。若安装脚本或登录方式发生变化,应以 Claude Code 官方安装文档 为准。
4.2 安装 ARS Plugin
先在终端进入你的研究项目,再启动 Claude Code:
| |
随后在 Claude Code 交互界面中依次输入:
| |
以上两行不是 macOS Shell 命令,不要直接粘贴到普通终端提示符中。安装完成后重启 Claude Code 会话,运行:
| |
如果进入逐章论文规划流程,说明插件已经加载。插件命令的规范形式是 /academic-research-skills:ars-<mode>;较新的 Claude Code 通常也支持简写 /ars-<mode>。若简写没有补全或与其他插件冲突,使用规范形式:
| |
更新插件使用:
| |
/plugin marketplace update academic-research-skills 只刷新 Marketplace 来源,不等于更新已安装插件。可以在 /plugin 界面为 ARS 打开自动更新。
4.3 按输出格式安装可选依赖
只生成 Markdown 时,不需要 Python、Pandoc、LaTeX 或 Tectonic。需要直接生成 DOCX 或 PDF 时,再安装对应依赖。若 Mac 已安装 Homebrew,可执行:
| |
APA 7.0 中英混排 PDF 还需要字体:Times New Roman 和 Courier New 通常随 macOS 提供;中文建议安装 Source Han Serif TC VF / Noto Serif TC。下载字体文件后双击,在“字体册”中选择“安装字体”。字体缺失时可以先交付 Markdown 或 LaTeX,不要把编译失败误判为论文内容失败。
4.4 第一次实际运行
建议每个研究项目使用独立目录,把代码、结果和 ARS 产物分开:
| |
进入项目并启动 Claude Code 后,先用一个低风险任务验证路由:
| |
模式启动后,再确认输出目录为 research/ars-run-001/,并在检索前检查纳排标准。
正式请求建议始终包含七项:任务、研究问题、已有材料、已确认事实、待验证内容、期望输出、限制条件。例如:
| |
五、27 种模式
斜杠命令只是常用入口,未暴露为独立命令的模式仍可用“请使用 <skill> 的 <mode> 模式”直接调用。最稳妥的使用方式不是一上来运行 /ars-full,而是根据当前问题、已有材料和所需监督程度选择最小模式。
5.0 示例快速导航
- deep-research:full · quick · review · lit-review · three-way-scan · fact-check · socratic · systematic-review
- academic-paper:full · plan · outline-only · revision · revision-coach · abstract-only · lit-review · format-convert · citation-check · disclosure · rebuttal-audit
- academic-paper-reviewer:full · re-review · quick · methodology-focus · guided · calibration
- academic-pipeline:(pipeline) · resume_from_passport
点击以上模式名,或点击下方模式总表中的模式名,即可跳转到对应的独立示例子章节。
5.1 deep-research:从问题形成到证据综合
deep-research 负责研究上游,重点是“研究什么、怎样研究、现有证据说明什么”,不负责把材料直接扩写成完整论文。
| 模式 | 什么时候使用 | 必要输入 | 主要输出与边界 |
|---|---|---|---|
full | 已有明确主题,希望完整完成问题界定、方法设计、检索与综合 | 研究主题/RQ、时间与学科范围、证据标准 | 3,000–8,000 字报告、RQ Brief、方法蓝图、核验文献与局限;关键配置需要确认 |
quick | 会前准备、选题预判、快速进入新领域 | 明确主题、优先问题、时间范围 | 500–1,500 字简报;不追求穷尽性,不能替代正式综述 |
review | 已有论文、报告或研究草稿,需要质量诊断 | 完整待审文本、学科标准、关注点 | 研究问题、方法、证据、推理与伦理评估;只审查,不从零研究或重写全文 |
lit-review | 需要可追溯的主题式文献检索与综合 | 主题/RQ、检索边界、纳排标准、已有文献 | 1,500–4,000 字注释书目、证据矩阵、主题综合与研究缺口;默认不满足 PRISMA |
three-way-scan | 快速比较少量候选论文或筛选阅读清单 | 论文列表、DOI/链接或明确主题 | 逐篇提取 WHY、HOW、WHAT 并跨文比较;不声称完整覆盖领域 |
fact-check | 核验报告或论文中的具体数字、日期、制度或因果说法 | 可独立判断的主张、原始出处或检索范围 | 每条主张的 verdict、证据 locator、适用条件和建议改写;不扩展成综合报告 |
socratic | 只有兴趣方向,还没有可回答的 RQ | 兴趣、经验、资源、时间和伦理约束 | 多轮提问形成 Research Plan Summary 与 INSIGHT;研究者作决定,Agent 不代选假设 |
systematic-review | 问题高度聚焦,需要 PRISMA、风险偏倚和证据确定性评价 | PICOS/RQ、数据库、日期、检索式、纳排与筛选规则 | 5,000–15,000 字 PRISMA 2020 报告、RoB、GRADE;仅在统计可比时做 Meta-analysis |
5.1.1 八种模式的可复制示例
以下示例均可直接发送给 Claude Code,再把主题、文件和范围替换为自己的内容。
full:完整研究
| |
quick:快速研究简报
| |
review:审查现有研究文本
| |
lit-review:主题式文献综述
| |
three-way-scan:WHY/HOW/WHAT 快速比较
| |
fact-check:逐条事实核验
| |
socratic:苏格拉底式选题引导
| |
systematic-review:PRISMA 系统综述
| |
选择时先问两个问题:是否需要 PRISMA?若需要,选 systematic-review;若不需要,再判断是全面研究(full)、主题综述(lit-review)还是快速扫描(quick/three-way-scan)。fact-check 只适合拆分后的原子主张,不能用来回答宽泛研究问题。deep-research review 是对现有研究文本做研究质量诊断;若需要五席位、编辑决定和正式修订路线图,应改用 academic-paper-reviewer full。
5.2 academic-paper:从论证规划到投稿文件
academic-paper 假设研究材料已经存在。它可以组织和表达证据,但不得用模型记忆填补缺失结果。
| 模式 | 什么时候使用 | 必要输入 | 主要输出与边界 |
|---|---|---|---|
full | RQ、方法、文献和结果基本齐备,需要完整初稿 | 论文类型、RQ、方法、证据/结果文件、字数、语言、引用格式 | 领域适配的完整草稿、摘要和参考文献;先确认配置与大纲,缺失结果标为 [MATERIAL GAP] |
plan | 论文逻辑尚未冻结,希望逐章思考贡献与论证 | RQ、已有材料、目标读者、结构困惑 | 苏格拉底式 Chapter Plan、论证路径和 INSIGHT;只规划,不直接写全文 |
outline-only | 研究逻辑已明确,只需快速得到可执行结构 | RQ、论文类型、主要证据、目标字数 | 三级大纲、字数分配、证据映射与图表计划;不写段落正文 |
revision | 已有草稿和明确审稿/修订任务,需要实际改稿 | 原稿、Revision Roadmap、审稿意见,最好附回复稿 | Revision Patch、确定性应用后的修订稿、Apply Report 与逐点回复;结构性重写需确认 |
revision-coach | 收到杂乱审稿意见,尚未形成修订策略 | Decision Letter 与全部意见,草稿可选 | 去重、拆分、排序后的 Revision Roadmap 和回复信骨架;不修改论文 |
abstract-only | 正文已经稳定,只缺摘要与关键词 | 至少包含 RQ、方法、样本、结果和结论的正文 | 默认繁体中文与英文摘要、各 5–7 个关键词;不得加入正文没有的数字或结果 |
lit-review | 已有核验文献,需要写成论文中的 Related Work/综述章节 | 已核验文献、论文 RQ、目标篇幅 | 论文体例的主题综合;上游检索与证据评级应交给 deep-research lit-review |
format-convert | 内容已经冻结,只转换格式或引用体例 | 完整稿件、参考文献、目标格式与模板要求 | Markdown、LaTeX、DOCX 或 PDF;只改格式,不重新解释结果或验证主张 |
citation-check | 投稿前检查文内引用和参考文献表 | 完整稿件与参考文献表 | 缺失、孤立、重复、作者/年份/DOI 和格式错误报告;“引用存在”不等于“引用支持主张” |
disclosure | 需要按目标 Venue 披露 AI 使用 | Venue、实际模型、使用阶段、人工审核与未使用范围 | Venue 适配声明和放置位置;只能依据真实使用记录,仍须核对最新投稿政策 |
rebuttal-audit | 审稿意见和现有回复稿都已具备,需要查漏与降风险 | reviewer comments + response/rebuttal draft | addressed/partially/missing QA 表、语气与证据风险;不代写新回复,不给“可投稿”认证 |
最容易混淆的是三组模式:
plan通过对话帮助作者形成论证,outline-only直接给出结构化大纲;两者都不写全文。revision-coach把意见变成计划,revision才真正修改稿件;前者适合“先决定怎么改”,后者适合“按已确认路线图执行”。citation-check检查引用表面一致性,Claim Audit 检查正文主张是否得到来源支持;前者通过不代表后者通过。
5.2.1 十一种模式的可复制示例
full:完整论文初稿
| |
plan:逐章规划
| |
outline-only:只生成大纲
| |
revision:按路线图实际改稿
| |
revision-coach:把审稿意见整理成修订计划
| |
abstract-only:只生成摘要和关键词
| |
lit-review:撰写论文中的文献综述章节
| |
format-convert:转换文档和引用格式
| |
citation-check:检查引用一致性
| |
disclosure:生成 AI 使用声明
| |
rebuttal-audit:审计现有回复稿
| |
5.3 academic-paper-reviewer:诊断、评审与修订验收
Reviewer Skill 有六种模式。它模拟投稿前评审,但不能替代真实同行评议。
| 模式 | 什么时候使用 | 主要输出 | 关键边界 |
|---|---|---|---|
full | 投稿前需要全面、多视角压力测试 | 5 份独立报告、Editorial Decision、Revision Roadmap | 成本最高;是模拟评审,不是期刊决定 |
re-review | 已按首轮路线图修订,需要验收落实情况 | resolved/partial/unresolved/new 问题矩阵与新决定 | 沿用首轮 yardstick;最好同时提供回复信和 Apply Report |
quick | 组会或初筛前,只想找最严重的三类风险 | Journal-Fit 快评与关键问题清单 | 只由精简角色完成,不能替代 full |
methodology-focus | 只关心设计、数据、基线、统计与外部有效性 | 深入方法审查 | 不全面评价文风、传播价值等其他维度 |
guided | 作者希望理解问题,而不是一次收到整份报告 | 逐问题苏格拉底对话与共同形成的改进方向 | 每轮聚焦一个问题,不适合急需完整报告 |
calibration | 有 Gold Set,希望测量 Reviewer 的误报与漏报 | 完整档输出 FNR、FPR、Balanced Accuracy、AUC 与置信披露;方向档输出原始偏宽/准确/偏严计数 | directional 明确指定 3 篇;默认 full 使用 5–20 篇且每篇多次运行,成本高;结果只适用于该校准集 |
首次评审与再审必须区分。full 是按完整标准发现问题;re-review 是对照首轮路线图验证“声称完成的修改是否真的出现”。如果首轮只做了 quick,后来要求全面审查,应该明确调用新的 full,不能把它误称为同一 yardstick 下的 re-review。
5.3.1 六种模式的可复制示例
full:五席位完整评审
| |
re-review:验收首轮修订
| |
quick:快速风险评估
| |
methodology-focus:方法论专项审查
| |
guided:引导式评审
| |
calibration:用 Gold Set 校准评审器
| |
5.4 academic-pipeline:完整运行、途中接入与失败恢复
Pipeline 不是第四套研究或写作能力,而是前三个 Skill 的调度器。它根据已有材料选择入口,并在阶段之间传递产物、执行闸门和等待确认;编排器不代做实质研究、写作或评审。
| 模式/入口 | 什么时候使用 | 输出与监督方式 |
|---|---|---|
(pipeline) | 任务横跨研究、写作、评审、修订和定稿的多个阶段 | 十阶段工作流;研究者在关键 checkpoint 确认,编排器只调度、不代做实质任务 |
resume_from_passport=<hash> | 已在旧会话写入 Passport reset boundary,希望换新会话继续 | 从已验证边界恢复状态并追加 Resume Ledger;仍需处理待决问题,不能借恢复参数跳过闸门 |
具体从哪一阶段开始,由现有材料决定:
| 已有材料/目标 | 推荐入口 | 说明 |
|---|---|---|
| 没有材料,希望从选题走到定稿 | Stage 1 / /ars-full | 先研究,再写作、完整性、评审、修订和定稿 |
| 已有 RQ、方法和核验材料 | Stage 2 WRITE | 跳过重复研究,但仍需确认材料缺口 |
| 已有论文初稿,准备模拟评审 | Stage 2.5 INTEGRITY | 先做审稿前完整性检查,再进入 Stage 3 |
| 已有经过核验的论文 | Stage 3 REVIEW | 直接配置完整或定向评审 |
| 已有编辑决定和审稿意见 | Stage 4 REVISE | 先生成/确认路线图,再实际修订 |
| 已有修订稿、首轮路线图和回复信 | Stage 3’ RE-REVIEW | 对照首轮标准验收修订 |
| 只想做摘要、引用检查或格式转换 | 直接调用单项 academic-paper 模式 | 没必要启动完整 Pipeline |
5.4.1 两种入口的可复制示例
(pipeline):启动十阶段完整流程
完整调用时应一次声明目标、材料与权限边界:
| |
resume_from_passport=<hash>:从 Passport 边界恢复
跨会话恢复则必须使用 Passport 中尚未消费的 Boundary Hash:
| |
需要覆盖 Passport 的默认路由时,可以使用 resume_from_passport=<hash> stage=3 mode=full,但不能绕过 Passport 中的待决问题或完整性闸门。产生恢复边界的原会话必须设置 ARS_PASSPORT_RESET=1;恢复会话不需要再次设置。
完整性失败时,不应要求系统“忽略并继续”。Stage 2.5 应列出严重度、证据位置和修复选项,修正后复验;Stage 4.5 必须独立重跑最终检查,不能只验证已知问题。目录中的《完整性失败恢复》适合观察交互结构,但其中的姓名、文献和数值属于演示材料,不能复用为真实来源。
5.5 一条实用的选型规则 ⭐⭐⭐⭐⭐
可以用“材料成熟度 × 任务类型”快速判断:问题还不成熟,用 socratic;问题明确但证据未整理,用 full 或 lit-review;要求可复现系统综述,用 systematic-review;证据已齐但逻辑未定,用 plan;逻辑已定只缺结构,用 outline-only;已有稿件要诊断,用 Reviewer;已有路线图要改稿,用 revision。只有当任务横跨多个阶段且愿意在关键节点确认时,才启动 /ars-full。
涉及代码实验时,应把“设计—执行—写作”拆成三个责任域:
| |
这样做的关键不是工具分得更细,而是避免同一次模型调用同时裁决“代码是否正确”和“论文事实是否成立”。若启用 OpenAI、Gemini 或兼容服务做跨模型验证,还应把模型配置和数据上传授权分开处理;未发表论文、审稿材料和私人笔记不能因为配置了第二模型就默认允许外发。
六、局限
对 ARS 最合理的评价不是“能否自动写出论文”,而是“是否降低了不可见错误进入论文的概率”。它提供了较强的过程控制,但仍有以下限制:
- 经验真实性不可验证:无法证明真实实验、访谈或干预按论文所述发生,也不能替代原始数据审计与独立复现。
- 核验覆盖并非绝对:外部索引有覆盖盲区,付费全文可能不可得;部分语境、原创性和主张检查采用抽样或 LLM 判断。
- 模拟评审不等于同行评审:角色提示可以扩大观察角度,却没有真实审稿人的专业责任、领域经验和利益冲突约束。
- 成本较高:官方对约 1.5 万词、60 条参考文献的完整十阶段流程估算为超过 20 万输入 token 和 10 万输出 token;“约 4–6 美元”只是基于 2026 年 4 月 Opus 4.x 价格的历史量级,不应当作当前报价。
- 依赖环境:Markdown 输出依赖最少;DOCX、PDF、在线文献核验和跨模型验证分别需要 Pandoc、Tectonic/字体、网络与相应 API 配置。
结语
ARS 最有价值的贡献,是把“用 AI 做科研”从一次长提示词,改造成由角色、产物、状态、闸门和失败路径共同组成的过程系统。它不能赋予模型科研权威,也不能替代实验真实性、伦理审查和同行评议;但它能迫使研究者和模型持续回答几个朴素而关键的问题:这条主张从哪里来?谁确认了它?修改了什么?还缺什么证据?何时应该停止?
参考资料
- Cheng-I Wu. Academic Research Skills for Claude Code, stable release v3.19.0, 2026-07-22.
- ARS. Positioning: scope, rejected autonomous mechanisms, empirical-work boundary and license positioning.
- ARS. Pipeline Architecture: state flow, stage matrix, dependency graph and quality gates.
- ARS. Mode Registry: authoritative list of 27 modes.
- ARS. Performance Notes: token estimates, model routing and long-session management.
- ARS. Setup Guide: Claude Code installation, Plugin setup and optional document dependencies.
- ARS. CC BY-NC 4.0 License.
- Wu, C.-I. (2026). Academic Research Skills for Claude Code [Computer software]. Zenodo concept DOI.