systematic-literature-review

# Systematic Literature Review ## 与 bensz-collect-bugs 的协作约定 - 当用户环境中出现因本 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 仓库。 ## 定位 - 目标：在一个隔离工作目录内完成“检索 → 去重 → 评分 → 选文 → 写作 → 校验 → PDF/Word 导出”的完整综述流水线。 - 适用：用户明确要系统综述、文献综述、related work、文献调研，并希望得到 LaTeX + BibTeX + PDF/Word 产物。 - 不适用：只想补单条参考文献、只想润色已有正文、只想写普通摘要或与综述无关的文章。 - 最高原则：以最佳可用证据和写作质量完成综述；不确定时说明处理方式，不为赶进度牺牲可信度。 ## 输入 最少需要： 1. `{主题}`：一句话主题。 2. 可选范围：时间、语言、研究类型、数据库偏好等。 3. 档位：`Premium` / `Standard` / `Basic`；未指定时读取 `config.yaml` 默认值。 4. 目标字数与参考文献范围：未指定时按 `config.yaml.scoring.default_*_range`。 5. 输出目录或安全化前缀：未指定时使用安全化主题名。 ## 输出 默认交付以下核心文件： - `{主题}_工作条件.md`：输入、检索、评分、选���、结构与校验记录。 - `{主题}_review.tex`：正文唯一 LaTeX 源文件。 - `{主题}_参考文献.bib`：选中文献 BibTeX。 - `word_budget_run{1,2,3}.csv`、`word_budget_final.csv`、`non_cited_budget.csv`：综/述字数预算。 - `{主题}_验证报告.md`：字数、章节、引用一致性等验证结果。 - `{主题}_review.pdf` - `{主题}_review.docx` 必要中间产物包括： - `papers*.jsonl` - `scored_papers.jsonl` - `selected_papers.jsonl` - `selection_rationale.yaml` - 可选 `evidence_cards_{主题}.jsonl` ## 硬约束 - 强制导出 PDF 与 Word；只有明确失败并记录原因时才允许缺失。 - 正文字数与参考文献数必须落在当前档位范围内；可由用户覆盖，默认值以 `config.yaml` 为准。 - 正文固定包含：摘要、引言、至少 1 个子主题段、讨论、展望、结论。 - `\cite{key}` 必须与 BibTeX key 一致；缺失即报错。 - 正文禁止泄露 AI 工作流，例如“检索/去��/评分/选文/字数预算”等元叙事只能写入 `{主...