SKILL.md
Claim Matrix Rewriter (Evidence-first, NO PROSE)
Triggers & routing
- Trigger: claim matrix rewriter, rewrite claim-evidence matrix, evidence-first claim matrix, matrix index, 证据矩阵重写, 从证据包生成矩阵.
Purpose: make outline/claimevidencematrix.md a navigation/index layer that is driven by evidence packs (not by outline bullets).
Key property: keep the legacy, gate-checked format so downstream QA can rely on stable markers:
- Claim:(one per subsection)- Evidence:(>=2 per subsection)
Inputs
outline/subsection_briefs.jsonloutline/evidence_drafts.jsonlcitations/ref.bib
Outputs
outline/claimevidencematrix.md
Non-negotiables
- NO PROSE: bullets only.
- No placeholders: no
..., unicode ellipsis (…),TODO,(placeholder), or<!-- SCAFFOLD -->. - Claims are evidence-aware:
- fulltext-backed: may summarize comparisons - abstract-only/title-only: must be provisional (no strong “dominant trade-offs” language)
Helper script
uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --helpuv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
Script
Quick Start
uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --helpuv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
All Options
- See
--help. - Requires:
outline/subsectionbriefs.jsonl,outline/evidencedrafts.jsonl,citations/ref.bib.
Examples
- Rewrite the matrix from evidence packs:
- Ensure outline/subsectionbriefs.jsonl and outline/evidencedrafts.jsonl exist and blocking_missing is empty. - Ensure citations/ref.bib exists and contains the cited keys. - Run: uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
Troubleshooting
Issue: cited keys are missing from citations/ref.bib
Fix:
- Run
citation-verifier(or fix the upstream notes) so every referenced key exists before rewriting.
Issue: evidence packs still have blocking_missing
Fix:
- Fix upstream evidence (
paper-notes/evidence-draft) first; the matrix should not “paper over” missing evidence.