关于 fact-checker
fact-checker 是用于核查文档事实性陈述的技能,适合检查技术规格、统计数据和版本信息。它会对照权威来源生成更正报告,并在获得批准后才修改内容。
主要功能
- 01识别可核实的陈述
- 02检索权威来源
- 03对照来源核验说法
- 04生成更正报告
- 05经批准后应用修改
适用场景
- 01核查模型规格
- 02验证文档中的统计数据
- 03查找过时的版本号
- 04审查报告中的事实说法
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nicepkg/ ai-workflow --skill fact-checker安装后在 Claude Code 中输入/fact-checker确认已加载。
附带文件.security-scan-passedREADME.md
详细介绍
事实核查
核验文档中的事实性陈述,并提出有权威来源佐证的修正建议。
适用场景
当用户请求以下操作时触发:
- “对本文档进行事实核查”
- “核验这些 AI 模型规格”
- “检查这些信息是否仍然准确”
- “更新此文件中过时的数据”
- “验证本节中的陈述”
工作流
复制此清单以跟踪进度:
Fact-checking Progress:
- [ ] Step 1: Identify factual claims
- [ ] Step 2: Search authoritative sources
- [ ] Step 3: Compare claims against sources
- [ ] Step 4: Generate correction report
- [ ] Step 5: Apply corrections with user approval
第 1 步:识别事实性陈述
扫描文档,找出可核验的陈述:
目标陈述类型:
- 技术规格(上下文窗口、定价、功能)
- 版本号和发布日期
- 统计数据和指标
- API 功能和限制
- 基准测试得分和性能数据
跳过主观内容:
- 观点和建议
- 解释性文字
- 教程说明
- 架构讨论
第 2 步:搜索权威来源
针对每项陈述,搜索官方来源:
AI 模型:
- 官方公告页面(anthropic.com/news、openai.com/index、blog.google)
- API 文档(platform.claude.com/docs、platform.openai.com/docs)
- 开发者指南和发行说明
技术库:
- 官方文档网站
- GitHub 仓库(发行版本、README)
- 软件包注册表(npm、PyPI、crates.io)
一般性陈述:
- 学术论文和研究
- 政府统计数据
- 行业标准组织
搜索策略:
- 使用模型名称 + 规格(例如:“Claude Opus 4.5 context window”)
- 查询近期信息时加入当前年份
- 尽可能通过多个来源核验
第 3 步:对照来源核验陈述
创建对照表:
| 文档中的陈述 | 来源信息 | 状态 | 权威来源 |
|---|---|---|---|
| Claude 3.5 Sonnet:200K tokens | Claude Sonnet 4.5:200K tokens | ❌ 模型名称已过时 | platform.claude.com/docs |
| GPT-4o:128K tokens | GPT-5.2:400K tokens | ❌ 版本和规格均不正确 | openai.com/index/gpt-5-2 |
状态代码:
- ✅ 准确 - 陈述与来源一致
- ❌ 不正确 - 陈述与来源矛盾
- ⚠️ 已过时 - 陈述曾经正确,但现已被更新信息取代
- ❓ 无法核验 - 未找到权威来源
第 4 步:生成修正报告
按结构化格式呈现调查结果:
## Fact-Check Report
### Summary
- Total claims checked: X
- Accurate: Y
- Issues found: Z
### Issues Requiring Correction
#### Issue 1: Outdated AI Model Reference
**Location:** Line 77-80 in docs/file.md
**Current claim:** "Claude 3.5 Sonnet: 200K tokens"
**Correction:** "Claude Sonnet 4.5: 200K tokens"
**Source:** https://platform.claude.com/docs/en/build-with-claude/context-windows
**Rationale:** Claude 3.5 Sonnet has been superseded by Claude Sonnet 4.5 (released Sept 2025)
#### Issue 2: Incorrect Context Window
**Location:** Line 79 in docs/file.md
**Current claim:** "GPT-4o: 128K tokens"
**Correction:** "GPT-5.2: 400K tokens"
**Source:** https://openai.com/index/introducing-gpt-5-2/
**Rationale:** 128K was output limit; context window is 400K. Model also updated to GPT-5.2
第 5 步:在用户批准后应用修正
修改前:
- 向用户展示修正报告
- 等待明确批准:“是否应用这些修正?”
- 仅在获得确认后继续
应用修正时:
# Use Edit tool to update document
# Example:
Edit(
file_path="docs/03-写作规范/AI辅助写书方法论.md",
old_string="- Claude 3.5 Sonnet: 200K tokens(约 15 万汉字)",
new_string="- Claude Sonnet 4.5: 200K tokens(约 15 万汉字)"
)
修正后:
- 核验所有编辑均已成功应用
- 记录修正摘要(例如:“已更新第 2.1 节中的 4 项陈述”)
- 提醒用户提交更改
搜索最佳实践
构造查询
优质查询(具体、及时):
- “Claude Opus 4.5 context window 2026”
- “GPT-5.2 official release announcement”
- “Gemini 3 Pro token limit specifications”
较差查询(模糊、笼统):
- “Claude context”
- “AI models”
- “Latest version”
评估来源
优先选择官方来源:
- 产品官方页面(权威性最高)
- API 文档
- 官方博客公告
- GitHub 发行版本(针对开源项目)
谨慎使用:
- 第三方聚合网站(llm-stats.com 等)——需对照官方来源核验
- 博文和文章——交叉核对其中的陈述
- 社交媒体——仅用于了解公告,并需通过其他来源核验
避免使用:
- 过时的文档
- 未附引用来源的非官方维基
- 推测和传闻
处理歧义
来源相互矛盾时:
- 优先采用最新的官方文档
- 在报告中注明差异
- 向用户展示两个来源
- 如果问题很重要,建议联系供应商
未找到来源时:
- 标记为 ❓ 无法核验
- 建议改用其他表述:“截至[日期],根据[来源]……”
- 建议添加限定词:“约”“据报告”
特殊注意事项
时效性信息
始终包含时间背景:
恰当的修正:
- “截至 2026 年 1 月”(截至 2026 年 1 月)
- “Claude Sonnet 4.5(于 2025 年 9 月发布)”
不恰当的修正:
- “最新版本”(会过时)
- “当前模型”(时间范围不明确)
数值精度
数值精度应与来源一致:
来源写的是:“约 100 万 tokens” 写作:“1M tokens(约)”
来源写的是:“200,000 token 上下文窗口” 写作:“200K tokens”(精确值)
引用格式
在修正中包含引用:
> **注**:具体上下文窗口以模型官方文档为准,本书写作时使用 Claude Sonnet 4.5 为主要工具。
尽可能链接到来源。
示例
示例 1:技术规格更新
用户请求:“核实第 2.1 节中的 AI 模型上下文窗口”
流程:
- 确定相关说法:Claude 3.5 Sonnet(200K)、GPT-4o(128K)、Gemini 1.5 Pro(2M)
- 搜索当前模型的官方文档
- 查找:Claude Sonnet 4.5、GPT-5.2、Gemini 3 Pro
- 生成报告,说明差异
- 获得批准后应用修正
示例 2:统计数据核验
用户请求:“核实第 5 章中的基准测试分数”
流程:
- 提取数值说法
- 搜索官方基准测试发布信息
- 对比报告值与来源值
- 标记差异并附上来源链接
- 使用核实后的数据更新
示例 3:版本号验证
用户请求:“检查这些库版本是否仍然是最新版本”
流程:
- 列出所有提及的版本号
- 检查软件包注册表(npm、PyPI 等)
- 找出过时的版本
- 提供更新建议并附上变更日志参考
- 在用户确认后更新
质量检查清单
完成事实核查前:
- 已识别并分类所有事实性说法
- 已根据官方来源核实每项说法
- 来源权威且时效性良好
- 修正报告清晰且可执行
- 在相关情况下已包含时间背景
- 修改前已获得用户批准
- 已验证所有编辑均成功
- 已向用户提供摘要
局限性
此技能无法:
- 核实主观意见或判断
- 访问付费墙或受限来源
- 判定存在争议的说法“是否属实”
- 预测未来的规格或功能
遇到这类情况时:
- 在报告中注明局限性
- 建议使用限定性措辞
- 建议用户自行研究或咨询专家
评论
支持 Markdown