fact-checker

Fact Checker — Multi-Agent Document Fact-Checking

Two-phase pipeline architecture:

Phase 1 (Splitter): gemini-2.0-flash → split sentences, classify (factual/subjective), extract claims
Phase 2 (Verifier): gemini-2.5-flash + Google Search → fact-check each sentence and each claim

How to Use

# 完整核查
python {SKILL_DIR}/scripts/fact_checker.py <file.md>

# 指定章节
python {SKILL_DIR}/scripts/fact_checker.py <file.md> --chapters 2,3

# 仅拆句（检查 Phase1 质量，不花搜索费用）
python {SKILL_DIR}/scripts/fact_checker.py <file.md> --split-only

Preview document structure

python {SKILL_DIR}/scripts/fact_checker.py <file.md> --dry-run


## 参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `-o, --output` | 输出目录 | 文件同目录 |
| `--split-model` | Phase1 模型 | gemini-2.0-flash |
| `--verify-model` | Phase2 模型 | gemini-2.5-flash |
| `--split-concurrency` | Phase1 并发 | 5 |
| `--verify-concurrency` | Phase2 并发 | 3 |
| `--chapters` | 章节过滤 | 全部 |
| `--split-only` | 仅拆句 | false |
| `--dry-run` | 仅解析 | false |

## 输出文件

| 文件 | 说明 |
|------|------|
| `{stem}_sentences.json` | Phase1: 全部句子 + 分类 + 声明 |
| `{stem}_factcheck.json` | Phase2: 完整核查结果 |
| `{stem}_issues.json` | 仅 incorrect / not_found 条目 |

## 编号规则

`C{章}.S{节}.SS{小节}.P{段落}.T{句子}.K{声明}`

示例：`C2.S1.P3.T2.K1` = 第1章(C2) > 第1节 > 第3段 > 第2句 > 第1个声明

## 工作流建议

1. `--dry-run` → 确认文档结构和章节编号
2. `--split-only` → 检查拆句和分类质量
3. 完整核查 → 查看 `_issues.json` 定位问题
4. 对大文档按章节分批核查（`--chapters 2,3` + `--chapters 4,5`）

About this skill

How to Use