research-literature-review

Research Literature Review

定位与检索依赖

• 目标：在一个隔离工作目录内完成“检索 → 去重 → 评分 → 选文 → 写作 → 校验 → PDF/Word 导出”的完整综述流水线。
• 适用：用户明确要系统综述、文献综述、related work、文献调研，并希望得到 LaTeX + BibTeX + PDF/Word 产物。
• 不适用：只想补单条参考文献、只想润色已有正文、只想写普通摘要或与综述无关的文章。
• 最高原则：以最佳可用证据和写作质量完成综述；不确定时说明处理方式，不为赶进度牺牲可信度。
• research-literature-search 是阶段 1/2 的必需依赖（contract rls.v1）。review 只消费其 manifest、canonical candidates 和 provenance，不再内嵌 provider 或执行第二套 canonical 去重。
• 旧名 systematic-literature-review 仅作为 prompt 兼容别名保留；.systematic-literature-review/ 仍是稳定历史工作区名。

输入

最少需要：

1. {主题}：一句话主题。
2. 可选范围：时间、语言、研究类型、数据库偏好等。
3. 档位：Premium / Standard / Basic；未指定时读取 config.yaml 默认值。
4. 目标字数与参考文献范围：未指定时按 config.yaml.scoring.default_*_range。
5. 输出目录或安全化前缀：未指定时使用安全化主题名。
6. 查询输入：阶段 1 前必须提供符合公开 schema 的多查询 JSON；推荐用 --query-file，也可填写当前 run 的 input/queries.json。

流程

输入

按用户请求和配置文件提供必要输入；缺失信息应明确列出并停止依赖该输入的步骤。

执行步骤

• 当用户环境中出现因本 skill 设计缺陷导致的 bug 时，优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/，严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
• 若 AI 仍可通过 workaround 继续完成用户任务，应先记录 bug，再继续完成当前任务。
• 当用户明确要求“report bensz skills bugs”等公开上报动作时，调用本地 gh 与 bensz-collect-bugs，仅上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个 bug 仓库。

准备

• 记录主题、档位、字数/参考范围与输出目录。
• 先读取 references/ai_query_generation_prompt.md，生成查询 JSON。公开 schema 支持以下三种形态：
  • {"queries": [{"query": "...", "rationale": "..."}]}
  • [{"query": "...", "rationale": "..."}]
  • ["query 1", "query 2"]
• 剔除空查询后，有效数量必须满足 config.yaml:query_input.min_queries/max_queries（默认 5–25）。
• 已知工作目录时，直接将文件保存到 <work-dir>/input/queries.json，或用 --query-file <path> 让 runner 将显式输入复制到该位置。工作目录尚未建立时，先运行 --prepare-only，填充打印出的 input/queries.json，再以 --resume ... --resume-from 1 继续。
• 开始前优先阅读：
  • references/ai_query_generation_prompt.md
  • references/ai_scoring_prompt.md
  • references/expert-review-writing.md
  • references/review-tex-section-templates.md
  • 涉及翻译时再读 references/multilingual-guide.md

多查询检索（调用 research-literature-search）