rw-claim-audit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

RW Claim Audit

RW Claim Audit

检查来源是否支持具体主张。引用存在、格式正确和支持主张是 3 个不同问题。
Check whether sources support specific claims. The existence of citations, correct formatting, and support for claims are three separate issues.

启动

Initiation

  1. 读取
    references/method.md
    references/verdicts.md
  2. 确认文稿版本、允许使用的来源和能否访问全文。
  3. assets/claim-audit-template.json
    建立记录,或运行
    scripts/claim_audit.py init
  4. 逐条回到原始来源,保存来源指针和页码、段落、表、图或补充材料位置。
  5. 运行
    validate
    summary
    gate
  6. 交付前读取
    references/acceptance.md
  1. Read
    references/method.md
    and
    references/verdicts.md
    .
  2. Confirm the manuscript version, allowed sources, and full-text accessibility.
  3. Create a record using
    assets/claim-audit-template.json
    , or run
    scripts/claim_audit.py init
    .
  4. Return to the original sources one by one, and save the source pointer and the location of pages, paragraphs, tables, figures, or supplementary materials.
  5. Run
    validate
    ,
    summary
    , and
    gate
    .
  6. Read
    references/acceptance.md
    before delivery.

工作阶段

Work Stages

  1. 提取数字、类别、趋势、比较、因果、方法和作者解释类主张。
  2. 为每条主张记录文稿位置和主张范围。
  3. 找到被引来源中的对应位置;只有摘要时标明访问边界。
  4. 比较人群、时间、变量、方向、数值和不确定性。
  5. 给出 verdict,并说明差异会怎样改变结论。
  6. 对阻断项收窄、删除或更换来源,再重新核验。
  1. Extract claims related to figures, categories, trends, comparisons, causality, methods, and author interpretations.
  2. Record the manuscript location and claim scope for each claim.
  3. Locate the corresponding position in the cited source; mark the access boundary if only the abstract is available.
  4. Compare populations, time periods, variables, directions, values, and uncertainties.
  5. Provide a verdict and explain how discrepancies would alter the conclusion.
  6. Narrow down, delete, or replace sources for blocked items, then re-verify.

命令

Commands

bash
python3 scripts/claim_audit.py init claim-audit.json --document-id DOC-001 --document-path manuscript.md
python3 scripts/claim_audit.py add-claim claim-audit.json --id CLM-001 --text "Claim text" --location "Results, paragraph 3" --claim-type quantitative
python3 scripts/claim_audit.py set-verdict claim-audit.json --claim-id CLM-001 --verdict VERIFIED --source-id SRC-001 --source-pointer paper.pdf --locator "p. 4, Results" --support-note "人群、数字和时间点一致"
python3 scripts/claim_audit.py validate claim-audit.json
python3 scripts/claim_audit.py summary claim-audit.json
python3 scripts/claim_audit.py gate claim-audit.json
gate
:PASS 返回 0,REVIEW 返回 1,BLOCK 返回 2。
bash
python3 scripts/claim_audit.py init claim-audit.json --document-id DOC-001 --document-path manuscript.md
python3 scripts/claim_audit.py add-claim claim-audit.json --id CLM-001 --text "Claim text" --location "Results, paragraph 3" --claim-type quantitative
python3 scripts/claim_audit.py set-verdict claim-audit.json --claim-id CLM-001 --verdict VERIFIED --source-id SRC-001 --source-pointer paper.pdf --locator "p. 4, Results" --support-note "人群、数字和时间点一致"
python3 scripts/claim_audit.py validate claim-audit.json
python3 scripts/claim_audit.py summary claim-audit.json
python3 scripts/claim_audit.py gate claim-audit.json
gate
: Returns 0 for PASS, 1 for REVIEW, and 2 for BLOCK.

运行规则

Operating Rules

  • DOI 或文献存在只能证明来源存在。
  • VERIFIED
    必须有具体 locator 和支持说明。
  • 来源支持范围小于句子范围时,收窄句子。
  • 摘要不能支持摘要未报告的细节。
  • 作者解释、测得结果和当前推断分开核验。
  • 数字同时核对分母、单位、时间点、人群和分析集。
  • 因果措辞需要与设计和来源措辞相符。
  • 无法访问全文时使用
    UNVERIFIABLE_ACCESS
    ,不能写成
    VERIFIED
  • 不自动修改文稿;先输出核验结果和修复动作。
  • The existence of a DOI or literature only proves the existence of the source.
  • VERIFIED
    must include a specific locator and supporting explanation.
  • Narrow down the sentence if the scope of source support is smaller than the sentence scope.
  • Abstracts cannot support details not reported in the abstract.
  • Verify author interpretations, measured results, and current inferences separately.
  • For figures, simultaneously check the denominator, unit, time point, population, and analysis set.
  • Causal wording must match the design and source wording.
  • Use
    UNVERIFIABLE_ACCESS
    when full text is unavailable; do not mark it as
    VERIFIED
    .
  • Do not automatically modify the manuscript; first output the verification results and repair actions.

输出

Output

  • Claim Audit JSON。
  • verdict 计数和 PASS/REVIEW/BLOCK 状态。
  • 每条问题的文稿位置、来源位置、差异和修复动作。
  • Claim Audit JSON.
  • Verdict count and PASS/REVIEW/BLOCK status.
  • Manuscript location, source location, discrepancies, and repair actions for each issue.

停止条件

Stop Conditions

  • 没有文稿版本或主张位置时,不开始批量核验。
  • 找不到来源原文时,不给
    VERIFIED
  • DISTORTED
    UNSUPPORTED
    未处理时,状态保持 BLOCK。
  • Do not start batch verification if there is no manuscript version or claim location.
  • Do not mark as
    VERIFIED
    if the original source cannot be found.
  • Keep the status as BLOCK if
    DISTORTED
    or
    UNSUPPORTED
    items are unresolved.

接续

Follow-up

  • 提取原文:
    rw-paper-extractor
  • 调整论文:
    rw-phd-write
  • 核对引用身份和格式:
    rw-citation-audit
  • 审查结论:
    rw-research-referee
  • 局部修改:
    rw-revision-patch
  • Extract original text:
    rw-paper-extractor
    .
  • Revise paper:
    rw-phd-write
    .
  • Verify citation identity and format:
    rw-citation-audit
    .
  • Review conclusions:
    rw-research-referee
    .
  • Partial revision:
    rw-revision-patch
    .