CloudyWing/fact-check-note

技術內容事實校閱

對使用者提供的技術文件、筆記或說明進行逐條查核，標記可能有誤或已過時的資訊，產出可供 apply-fact-check skill 接續處理的結構化報告。

校閱範圍

1. 觀念正確性

• 技術定義是否正確（如「同步」與「非同步」的說明、「堆疊」與「堆積」的區分）？
• 比較說明是否有邏輯矛盾？

2. 術語一致性

• 同一概念是否在文件中使用了多個不同名稱但未說明對應關係？
• 術語是否符合該技術領域的慣用說法（如 .NET 慣用「例外」而非「異常」）？

3. API / 版本正確性

• 提到的方法名稱、屬性名稱是否存在於宣稱的版本中？
• 是否引用了已廢棄 (deprecated) 或已移除的 API？
• 版本號與功能的對應是否正確？

4. 命令與路徑

• 文件中的 CLI 指令是否有明顯的語法錯誤？
• 範例路徑是否符合目標平台慣例（Windows vs Unix）？

Web Search 查證最低底線

以下情境為強制查證底線，必須使用 Web Search 工具查閱官方文件或版本發布說明，不得僅依賴訓練資料作答：

• 文件中提及特定版本號的 API 行為或功能。
• 文件中引用了可能在近期版本中異動的方法、屬性或套件。
• AI 對某項說法「不確定但有印象」，無法明確說出文件來源。
• 文件內容與 AI 訓練資料中的認知有出入，但無法確定哪方正確。

上述為不可省略的最低要求。Agent 應依自身判斷對其他項目額外查證，本清單不是天花板。

嚴重程度分級規則 (Crucial)

報告中條目嚴重程度的分類為責任分界，必須嚴格遵守：

• ❌ 有誤：必須同時滿足兩個條件：
  1. 校閱者能明確指出錯誤之處。
  2. 附上官方來源連結（RFC、官方文件、法規原文、IANA 註冊、官方 GitHub Release 等）。
  • 不符合上述條件者一律降格為 ⚠️。即使校閱者「確信」某說法錯誤，只要拿不出公開依據，仍屬 ⚠️。
• ⚠️ 待確認：校閱者有疑慮但無法獨立判定，需使用者裁決。
• ✅ 無需修正：校閱者已查核且確認與官方資料一致。

❌ 對改檔方為事實層約束（不可違反），⚠️ 為待裁決事項。校閱者不得用權威語氣表達主觀判斷。

輸出位置與 Rotation

校閱完成後，將報告寫入 <work-root>/.local/ai-sessions/fact-check-report.md。

寫入前 Rotation（避免覆蓋歷史）

寫入新報告前，若 fact-check-report.md 已存在：

1. 讀取舊檔的 校閱時間 欄位（格式 YYYY-MM-DD HH:mm）。
2. 將舊檔 rename 為 fact-check-report-<YYYYMMDD-HHmm>.md（去除分隔符號）。
3. 若舊檔缺少有效時間欄位，改以舊檔的最後修改時間（mtime）作為命名依據。
4. Rotation 完成後，再寫入新報告至 fact-check-report.md。

此 rotation 由校閱端負責，apply-fact-check 永遠只讀固定名稱的 fact-check-report.md。

報告格式

# 事實校閱報告

- **目標文件**：[完整檔案路徑]
- **校閱時間**：YYYY-MM-DD HH:mm

## ❌ 有誤（事實層約束，不可違反）

### 條目 1

- **位置**：第 X 行（或第 X-Y 行）
- **原文（verbatim）**：

  > [完整引用，必須足以唯一定位至文件中該行，不得僅截關鍵詞]

- **錯誤事實**：[具體說明錯誤之處]
- **正確事實（binding）**：[修正後的技術事實陳述]
- **建議措辭（reference only）**：[供改檔方參考的改寫範例；改檔方應依文件語氣自行重寫，不必照抄]
- **官方依據**：[完整 URL，並標明文件名稱與章節]

## ⚠️ 待確認

### 條目 1

- **位置**：第 X 行
- **原文（verbatim）**：

  > [完整引用]

- **疑慮**：[說明不確定之處]
- **建議查閱**：[對應的官方文件或規格來源；若已查過仍無法確認，註明「已查閱 X，但未找到明確依據」]

## ✅ 已查核且未發現問題

[簡述已查核的範圍或項目]

重要限制

• 單一檔案校閱：本 skill 一次處理一個目標文件，產出對應的單份報告。多份文件需分次執行。
• 不修改原文：此 skill 僅產出報告檔，不直接更改文件內容。修改動作由 apply-fact-check skill 負責。
• 誠實標示不確定性：若無法以官方依據確認，必須降為 ⚠️，不得包裝為 ❌。
• 不補充「最新資訊」：若原文說法有時效性疑慮，僅標記並提示使用者查閱，不依訓練資料自行補充最新資訊。
• 完成後不主動套用修改：此 skill 職責止於產出報告。後續是否進入改檔流程由使用者決定並另行呼叫 apply-fact-check。