Back to Details

claim-matrix-rewriter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Claim Matrix Rewriter (Evidence-first, NO PROSE)

主张矩阵重写工具（证据优先，禁止散文式内容）

Purpose: make 
outline/claim_evidence_matrix.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)
目的：将
outline/claim_evidence_matrix.md
打造为一个由证据包（而非大纲项目符号）驱动的导航/索引层。
核心特性：保留经过验证的旧格式，以便下游QA流程可以依赖稳定的标记：
  • - Claim:
    （每个小节一个）
  •   - Evidence:
    （每个小节至少2个）

Inputs

输入文件

  • outline/subsection_briefs.jsonl
  • outline/evidence_drafts.jsonl
  • citations/ref.bib
  • outline/subsection_briefs.jsonl
  • outline/evidence_drafts.jsonl
  • citations/ref.bib

Outputs

输出文件

  • outline/claim_evidence_matrix.md
  • outline/claim_evidence_matrix.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)
  • 禁止散文式内容：仅使用项目符号。
  • 无占位符：不得使用
    ...
    、Unicode省略号（
    …
    ）、
    TODO
    、
    (placeholder)
    或
    <!-- SCAFFOLD -->
    。
  • 主张需基于证据：
    • 有全文支持：可总结对比内容
    • 仅含摘要/标题：必须为临时主张（不得使用“主导权衡”这类绝对表述）

Helper script

辅助脚本

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

Script

脚本说明

Quick Start

快速开始

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

All Options

所有选项

  • See 
    --help
    .
  • Requires: 
    outline/subsection_briefs.jsonl
    , 
    outline/evidence_drafts.jsonl
    , 
    citations/ref.bib
    .
  • 查看
    --help
    获取详情。
  • 依赖：
    outline/subsection_briefs.jsonl
    、
    outline/evidence_drafts.jsonl
    、
    citations/ref.bib
    。

Examples

使用示例

  • Rewrite the matrix from evidence packs:
    • Ensure 
      outline/subsection_briefs.jsonl
      and 
      outline/evidence_drafts.jsonl
      exist and 
      blocking_missing
      is empty.
    • Ensure 
      citations/ref.bib
      exists and contains the cited keys.
    • Run: 
      python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace workspaces/<ws>
  • 从证据包重写矩阵：
    • 确保
      outline/subsection_briefs.jsonl
      和
      outline/evidence_drafts.jsonl
      已存在且
      blocking_missing
      为空。
    • 确保
      citations/ref.bib
      已存在且包含所需的引用键。
    • 运行命令：
      python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace workspaces/<ws>

Troubleshooting

故障排除

Issue: cited keys are missing from 
citations/ref.bib

问题：
citations/ref.bib
中缺少引用键

Fix:
  • Run 
    citation-verifier
    (or fix the upstream notes) so every referenced key exists before rewriting.
解决方法：
  • 运行
    citation-verifier
    （或修复上游笔记），确保所有引用的键在重写前已存在。

Issue: evidence packs still have 
blocking_missing

问题：证据包仍包含
blocking_missing

Fix:
  • Fix upstream evidence (
    paper-notes
    / 
    evidence-draft
    ) first; the matrix should not “paper over” missing evidence.
解决方法：
  • 先修复上游证据（
    paper-notes
    / 
    evidence-draft
    ）；矩阵不能“掩盖”缺失的证据。