literature-search

1# Light Literature
2
3把研究问题连到实际论文和可核对的证据。技能目录名为 `light-literature`，保留历史入口名 `literature-search`。脚本处理检索、记录、去重、渲染和一致性检查；宿主负责问题设计、筛选、原文阅读与科学判断。脚本不调用模型 API。
4
5## 先恢复范围和已有材料
6
7- 明确项目根、当前问题、所需深度和已有文件；用户给定路径与既有结构优先。落盘时读 [目录约定](references/project-layout.md)，产物保存在真实项目，包内演示材料仅用于测试。
8- 继续项目时，先读 `Memory/current.md` 和有关记忆来源；已使用记忆工具时按当前问题取 `context`，冲突/过期项回到原始材料核对。有 `Workflow` 时查看当前任务、采用版本和交接，避免重复检索或阅读。明确的局部任务可直接完成，不强制初始化两者。
9- 先查 `Literature/README.md`、`manifest.json`、有关 `meta.json`、阅读文件和检索轮次，复用已有结果。找不到关键输入才澄清；通常可说明合理假设后推进。
10
11## 按请求选择路径
12
13| 请求 | 执行与完成依据 |
14|---|---|
15| 找几篇、查一个具体说法或跟踪种子文献 | 定向检索/查证，明确检索边界，返回已核对身份的记录与可定位依据；无需完整问题树或全量精读 |
16| 梳理领域、找矛盾或形成证据地图 | 读 [检索流程](references/search-workflow.md) 与 [方法依据](references/methodology.md)，设计问题、互补检索、筛选、按需扩展引用和综合，报告实际覆盖和停止原因 |
17| 读论文、解释公式/方法、全文翻译 | 读 [阅读流程](references/reading-workflow.md)，直接复用或导入真实 PDF；只做用户所需的片段、解释、译文或深读笔记 |
18| 核对参考文献或一项引用是否支持主张 | 核对原始字段、版本/状态与实际主张位置，记录 confirmed/conflict/unverified 及来源；参考文献字段一致不能证明其支持主张 |
19| 续读、增补文献或恢复中断 | 先确认采用来源、已完成范围和缺口，针对增量工作；已读资料变动时保留原版阅读结果并重新核对 |
20
21综合检索不会自动构成符合 PRISMA 的系统综述。根据研究类型交代数据库覆盖、全文评估、独立筛选等已做和未做事项，不把未检索到等同于不存在。
22
23## 检索执行
24
25命令详见 [详细流程](references/search-workflow.md)；从任意项目目录调用技能入口的绝对路径，勿假定当前目录在技能包中。依赖安装和离线演示见 [README](README.md)。
26
27```text
28python "<skill-root>/run_litsearch.py" plan init --direction "<研究问题>" --domain general --out "<SEARCH>/query_plan.json"
29python "<skill-root>/run_litsearch.py" plan validate --plan "<SEARCH>/query_plan.json"
30…