SuperAPI AI 工具集

writing-lit-review

写作与研究

查看项目

更新于 10-16 05:07

技能介绍

用途:该技能在头脑风暴完成后、写作 setup 之前运行,负责收集、发现并把所有来源本地化到 references/,使后续 setup、draft、cite-check 阶段只操作本地文件。前提是头脑风暴已完成,用户已确认主题、角度和受众,并已识别 3-6 个研究主题。

主要能力:按三条互不重叠的渠道处理来源。学术论文(期刊、工作论文、SSRN)走 Paperpile 渠道,用 Scholar + Consensus 发现,经 rclone 把 PDF 复制为 references/<bibkey>.pdf。用户个人阅读(文章、报告、已高亮的 PDF)走 Readwise 渠道,经 readwise reader-get-document-details 导出为 references/<bibkey>.md。网络来源(SEC 演讲、博客、评论信、新闻)走 Obsidian 渠道,由 NLM 深度研究后由用户用网页剪藏保存。

使用方式:先 mkdir -p references;对每个主题并行派发 librarian 搜索代理;去重后检查 Paperpile 并补充缺失论文;用 bun materialize-sources.ts 批量复制 PDF、导出 Readwise 内容、保存 URL;随后构建或更新 references/sources.bib,并运行审计模式做缺口分析。

限制:没有本地化来源就不能进入 setup。草稿只引用 references/ 中存在的来源;未本地化时 cite-check 曾把约 30% 引用标记为 NOT_IN_STORE。学术论文不应走 Readwise,因为其存的是网页抓取而非权威 PDF。Scholar 只返回元数据,需先加入 Paperpile 再复制。缺口率超过 20% 是阻塞项,需询问用户。通过门槛后写入 .planning/LIT_REVIEW_COMPLETE.md 才能继续 writing-setup。各步骤之间不应停顿等待确认。