写第二篇论文时,如何把上一篇的 Material Passport 与 Limitations 带入新的 Academic Research Skills 运行?
【免费下载链接】academic-research-skillsAcademic Research Skills for Claude Code: research → write → review → revise → finalize项目地址: https://gitcode.com/GitHub_Trending/ac/academic-research-skills
你用 Academic Research Skills(ARS)写完第一篇论文后,想开一个新的 ARS 运行来写第二篇,并希望把上一篇的引用记录(Material Passport)和 Limitations、审稿意见带过来。ARS 在设计上刻意不保留跨论文记忆:没有 claim registry、没有自动携带的 limitations、没有审稿历史画像,每次运行都只信任你显式喂进去的东西(见 POSITIONING.md 的 Recorded non-goals)。所以「带入」不是配置某个开关,而是一条学者发起的、每次运行都显式执行的流程,官方把它整理在 docs/cross-paper-workflow.md 里,共三步。本文按操作顺序把这三步展开。
前提:你已经按 docs/SETUP.md 安装好 ARS 的四个 skill(deep-research、academic-paper、academic-paper-reviewer、academic-pipeline),并且上一篇论文的产物还在本地——尤其是它的passport.yaml(如果上一篇是用 ARS 写的),或者你至少能拿到它的参考文献列表。
第一步:把上一篇的 Material Passport 作为声明输入喂给新运行
Passport 本来就是 pipeline 唯一的输入端口。新运行会把它当作声明过的输入处理,而不是当作「可信的历史结论」:
- 每一条语料都会重新走当前运行的正常校验路径。引用存在性校验的结果缓存在本地 SQLite(默认
~/.cache/ars/verification.db,条目 90 天过期,缓存 key 按引用计而非按论文计),所以上一篇喂过且仍在缓存内的条目再验证一次成本很低。 - 上一篇跑出来的
ok印章只是起点,不是豁免:所有印章按当前运行的策略重新推导。
具体做法:在新运行中,像喂任何文献语料库一样把上一篇的passport.yaml作为输入喂给 ARS。注意 ARS 故意不提供输出目录配置——用户提供的 Material Passport 路径是唯一发现锚点,所以每次运行都要自己指定 passport 的目标路径(见 docs/SETUP.md § Material Passportliterature_corpus[]adapters)。
可选分支:上一篇不是用 ARS 写的
上一篇没有 ARS 产出的 passport 时,走标准 adapter 路径:先安装 adapter 依赖,再运行仓库自带的参考 adapter 从你的文献库生成passport.yaml。以下命令在 ARS 仓库根目录执行;--input换成你自己的语料来源,--passport/--rejection-log是输出文件路径:
# 1. 安装 dev 依赖(adapter 依赖声明在 requirements-dev.txt 中) pip install -r requirements-dev.txt # 2. 选择与你语料来源匹配的参考 adapter,--passport 与 --rejection-log 均为必填 python scripts/adapters/folder_scan.py --input /path/to/pdfs --passport passport.yaml --rejection-log rejection_log.yaml python scripts/adapters/zotero.py --input my-zotero-export.json --passport passport.yaml --rejection-log rejection_log.yaml python scripts/adapters/obsidian.py --input ~/Obsidian/Lit\ Notes --passport passport.yaml --rejection-log rejection_log.yaml三个参考 adapter 的行为差异(详见 scripts/adapters/README.md):
folder_scan.py从 PDF 文件名解析引用元数据,文件名推不出 family + year 的会被拒;zotero.py读 Better BibTeX JSON 导出,缺title、authors、可解析年份或source_pointer的条目被拒,季节性日期(如Spring 2024)记为year_unparseable;obsidian.py读 Obsidian vault,_templates/与.obsidian/下的文件会被跳过。
语料来源不是这三种时,文档明确让你复制一个参考 adapter 自行改造,契约在 academic-pipeline/references/adapters/overview.md。
验证:schema 校验与 corpus-first 流程
passport 投入任何 ARS 流程之前,先做 schema 校验:
python scripts/check_literature_corpus_schema.py \ --passport /tmp/passport.yaml \ --rejection-log /tmp/rejection_log.yaml新运行开始后的判断方式:当literature_corpus[]非空且解析通过时,Phase 1 的bibliography_agent(deep-research)与literature_strategist_agent(academic-paper)会进入corpus-first / search-fills-gap流程——先预筛你喂的语料,再用外部数据库搜索补齐缺口,其输出(Annotated Bibliography 或 Literature Search Report)的 Search Strategy 一节会出现 PRE-SCREENED 块,这表示你的语料确实被当作声明输入消费了(见 academic-pipeline/references/literature_corpus_consumers.md)。如果语料缺失、为空或形状检查失败,会走[CORPUS PARSE FAILURE: <cause>]优雅回退,回到纯外部数据库流程——看到这个标记就说明你的 passport 没有进入新运行,需要回去修 adapter 输出。
第二步:把上一篇的 Limitations 作为 Socratic 输入喂给 RQ 孵化
跨论文最有价值的携带通常不是文献表,而是上一篇的Limitations 章节和未解决的审稿意见。做法是把这些内容作为你自己提供的材料带进 deep-research 的socratic模式(RQ 孵化/研究问题澄清阶段):
- 粘贴上一篇的 limitations 和审稿意见;
- 说明你认为它们意味着什么;
- Socratic mentor 会像对待任何学者提供的材料一样,围绕你的解读追问:gap 的价值、对决策的影响、可行性。
这里有一条硬边界:ARS不会从你的上一篇论文推导下一批 RQ 候选。它可以指出你写出的模式并提问,但不得替你提出、替换、排序、扩展或选择研究问题——这是记录在案的 advisory-not-generation 线(Kong L2,见 docs/design/2026-06-08-kong-255-l2-advisory-not-generation.md)。下一个研究问题仍由你本人撰写,这一步只能帮你把上一篇的教训想清楚。
第三步(可选,Claude Code 用户):把助手记忆用作个人提醒层
如果你在 Claude Code 里跑 ARS,助手自己的记忆可以当个人提醒用——「上一篇 reviewer 2 质疑了抽样框」「我答应过跟进 X」。但文档给出两条必须记住的约束:
- ARS 的 gate 从不读取也不信任助手记忆。Passport 仍是唯一记录状态;记忆条目只是提醒你按上面第一、二步显式供料的提示,它本身永远不是 gate 的证据、溯源或输入。
- 记忆是你环境的便利设施,不属于工作流契约。上述流程必须在一台完全没有记忆的机器上同样能跑通;如果跑不通,说明状态漏到了 passport 之外。
边界与已知限制
- ARS 不保留跨论文记忆是刻意设计,不是缺失功能:信任环境性跨论文记忆的 gate 等于在评估本次运行无人声明的状态,这正是反泄漏纪律要堵住的通道。因此不要指望「新运行自动知道上一篇」,一切携带都靠你显式喂料。
- 上一篇 passport 里的印章不会原样带过来:当前运行按自己的策略重新推导,缓存命中只是让重新验证变便宜,不改变「重新验证」这件事本身。
- 若引用校验缓存里的某条结果已过期,可用
/ars-cache-invalidate <citation_key>清除该 key 的所有缓存行(四个 resolver、所有查询形式均清除),见 docs/SETUP.md 的引用校验缓存一节。
完成第一、二步后,你的新运行就带着上一篇的语料记录和 limitations 思考开始了:passport 侧以 corpus-first 流程的 PRE-SCREENED 块为消费证据,Socratic 侧以 mentor 针对你提供的 limitations 材料提出的追问为确认信号。下一步则按 docs/SETUP.md 中各 skill 的 slash 命令形式启动具体模式即可。
【免费下载链接】academic-research-skillsAcademic Research Skills for Claude Code: research → write → review → revise → finalize项目地址: https://gitcode.com/GitHub_Trending/ac/academic-research-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考