claim-evidence-matrix

主张–证据矩阵

触发条件与路由

• 触发条件：主张–证据矩阵、证据映射、证据矩阵、主张-证据对齐。
• 适用场景：撰写正文之前，需要明确每个小节中可检验的主张及其证据来源（大纲 + 论文笔记已就绪）。
• 跳过条件：缺少 outline/outline.yml 或 papers/paper_notes.jsonl。
• 网络：无。
• 防护措施：仅使用项目符号（不写正文）；每个主张至少有 2 个证据来源（或明确说明例外）。

在撰写正文之前，明确调查综述中的主张，并确保这些主张可供审查。

内容应始终仅使用项目符号（不写正文）。目标是让后续写作更轻松，并避免“模板化正文”混入其中。

输入

• outline/outline.yml
• papers/paper_notes.jsonl
• 可选：outline/mapping.tsv

输出

• outline/claim_evidence_matrix.md

工作流（启发式）

使用：outline/outline.yml、outline/mapping.tsv。

1. 对每个小节，撰写 1–3 条主张，要求：
   • 具体（机制 / 假设 / 实证发现）
   • 可证伪（“在 Y 评估下，X 会减少工具错误”，而非“X 很重要”）
2. 对每条主张，列出 ≥2 个证据来源：
   • 优先选择不同类型的证据（方法论文 + 评估/基准测试论文，或两种相互竞争的方法）
3. 保持简洁：主张 → 证据 →（可选）注意事项/局限性。
4. 如果证据薄弱或仅来自摘要，明确说明（不要过度声称）。
5. 如果 papers/paper_notes.jsonl 中存在 bibkey，请在证据条目旁添加 [@BibKey]，以便之后更顺畅地转换为正文/LaTeX。

质量检查清单

• 每个小节至少有 1 条主张。
• 每条主张都列出 ≥2 个证据来源（或明确说明例外）。
• 主张不是复制粘贴的模板（避免“围绕……总结……”之类的套话）。

辅助脚本（可选）

快速开始

• uv run python .codex/skills/claim-evidence-matrix/scripts/run.py --help
• uv run python .codex/skills/claim-evidence-matrix/scripts/run.py --workspace <workspace>

所有选项

• 查看 --help（此辅助工具有意保持精简）

示例

• 生成初版矩阵，然后手动完善：
  • 运行一次辅助工具，然后完善 outline/claim_evidence_matrix.md，使主张更严谨；如果证据仅来自摘要，则添加注意事项。

备注

• 辅助工具会生成基础矩阵（主张 + 证据），且绝不会覆盖非占位符内容；在 pipeline.py --strict 模式下，只有仍存在占位符标记时才会阻止执行。

故障排除

问题：主张过于笼统，或读起来像大纲套话

解决方法：

• 将每条主张改得更具体，使其可证伪；如果证据仅来自摘要，则添加明确的注意事项。

问题：缺少键，无法添加 [@BibKey]

解决方法：

• 运行 citation-verifier 以生成 citations/ref.bib，然后在矩阵中使用生成的键。