content-validator

Content Validator Skill

Description

Validate whether written content faithfully reflects source materials, ensuring citations are accurate and facts are correct.

Trigger Conditions

"Verify content" "Check accuracy" "Verify citations"
"validate", "verify", "fact check", "check accuracy"
Quality check needed after completing notes or reports

Agent Validation Capabilities

1. Source Comparison

The Agent will compare the written content item by item against the original sources:

# 驗證流程偽代碼
def validate_content(note: str, source: str) -> ValidationResult:
    results = []
    
    # 1. 提取筆記中的所有事實陳述
    claims = extract_claims(note)
    
    # 2. 對每個陳述在來源中尋找支持
    for claim in claims:
        support = find_support_in_source(claim, source)
        if support.found:
            results.append({"claim": claim, "status": "✅ 已驗證", "source": support.location})
        elif support.partial:
            results.append({"claim": claim, "status": "⚠️ 部分支持", "note": support.note})
        else:
            results.append({"claim": claim, "status": "❌ 未找到支持", "action": "需要修正或補充引用"})
    
    return results

2. Data Accuracy Check

Check Item	Validation Method
Numeric Citations	Compare values in the source
Statistical Results	Confirm p-values, CI, OR, etc.
Percentages	Recalculate and verify
Dates/Years	Cross-check with the source

3. Citation Format Check

def check_citations(note: str, references: list) -> list:
    issues = []
    
    # 找出所有引用標記
    citations = find_citation_markers(note)
    
    for cite in citations:
        # 檢查引用是否存在於參考文獻
        if cite not in references:
            issues.append(f"引用 {cite} 不在參考文獻中")
        
        # 檢查引用格式是否正確
        if not is_valid_format(cite):
            issues.append(f"引用 {cite} 格式不正確")
    
    return issues

Execution Flow

Complete Validation Flow

輸入：筆記/報告 + 原始來源
    ↓
Step 1: 事實陳述提取
    - 識別所有可驗證的陳述
    ↓
Step 2: 來源比對
    - 逐一比對來源支持度
    ↓
Step 3: 數據驗證
    - 檢查所有數字和統計
    ↓
Step 4: 引用檢查
    - 驗證引用格式和存在性
    ↓
Step 5: 一致性檢查
    - 檢查內部邏輯一致性
    ↓
輸出：驗證報告 + 修正建議

Output Format

## 內容驗證報告

**驗證時間**: 2024-12-22 10:30
**來源文件**: smith-2024-remimazolam.pdf
**驗證對象**: notes/smith-2024-summary.md

---

### 📊 驗證摘要

| 類別 | 通過 | 警告 | 錯誤 |
|------|------|------|------|
| 事實陳述 | 12 | 2 | 1 |
| 數據引用 | 8 | 1 | 0 |
| 引用格式 | 5 | 0 | 0 |
| **總計** | **25** | **3** | **1** |

**驗證結果**: ⚠️ 需要修正

---

### ✅ 已驗證項目

| 陳述 | 來源位置 |
|------|----------|
| "Remimazolam 起效時間 1-2 分鐘" | p.3, Methods |
| "納入 15 篇 RCT" | p.2, Abstract |
| ... | ... |

### ⚠️ 需要確認

| 陳述 | 問題 | 建議 |
|------|------|------|
| "低血壓發生率降低 22%" | 來源寫 "relative risk 0.78" | 修正為 RR 或計算正確百分比 |
| "2,340 位病患" | 來源寫 "2,334 participants" | 更正數字 |

### ❌ 錯誤項目

| 陳述 | 問題 | 修正建議 |
|------|------|----------|
| "研究結論推薦首選使用" | 來源未有此結論 | 刪除或改為 "作者建議可考慮使用" |

---

### 📝 修正清單

1. [ ] 第 23 行：將 "22%" 改為 "RR 0.78 (22% 相對風險降低)"
2. [ ] 第 31 行：將 "2,340" 改為 "2,334"
3. [ ] 第 45 行：刪除 "首選使用" 改為 "可考慮使用"

---

### ✏️ 自動修正 (可選)

如需自動修正已標記的錯誤，請確認後執行。

Usage Examples

Example 1: Quick Validation

用戶：「驗證這份筆記的準確性」
執行：
1. 讀取筆記和原始來源
2. 提取可驗證陳述
3. 比對驗證
4. 產出驗證報告

Example 2: Data Validation

用戶：「檢查報告中的所有統計數據」
執行：
1. 找出所有數字和統計值
2. 與來源比對
3. 標記不一致項目

Example 3: Citation Check

用戶：「確認所有引用都正確」
執行：
1. 提取所有引用標記
2. 比對參考文獻清單
3. 檢查引用格式

Validation Strictness

Level	Description	Applicable Scenarios
Strict	Every number must be exactly consistent	Published papers, formal reports
Normal	Rounding differences allowed	General notes, internal documents
Lenient	Only check major errors	Quick browsing, first drafts

Related Skills

note-writer - Writing Notes
report-formatter - Formatting Reports
report-writing - Combined Skill: Complete Report Writing