关于 claim-matrix-rewriter
claim-matrix-rewriter 根据小节简报、证据草稿和参考文献,重写主张—证据矩阵,作为由证据驱动的索引层。它保留下游 QA 所需的固定格式,并要求主张符合证据强度。
主要功能
- 01从证据包生成矩阵
- 02每个小节包含主张与至少两条证据
- 03保留兼容的 Markdown 标记格式
- 04区分全文证据与摘要或标题证据
适用场景
- 01依据证据草稿重建主张—证据矩阵
- 02为下游质量检查提供稳定的矩阵格式
- 03在证据有限时将主张标为暂定
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ willoscar/ research-units-pipeline-skills --skill claim-matrix-rewriter安装后在 Claude Code 中输入/claim-matrix-rewriter确认已加载。
附带文件scripts/run.py
详细介绍
声明矩阵重写器(证据优先,不写散文)
触发条件与路由
- 触发条件:声明矩阵重写器、重写声明-证据矩阵、证据优先声明矩阵、矩阵索引、证据矩阵重写、从证据包生成矩阵。
目的:将 outline/claim_evidence_matrix.md 打造成由证据包驱动的导航/索引层(而非由大纲条目驱动)。
关键特性:保留经门禁检查的旧格式,使下游 QA 能依赖稳定标记:
- Claim:(每个小节一个)- Evidence:(每个小节至少两个)
输入
outline/subsection_briefs.jsonloutline/evidence_drafts.jsonlcitations/ref.bib
输出
outline/claim_evidence_matrix.md
不可妥协的要求
- 不写散文:仅使用项目符号。
- 不得使用占位符:包括
...、Unicode 省略号(…)、TODO、(placeholder)或 ``。 - 声明需考虑证据:
- 有全文支持:可以概述对比
- 仅有摘要/标题支持:必须保持暂定,不得使用强断言式的“主导权衡”措辞
辅助脚本
uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --helpuv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
脚本
快速开始
uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --helpuv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
所有选项
- 请参阅
--help。 - 要求:
outline/subsection_briefs.jsonl、outline/evidence_drafts.jsonl、citations/ref.bib。
示例
- 根据证据包重写矩阵:
- 确保
outline/subsection_briefs.jsonl和outline/evidence_drafts.jsonl存在,且blocking_missing为空。 - 确保
citations/ref.bib存在并包含引用的键。 - 运行:
uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
- 确保
故障排除
问题:citations/ref.bib 中缺少引用的键
解决方法:
- 运行
citation-verifier(或修复上游笔记),确保重写前每个引用的键都存在。
问题:证据包仍包含 blocking_missing
解决方法:
- 先修复上游证据(
paper-notes/evidence-draft);矩阵不应“掩盖”缺失的证据。
评论
支持 Markdown