SuperAPI AI 工具集

verify-claims

营销与增长

查看项目

更新于 10-16 09:02

技能介绍

用途

该技能用于交叉核对营销声明与用户提供的证据数据。它从内容中提取所有可验证的声明——统计数字、百分比、排名、奖项、认证、具名引用、业绩指标、客户数量以及时间限定表述——然后逐条与证据文件匹配,并分类为已验证、部分验证、未验证或与证据矛盾。该命令是声明完整性的专项深度检查,而 /digital-marketing-pro:eval-content 则将声明验证作为其更广泛质量评估的一个维度。

引用具体数字、奖项或结果却缺乏验证依据的营销内容会带来品牌风险。若被客户、记者或监管机构发现,与证据矛盾的声明会侵蚀信任。该命令确保内容中的每项事实性断言都有真实数据支撑、来源清晰,并能在审查下站得住脚。

所需输入

用户必须提供(或将被提示提供):

  • 含声明的内文:要验证的文本——可内联提供、作为粘贴块提供,或作为文件路径提供。任何做出事实性断言的营销内容:落地页、案例研究、新闻稿、广告文案、推介演示文稿、投资者材料、产品页或客户报告。
  • 证据文件(可选但强烈建议):包含用于核对的源数据的 JSON 文件。格式:[{"claim": "描述性声明文本", "source": "数据源名称或 URL", "date": "YYYY-MM-DD 验证日期", "verified": true/false, "value": "已验证的数字或事实"}]。可从 GA4、CRM、销售数据、认证机构导出,或手动整理。若未提供,命令将以仅提取模式运行,并引导用户创建证据文件。
  • 要检查的具体声明(可选):聚焦单条声明而非扫描全文——适用于对特定统计数字或断言进行快速抽查。

流程

  1. 加载品牌上下文:读取 ~/.claude-marketing/brands/_active-brand.json 获取活动 slug,然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用目标市场的合规规则(skills/context-engine/compliance-rules.md)——某些行业和地区对声明证实有更严格的要求(金融服务、医疗健康、欧盟消费者保护)。同时检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 处是否有指南——若存在,加载可能定义已批准声明和禁止断言的消息限制。检查 ~/.claude-marketing/sops/ 处是否有代理机构 SOP。若不存在品牌,询问:“先设置品牌(/digital-marketing-pro:brand-setup)?”——或使用默认值继续。

  2. 从内容中提取声明:执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/claim-verifier.py" --action extract-claims --text "{content}" 以识别所有可验证断言。提取器按类型对声明分类:

    • 统计声明:百分比、比率、增长数字、市场规模数字(“转化率提升 73%”“4.8 倍 ROAS”)
    • 排名声明:位置断言、比较性陈述(“市场领导者”“排名第一”“增长最快”)
    • 奖项与认证声明:具名奖项、行业认证、合规徽章(“ISO 27001 认证”“G2 Leader”)
    • 具名引用声明:署名引语、来源引用、研究引用(“根据 Gartner”“Forrester 报告”)
    • 业绩声明:客户数量、时间限定结果、SLA 承诺(“10,000+ 客户”“30 天内见效”)
    • 时间声明:特定日期断言、时效性声明(“截至 2026 年”“最新数据显示”)
  3. 对照证据验证声明:若提供了证据文件,执行 python "${CLAUDE_PLUGIN_ROOT}/scripts/claim-verifier.py" --action verify --text "{content}" --evidence {evidence_file}。对于每条提取的声明,验证器会:

    • 尝试通过语义相似度和声明类型将声明与证据条目匹配
    • 对匹配结果分类:已验证(声明在可接受容差内与证据匹配)、部分验证(声明方向正确但具体数字有差异,或来源日期过时)、未验证(未找到匹配的证据条目)或与证据矛盾(证据与声明直接冲突)
    • 根据匹配质量、来源时效性和具体性对齐程度,为每次验证分配置信度分数(0-100)
  4. 处理缺失证据文件:若未提供证据文件,跳过验证步骤。改为呈现所有提取的声明及其类型,并将每条标记为“未验证——未提供证据”。引导用户创建证据文件:

    • 用各声明类型的示例解释 JSON 格式
    • 建议数据源:GA4 用于业绩指标,CRM 用于客户数量,认证机构用于奖项,已发布报告用于行业统计
    • 提供生成预填提取声明的模板证据文件(值留空供用户填写)
  5. 详述矛盾:对于每条与证据矛盾的声明,呈现并排比较:内容中声明的原文、冲突的证据数据、具体差异(例如“内容称增长 73%,证据显示增长 61%”),以及发布错误声明的潜在影响(声誉、监管、竞争)。

  6. 建议更正:对于未验证和与证据矛盾的声明,提供具体建议:

    • 与证据矛盾的声明:建议使用证据值更正文本,若确切数字敏感,提供模糊措辞选项(“大约”“超过 X”“接近 Y”)
    • 未验证的声明:建议添加来源归属、将绝对陈述软化为限定陈述,或在有证据前删除该声明
    • 过时证据:标记证据日期超过 12 个月的声明,并建议刷新数据
  7. 生成验证摘要:产出总体验证分数(已验证或部分验证的声明百分比)、基于与证据矛盾及未验证声明数量和严重程度的风险评估,以及若品牌在受监管行业运营(未经证实的声明会带来法律风险)的合规说明。

输出

一份结构化验证报告,包含:

  • 验证分数:已验证或部分验证的声明百分比——内容声明完整性的首要指标
  • 声明清单:提取的声明总数,按类型细分(统计、排名、奖项、引用、业绩、时间)——显示内容中事实性断言的范围
  • 逐条声明验证结果:对于每条声明:
    • 内容中出现的声明原文及位置
    • 声明类型分类
    • 验证状态:已验证、部分验证、未验证或与证据矛盾
    • 证据匹配:所对照的具体证据条目(如有),含来源和日期
    • 验证的置信度分数(0-100)
    • 问题详情:对于部分验证或与证据矛盾的声明,具体差异
    • 建议操作:保持原样、用正确值更新、添加来源归属、软化措辞或删除
  • 矛盾详情:每条与证据矛盾声明的并排比较——内容文本 vs. 证据数据,突出具体差异并给出更正文本建议
  • 未验证声明列表:所有无匹配证据的声明,按风险等级分组(高风险:具体数字和绝对陈述;中风险:比较性声明和排名;低风险:一般定性断言)
  • 过时证据警告:支持证据超过 12 个月的声明,附刷新数据建议
  • 更正文本建议:对于每条需要更正的声明,给出原文及一个或多个替换选项——使用证据数据的确切值版本,以及带限定词的模糊版本
  • 证据文件模板:若未提供证据文件,提供预填所有提取声明的 JSON 模板,供用户填写已验证值和来源
  • 合规说明:若品牌在受监管行业(金融服务、医疗健康、法律、保险)运营,列出声明证实的具体监管要求及相关规则引用(FTC Act、EU Consumer Rights Directive、ASA CAP Code、行业特定法规)

使用的智能体

quality-assurance——使用模式匹配和 NLP 启发式从内容中提取声明,通过语义相似度和类型对齐进行声明到证据的匹配,带置信度评分的验证状态分类,带差异量化的矛盾检测,带模糊选项的更正文本生成,以及针对受监管行业的合规感知风险评估。