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...