用途
literature-triage-matrix 用于把一组论文整理成一张单一的对比表，服务于综述写作决策。它让用户（或下游写作技能）一眼看出：哪些论文按方法聚在一起、哪些论文支撑某个特定论断、哪些可以顺带引用、哪些需要深入讨论。
该技能明确避免常见的 AI 失败模式——“给我每篇论文的摘要”，因为那会产出 N 个彼此独立的要点列表，用户仍需手动比较。
何时使用
触发语句包括：
- “为这些论文做一个文献矩阵。”
- “按方法、数据、论断和局限比较这些论文。”
- “帮我判断哪些论文对我的综述是核心的。”
- “在我的 Zotero 收藏 / Obsidian 笔记簇上构建一张筛选表。”
不适用场景：
- 5 页的叙述性文献综述——那是写作任务。
- 引用格式——由 Zotero 和写作技能处理。
- 单篇论文深读——使用 paper-memory-builder。
证据契约
需阅读 ../research-hub/references/research-protocol.md 和 ../research-hub/references/source-claim-audit.md，以了解范围保持、核心/最接近/经典角色、版本感知发现和有界完成。若独立安装缺少这些参考文件，则使用以下最低规则：元数据、摘要、记忆中的结果和生成的摘要属于筛选线索；承载性论断需要定位到来源/版本证据；未核查的论断和失败的检索保持为明确缺口。
输入
按优先级（从最省力到最费力）：
-
手动论文列表——用户直接粘贴到对话中的 Markdown 项目符号列表，含标题 + DOI（或 arXiv ID）。摩擦最低，无需其他 research-hub 配置。每行视为矩阵中的一行。DOI 查询建立的是元数据，不是发现。记忆中的著名结果仅作为检索线索。论断/方法/局限单元格需检索实际来源段落；否则标记 ? 或明确标注为临时筛选来源。
最小输入示例：
- "Memory enables ToM-like behaviour in LLM poker agents", arXiv:2604.04157
- "Multi-agent LLM social learning", arXiv:2604.02677
- "Triadic Loop alignment framework", arXiv:2604.18850
-
.research/literature_matrix.md——若已存在，先解析。按约定为追加式；仅当底层论文发生实质变化时才重新输出某行。
-
raw/<cluster>/*.md 下的 Obsidian 笔记簇——含结构化 frontmatter（title、authors、year、doi）以及 research-hub 生成的 Summary / Key Findings / Methodology / Relevance 部分。先读这些用于筛选；生成的部分不是经独立验证的来源发现。
-
通过本地 API 获取 Zotero 收藏元数据（快）——仅当 Obsidian 没有该论文时才添加子笔记内容。
-
.research_hub/artifacts/ 下 NotebookLM 下载的简报——若用户已为该笔记簇生成简报，可从中挖掘临时比较线索，并标注为生成摘要。
-
实际来源文本 / PDF——读摘要用于筛选，再读相关的方法/结果/局限、补充材料或更正以获取承载性细节。报告实际阅读的章节；固定的前几页窗口不构成全文审阅。
输出
写入 <project-root>/.research/literature_matrix.md。默认追加；仅当用户明确说“从头重新生成”时才重写整张表。
Markdown 表格列（可按请求定制，默认如下）：
| Citation | Question | Method | Data / study area | Main claim | Evidence / source level | Limitation | Relevance | Use as |
|---|---|---|---|---|---|---|---|---|
| Smith 2024 | How does adaptation affect flood risk? | mesa-based ABM, 10k agents | Houston synthetic | Adaptation cuts loss 18% | simulation | single basin, no validation | High — direct precedent | Lit review §2 |
| Jones 2023 | Hydraulic coupling in flood ABMs | Coupled ABM-2D | Galveston | Coupling reduces RMSE 22% | empirical | calibration window narrow | Medium — methods | Methods §3 |
列含义：
- Citation——简短引用（如 Smith 2024）；完整引用留给 Zotero。
- Question——论文的研究问题，一句话。
- Method——模型类别 + 关键技术细节。
- Data / study area——所用数据集 + 地理/时间范围。
- Main claim——在所审来源支持强度下的决策相关发现；未验证时用 ?，绝不单凭记忆中的结果。
- Evidence / source level——研究类型加上实际审阅的材料：元数据 / 摘要 / 生成摘要 / 定位到的全文摘录 / 不可用。承载性论断需包含版本、段落定位和审计引用；不要混淆研究类型与证据可得性。
- Limitation——最重要的注意事项，一句话。
- Relevance——High / Medium / Low + 一句理由。
- Use as——该论文在用户手稿或综述中的位置（文献综述、方法、讨论、仅引用）。对于综述选择决策，在紧凑的伴随笔记中命名核心 / 最接近 / 经典 / 方法对照 / 相反角色、需求 ID、遗漏影响、替代方案和适用条件，而不是悄悄添加不需要的列。
节省 token 的行为
- 先读现有 .research/literature_matrix.md；仅对尚未覆盖或底层笔记已变化的论文输出行。
- 优先用 frontmatter 和摘要做候选筛选。仅当来源字节/版本和依赖决策未变时，才复用先前已验证的段落；过时摘要不能确立当前支持。
- 使用稳定论文标识符（DOI 或 arXiv ID），以便未来请求可用 Smith 2024 (10.1234/abcd) 引用行，而无需粘贴段落。
- 声明相称的阅读/资源上限。若批准上限为三次阅读，第四次承载性来源保持明确未评估，或在授权继续后检查；上限绝不证明完整验证。统计所有已评估和未核查的论断。
面向用户的输出格式
写入矩阵后，打印：
[literature-triage-matrix] Wrote/appended: .research/literature_matrix.md Papers in matrix: 12 (4 new this run) Skipped (already in matrix, unchanged): 8 Source sections read: 1 (Smith 2024 — Methods §3 / Results §4) Claims checked / total: 3 / 4 (one load-bearing claim unassessed) Completion: partial; fourth source remains unchecked Suggested next: review High-relevance rows in .research/literature_matrix.md
不应做的事
- 不要写入 .paper/——那是 paper-memory-builder 的领域。
- 若论文笔记稀疏，不要编造发现。在未知列输出 ? 并附注：(Obsidian note incomplete — run research-hub auto with --max-papers 1 to enrich, or fill manually)。
- 不要不必要地重新总结未变化的已验证证据。当出版版本、更正或依赖决策变化时，重新核查论断。
- 不要包含用户未要求的列。默认 9 列只是起点；如被要求则裁剪。