Source Tracking · Graphify

Source Tracking Skill

Source Tracking 是 Graphify 中的驗證型 skill，專注於追蹤圖譜中每個知識的來源文件，確保事實準確性與可驗證性。

何時使用

在以下情況中使用 Source Tracking skill：

✅ 需要使用的情境：

需要驗證提取知識的準確性
想要了解知識的原始來源
需要追溯資訊的傳播路徑
進行知識品質審計

❌ 不適合的情境：

簡單的圖譜瀏覽
不需要來源資訊的查詢

追蹤流程

第一步：附加來源資訊

在提取時附加來源：

// 提取實體時附加來源
{
  "entity": "Graphify",
  "type": "Project",
  "sources": [
    {
      "document": "README.md",
      "location": "line 5",
      "timestamp": "2024-01-15T10:30:00Z",
      "confidence": 0.95
    }
  ]
}

第二步：驗證來源

追蹤回原始文件：

graphify verify "Graphify 是一個專案"
# → 返回：README.md, line 5

第三步：更新追蹤

維護來源變更歷史：

{
  "entity": "Graphify",
  "version": 2,
  "sources": [
    { "document": "README.md", "line": 5 },
    { "document": "docs/introduction.md", "line": 12 }  // 新增來源
  ],
  "history": [
    { "action": "add_source", "document": "docs/introduction.md", "when": "2024-01-16" }
  ]
}

如何使用 Source Tracking Skill

觸發詞

「使用 source-tracking skill 驗證這個知識」

實際範例

使用者輸入：

使用 source-tracking skill 驗證：「張三是 Graphify 專案的核心開發者」

AI 回應：

正在使用 Source Tracking skill 驗證...

**驗證結果**：✓ 確認

**來源文件**：
1. README.md（第 12 行）
   > 「核心開發者：張三（後端架構）、李四（前端介面）」
   - 置信度：0.98
   - 提取時間：2024-01-15

2. docs/team.md（第 8 行）
   > 「張三 - Tech Lead，負責後端架構設計」
   - 置信度：0.95
   - 提取時間：2024-01-16

**來源一致性**：兩個文件一致確認此資訊

**最後更新**：2024-01-16（提取自 docs/team.md）

追蹤維度

維度一：文件來源

追蹤知識來自哪個文件：

{
  "entity": "React",
  "sources": [
    { "document": "package.json" },
    { "document": "docs/architecture.md" },
    { "document": "README.md" }
  ]
}

維度二：行號位置

精確到行號：

{
  "entity": "張三",
  "sources": [
    { "document": "README.md", "line": 12 },
    { "document": "docs/team.md", "line": 8 }
  ]
}

維度三：時間戳記

記錄提取時間：

{
  "entity": "Graphify",
  "extracted_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-16T14:20:00Z"
}

維度四：置信度

記錄提取的置信度：

{
  "entity": "LLM",
  "confidence": 0.92,
  "reasoning": "在多個文件中被明確提及"
}

驗證操作

操作一：驗證單一事實

graphify verify "張三是 Graphify 專案的核心開發者"

回覆：

✓ 事實確認

來源：
- README.md（第 12 行）
- docs/team.md（第 8 行）

置信度：0.98

操作二：驗證實體完整性

graphify verify-entity "Graphify"

回覆：

**實體「Graphify」驗證報告**：

已驗證屬性：
- ✓ 描述（來源：README.md, docs/introduction.md）
- ✓ 版本（來源：package.json）
- ✓ 負責人（來源：docs/team.md）

未驗證屬性：
- ⚠️ 發布日期（無來源）
- ⚠️ 許可證（無來源）

建議：補充發布日期與許可證資訊

操作三：驗證關係

graphify verify-relation "張三 WORKS_ON Graphify"

回覆：

✓ 關係確認

來源：
- README.md（第 15 行）：「張三參與 Graphify 開發」
- docs/team.md（第 10 行）：「張三負責 Graphify 後端」

置信度：0.95

品質評估

評估一：來源覆蓋率

graphify quality-coverage

回覆：

**來源覆蓋率報告**：

- 實體：89% 有來源追蹤（452/508）
- 關係：76% 有來源追蹤（384/505）
- 屬性：92% 有來源追蹤（621/675）

需要關注：
- 56 個實體無來源（建議補充）
- 121 個關係無來源（建議驗證）

評估二：來源一致性

graphify quality-consistency

回覆：

**來源一致性報告**：

一致事實：95%
衝突事實：5%

**衝突案例**：
1. Graphify 版本
   - README.md 說：v1.0.0
   - package.json 說：v1.2.0
   - → 需要確認正確版本

評估三：置信度分佈

graphify quality-confidence

回覆：

**置信度分佈**：

- 高（0.8+）：78% 的知識
- 中（0.5-0.8）：18% 的知識
- 低（< 0.5）：4% 的知識

建議：
- 重新驗證低置信度知識
- 補充來源提升置信度