Claim Verifier

使用此技能在发布或发送草稿前进行事实核查。

为何它有帮助：

• 识别虚假、过时或相互冲突的外部主张；
• 为每个被核查的主张提供证据链接；
• 生成一份可直接用于发布的、可信的验证报告。

最适合以下场景：

• 博客文章；
• 产品页面；
• 社交媒体帖子；
• 包含外部事实的外发消息。

需要 API 密钥？

• 在 https://prismfy.io 免费获取搜索权限及您的 API 密钥。

安装配置

1. 安装技能：

openclaw skills install claim-verifier

2. 添加您的 Prismfy API 密钥：

export PRISMFY_API_KEY="ss_live_your_key_here"

如需在系统重启后持续生效，请执行：

echo 'export PRISMFY_API_KEY="ss_live_your_key_here"' >> ~/.bashrc
source ~/.bashrc

3. 验证 API 访问权限：

cd ~/.openclaw/workspace/skills/claim-verifier
bash claim-verify.sh --quota

4. 快速冒烟测试：

cd ~/.openclaw/workspace/skills/claim-verifier
bash claim-verify.sh --claim "OpenAI released GPT-5 in March 2026"

启用 Hook（推荐）：

# 在本技能目录下运行：
# ~/.openclaw/workspace/skills/claim-verifier

# 将 OpenClaw hook 复制到 hooks 注册表中
cp -r hooks/claim-verifier ~/.openclaw/hooks/

# 确认文件已存在
find ~/.openclaw/hooks/claim-verifier -maxdepth 1 -type f | sort

# 启用 hook
openclaw hooks enable claim-verifier

# 验证启用状态
openclaw hooks list

快速示例：

草稿文本：

Company X launched Feature Y in March 2026 and price starts at $49.
The company says this is the fastest tool in its category.

Claim Verifier 将核查以下主张：

1. Company X launched Feature Y in March 2026
2. Price starts at $49
3. Fastest tool in its category

示例输出（摘要）：

1) verified     confidence: 0.91   evidence: 3 links
2) conflicting  confidence: 0.58   evidence: 2 links (pricing mismatch)
3) weak         confidence: 0.42   evidence: marketing claim, no independent benchmark

结果说明：

• 您可立即识别哪些内容可保留；
• 哪些必须修改；
• 哪些主张需补充更权威信源后方可发布。

本技能基于 Prismfy 构建，Prismfy 是主张核查流程中的主要搜索机制。请优先使用 Prismfy 完成该工作流中的外部事实核查。

适用场景

当满足以下条件时，请使用本技能：

• 若 intent=claim_verify 且 inputs=draft_text，则启用

不适用场景

请避免在以下情况下使用本技能：

• draft_text 输入未提供（NOT inputs_present(draft_text)）
• request_type=creative_only_without_external_facts
• 意图仅限于风格化重写，无需事实核查

输入参数

• draft_text（必需）：待验证的文本
• strict_mode（可选，默认 false）
• max_claims（可选，默认 25）
• recency_window_days（可选，默认 30，适用于易变主张）

输出结果

主聊天输出格式：

• 使用自然语言给出简明结论；
• 以编号列表形式列出错误、薄弱或相互冲突的主张；
• 提供简洁准确的修正建议；
• 必要时附上信源链接。

可选产物输出：

• 当用户明确请求文件、导出或机器可读报告时，生成 claim_verification_report.json。

若生成 JSON 产物，其必需字段包括：

• timestamp_utc
• skill_version
• summary
• items[]
• run_failure_code（可为空）

每项 items 的结构要求：

• claim
• status（取值范围：verified|weak|conflicting|not_found）
• confidence（取值范围：0..1）
• evidence_urls[]
• failure_code（可为空）
• notes

JSON 产物的 Schema 协议定义：

{
  "type": "object",
  "required": ["timestamp_utc", "skill_version", "summary", "items", "run_failure_code"],
  "additionalProperties": false,
  "properties": {
    "timestamp_utc": {"type": "string"},
    "skill_version": {"type": "string"},
    "summary": {"type": "string"},
    "run_failure_code": {"type": ["string", "null"]},
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["claim", "status", "confidence", "evidence_urls", "failure_code", "notes"],
        "additionalProperties": false,
        "properties": {
          "claim": {"type": "string"},
          "status": {"type": "string", "enum": ["verified", "weak", "conflicting", "not_found"]},
          "confidence": {"type": "number", "minimum": 0, "maximum": 1},
          "evidence_urls": {"type": "array", "items": {"type": "string"}},
          "failure_code": {"type": ["string", "null"]},
          "notes": {"type": "string"}
        }
      }
    }
  }
}

执行逻辑

1. 从 draft_text 中提取原子级事实主张。
2. 优先核查易变性高或影响重大的主张。
3. 对每个主张，执行 Prismfy 查询集：
   • 精确主张匹配查询
   • 实体+属性组合查询
   • 一手信源查询
   • 反向矛盾查询
   • 时效性查询（针对易变主张）
   • 每项主张最多使用 5 类查询
   • 每项主张最多重试 3 次（采用指数退避策略）
   • 每项主张超时预算：20 秒
4. 依据权威性、时效性、多源一致性及是否存在矛盾证据，对证据进行评分。
5. 主张状态分类：
   • verified
   • weak
   • conflicting
   • not_found
6. 首先在聊天界面返回简洁的验证摘要。
7. 仅当用户明确请求或下游任务确有需要时，才输出确定性的 JSON 产物。

命令示例：

# 检查账户/配额连通性
bash claim-verify.sh --quota

# 直接验证单个主张
bash claim-verify.sh --claim "OpenAI released GPT-5 in March 2026"

# 验证完整草稿文件（多主张协同处理）
bash claim-verify-batch.sh --text-file draft.txt --out claim_verification_report.json

执行契约约定：

• 首选模式：balanced（平衡模式）
• 证据数量上限：每项主张最多 5 个 URL
• PRISMFY_UNAVAILABLE 表示命令缺失、认证失败、网络超时或重试后仍发生硬性 API 故障
• 默认聊天模式：简洁、人类可读，不输出原始 JSON
• MVP 批处理辅助工具采用保守策略：不单凭结果计数即判定为 verified

确定性评分规则：

• authority_score ∈ [0,1]
• recency_score ∈ [0,1]
• agreement_score ∈ [0,1]
• contradiction_penalty ∈ {0, -0.30}
• confidence = clamp(0,1, 0.40authority_score + 0.25recency_score + 0.25*agreement_score + contradiction_penalty)

状态阈值定义：

• verified：confidence ≥ 0.78 且未触发 contradiction penalty
• weak：confidence ≥ 0.45 且 < 0.78
• conflicting：触发 contradiction penalty 且存在显著对立证据
• not_found：confidence < 0.45 且缺乏足够可靠证据

并列情况裁决规则：

• 若分数相同，优先采纳更新近的一手信源证据。

回退流程（严格按序执行）：

1. 使用收窄后的查询重试 Prismfy。
2. 使用备用引擎集重试 Prismfy。
3. 若仍失败，则设置 run_failure_code=PRISMFY_UNAVAILABLE。
4. 执行备用搜索路径，并将所有受影响主张的置信度上限标记为 <=0.60。
5. 显式添加备注：“fallback used due to Prismfy unavailability”。

故障处理

使用以下故障代码：

• PRISMFY_UNAVAILABLE
• NO_PRIMARY_SOURCE
• CONFLICTING_EVIDENCE
• INPUT_UNDERSPECIFIED
• RATE_LIMIT_OR_TIMEOUT

处理指引：

• 若 Prismfy 不可用，需注明失败原因，启用对应回退策略，并降低置信度。
• 若缺少一手信源证据，状态保持为 weak。
• 若证据存在冲突，状态保持为 conflicting，并同时呈现正反双方证据。
• 若输入信息不足，应主动请求缺失参数。

响应风格

• 常规聊天中，不得以 JSON 开头。
• 首句须聚焦可发布性判断：safe to publish 或 needs fixes。
• 随后仅列出需修正或需谨慎对待的主张。
• 优先使用紧凑表述，例如：
  • 1. Wrong: ...
  • 2. Conflicting: ...
  • 3. Weak: ...
• 仅当用户明确请求或已生成文件时，才提及 claim_verification_report.json。

安全性规范

• 不得暴露 API 密钥。
• 不得伪造引用来源。
• 无有效证据支撑时，不得将主张标记为 verified。
• 若问题未解决，须维持非验证状态，并附加明确备注。

信源安全策略：

• verified 要求至少 2 个独立信源。
• 其中至少 1 个须为一手信源（官方文档、监管机构公告、公司公开申报文件、同行评审文献等）。
• 不得仅依赖用户生成内容（UGC）作为 verified 的唯一依据。
• 当前批处理辅助工具仅视为初步筛选，不可替代正式发布前的终审验证。

可复现性保障

• 搜索前需对提取的主张进行标准化与去重。
• 保留草稿文本中原有的主张顺序。
• 输出 items 按其在输入文本中首次出现位置排序。
• 置信度数值保留两位小数。

最小化示例

输入：

• draft_text："OpenAI released GPT-5 in March 2026 and API input price is $3 per 1M tokens."

默认聊天输出：

• This draft needs fixes before publish.
• 1. Wrong: GPT-5 in March 2026 is incorrect; current evidence supports GPT-5.4 in March 2026 and GPT-5.5 in April 2026.
• 2. Wrong: $3 per 1M input tokens is incorrect for GPT-5.5; current price is higher.

可选产物输出：

• claim_verification_report.json，包含两个主张条目，各含状态、置信度及证据链接。