SuperAPI AI 工具集

lit-search

写作与研究

查看项目

更新于 10-16 00:02

技能介绍

lit-search 是一个带时间窗的高召回文献检索技能,驱动本 skill 目录 src/litsearch/ 中的 lit CLI 流水线,所有命令需在该 skill 目录下用 uv run 执行,例如 cd "$SKILL_DIR" && uv run lit --help;CLI 与产物默认路径可通过 LITSEARCH_HOME 覆盖。产物应写入用户项目,采集时用 --runs-root 指定绝对路径,协议 YAML 放在用户项目 topics/ 下,避免把大体积结果堆进 skill 目录。

核心用途:为系统综述、开题报告文献部分、挑战赛调研等需要说清召回边界的任务执行穷尽式检索。输入是一句话研究主题和可选时间范围(默认近 5 年),输出 dois.md、references.md、references.bib、PRISMA.md、coverage_report.md 等全量交付文件,分层只决定顺序,不决定去留。

主要能力与流程:先用 references/topic-template.yaml 写协议,拆 3–5 个概念块并标 required,提名 5–10 篇经验证的金标准 DOI(经 doi.org 验证),干跑校准命中量级;随后依次执行 harvest 采集、screen 筛选、snowball 引文闭包、validate 验证、report 报告、rank 分层与 deliver 交付,含 progresseedings、adjudicate、diff、facets 等子命令,支持 quick / standard / systematic 三档深度。筛选必须在滚雪球之前并与滚雪球交替进行,放量前需先用 --limit 4 和 --limit 100 冒烟与校准。

适用场景与限制:仅用于需可复现检索证据的场合,快速看几篇代表作宜直接用 WebSearch。注意筛选后端有 API、宿主与判定 API 三条路径;缺 OPENALEX_API 会中断部分证据,缺 CONTACT_EMAIL 时 lit fulltext 拒绝运行。捕获-再捕获需要 PubMed 与 OpenAlex 双源,Semantic Scholar 当前尚未实现。人工队列 human_queue.csv 与 boundary_cases.csv 需用户填写后经 lit adjudicate 导回,队列占比超过 15% 应改判定标准。分层与交付只标注排序,不过滤;CCF 等排行榜数据须由用户提供,不得打包分发。推送 Zotero 属对外写操作,需先确认 collection 名称。其他具体收费、平台细节资料未提供。