kenaz 0.3.18 → 0.3.19

package/core/.system/failure/README.md

@@ -1,723 +0,0 @@
-# .failure 失敗學習系統
-
-## 系統概述
-
-`.failure/` 是 Kenaz AI 專案的**失敗經驗學習系統**，記錄開發過程中的失敗模式並提供預防措施。所有 Agent 執行任務前必須檢查此系統，避免重複已知錯誤。
-
-**設計理念**：
-- **從失敗中學習**：記錄失敗模式、根本原因、解決方案和預防措施
-- **將錯誤轉化為規則**：重複失敗（>2 次）提升為 `.rule/` 強制規則
-- **建立預防檢查清單**：每個失敗都有可執行的預防步驟
-- **支援工具化**：PowerShell + Node.js 工具腳本自動化流程
-
-**工作流程**：
-```
-失敗 → 記錄到 .failure/ → 分析根因 → 如重複發生（>2 次）→ 提升為 .rule/
-```
-
----
-
-## 目錄結構
-
-```
-.failure/
-├── INDEX.yaml                  # 失敗記錄索引與載入順序
-├── agent-execution/            # Agent 執行失敗（空跑、無輸出、錯誤邏輯）
-│   ├── FAIL-001-agent-no-output.yaml
-│   ├── FAIL-004_agent_platform_specific_commands.md
-│   └── FAIL-005_background_agent_permission_denied.md
-├── code-quality/               # 代碼品質問題（bug、性能、可讀性）
-├── architecture/               # 架構決策失敗（設計缺陷、技術選型錯誤）
-│   └── FAIL-006-python-version-compatibility.yaml
-├── pipeline/                   # Pipeline 系統失敗（任務管理、佇列、統計）
-│   └── FAIL-003-queue-pollution.yaml
-├── data-integrity/             # 數據完整性問題（JSON 損壞、編碼錯誤）
-│   └── FAIL-002-json-bom.yaml
-└── tools/                      # 失敗學習工具腳本
-    ├── check_failures.ps1      # 檢查相關失敗模式
-    ├── log_failure.ps1         # 記錄新失敗經驗
-    ├── validate_json.js        # 驗證 JSON 文件
-    ├── fix_json.js             # 修復 JSON（移除 BOM + 驗證 + 格式化）
-    ├── remove_bom.js           # 移除 UTF-8 BOM
-    ├── check_bom.js            # 批量檢查 BOM
-    ├── README.md               # 工具使用說明
-    └── USAGE_GUIDE.md          # 詳細使用指南
-```
-
----
-
-## 失敗分類
-
-| 分類 | 目錄 | 說明 | 圖標 |
-|------|------|------|------|
-| **Agent 執行失敗** | `agent-execution/` | Agent 空跑、無輸出、錯誤邏輯、平台特定命令失敗 | 🤖 |
-| **代碼品質問題** | `code-quality/` | Bug、性能問題、可讀性、測試覆蓋率不足 | 💻 |
-| **架構決策失敗** | `architecture/` | 設計缺陷、技術選型錯誤、依賴兼容性問題 | 🏗️ |
-| **Pipeline 失敗** | `pipeline/` | 任務管理、佇列污染、統計錯誤、狀態不一致 | ⚙️ |
-| **數據完整性問題** | `data-integrity/` | JSON 損壞、編碼錯誤（BOM）、YAML 解析失敗 | 📊 |
-
-**失敗檔名格式**：
-- YAML 格式：`FAIL-<ID>-<slug>.yaml`（如 `FAIL-001-agent-no-output.yaml`）
-- Markdown 格式：`FAIL-<ID>_<slug>.md`（如 `FAIL-004_agent_platform_specific_commands.md`）
-
----
-
-## 嚴重程度定義
-
-| 級別 | 說明 | 圖標 | 行動 |
-|------|------|------|------|
-| **Critical** 🔴 | 導致系統無法運作或數據損壞 | 🔴 | 立即修復並建立規則 |
-| **High** 🟠 | 嚴重影響功能或效率 | 🟠 | 優先修復並記錄預防措施 |
-| **Medium** 🟡 | 影響體驗但不阻礙功能 | 🟡 | 計劃修復並改進流程 |
-| **Low** 🟢 | 輕微問題或不便 | 🟢 | 記錄並在適當時機優化 |
-
-**範例分佈**（截至 2026-02-17）：
-```yaml
-total_failures: 6
-by_severity:
-  critical: 2   # FAIL-001（Agent 無輸出）, FAIL-005（權限問題）
-  high: 4       # FAIL-002（JSON BOM）, FAIL-003（佇列污染）, FAIL-004（平台命令）, FAIL-006（依賴問題）
-  medium: 0
-  low: 0
-```
-
----
-
-## Agent 使用指南
-
-### 核心規則：AGT-005
-
-**遵循 AGT-005 規則：失敗時必須查閱失敗經驗**（定義於 `.rule/general/agent-workflow.yaml`）
-
-### 使用場景
-
-#### 1. 任務開始前（預防檢查）
-
-**必須執行**：檢查是否有相關失敗模式
-
-```powershell
-# 方法 1：根據任務 ID 檢查（自動載入 TASK_QUEUE.json）
-.\.failure\tools\check_failures.ps1 -TaskID "TASK_XXX"
-
-# 方法 2：根據 Agent 類型檢查
-.\.failure\tools\check_failures.ps1 -AgentType "developer"
-
-# 方法 3：根據 Scope 路徑檢查（針對特定檔案/目錄）
-.\.failure\tools\check_failures.ps1 -ScopePath "dev/pipeline/"
-
-# 方法 4：根據關鍵詞搜尋
-.\.failure\tools\check_failures.ps1 -Keywords "JSON,BOM,encoding"
-
-# 方法 5：過濾分類和嚴重程度
-.\.failure\tools\check_failures.ps1 -Category "pipeline" -Severity "critical"
-```
-
-**輸出結果**：
-- 匹配的失敗記錄數量
-- 每個失敗的預防檢查清單
-- 解決方案參考
-- 相關規則連結
-
-**範例輸出**：
-```
-🔴 FAIL-002: JSON BOM 編碼問題 [high]
-  分類: data-integrity
-
-  預防檢查清單:
-  - [ ] 使用 validate_json.js 驗證 JSON 文件
-  - [ ] 檢查編輯器設置（避免 UTF-8 with BOM）
-  - [ ] 修改 JSON 後立即驗證
-
-  解決方案:
-  - 使用 fix_json.js 一鍵修復（移除 BOM + 驗證 + 格式化）
-
-  相關規則: DATA-001（數據完整性驗證）
-```
-
-#### 2. 任務執行中（數據驗證）
-
-**修改 JSON 文件後立即驗證**：
-
-```bash
-# 驗證 JSON 語法正確性
-node .failure/tools/validate_json.js dev/pipeline/TASK_QUEUE.json
-
-# 一鍵修復 JSON（移除 BOM + 驗證 + 重新格式化）
-node .failure/tools/fix_json.js dev/pipeline/TASK_QUEUE.json
-
-# 僅移除 BOM（不修改其他內容）
-node .failure/tools/remove_bom.js dev/pipeline/TASK_QUEUE.json
-```
-
-**定期維護（CI/CD 整合）**：
-
-```bash
-# 批量檢查 BOM
-node .failure/tools/check_bom.js dev/pipeline --recursive
-
-# Pre-commit Hook 整合
-# .git/hooks/pre-commit
-#!/bin/bash
-node .failure/tools/check_bom.js dev/pipeline --recursive || exit 1
-```
-
-#### 3. 任務失敗後（經驗記錄）
-
-**必須執行**：記錄新失敗經驗
-
-```powershell
-# 方法 1：互動式模式（推薦新手）
-.\.failure\tools\log_failure.ps1 -Interactive
-
-# 方法 2：參數化模式（熟悉系統後使用）
-.\.failure\tools\log_failure.ps1 `
-  -Category "pipeline" `
-  -Title "任務佇列損壞問題" `
-  -Severity "high" `
-  -TaskID "TASK_XXX"
-```
-
-**自動化行為**：
-1. 生成新的 `FAIL-XXX` ID（基於 `INDEX.yaml` 中的最大 ID）
-2. 在對應分類目錄下建立失敗記錄文件（YAML 格式）
-3. 自動更新 `INDEX.yaml` 的：
-   - `load_order` 列表
-   - `statistics.total_failures`
-   - `statistics.by_category`
-   - `statistics.by_severity`
-   - `last_updated` 時間戳
-
-**驗證結果**：
-```powershell
-# 檢查新建立的失敗記錄
-Get-ChildItem .failure/*/FAIL-*.yaml | Sort-Object LastWriteTime -Descending | Select-Object -First 1
-
-# 驗證 INDEX.yaml 更新
-Get-Content .failure/INDEX.yaml | Select-String "FAIL-"
-```
-
----
-
-## 工具詳解
-
-### 1. check_failures.ps1（檢查失敗模式）
-
-**用途**：任務開始前檢查相關失敗模式，執行預防措施
-
-**功能**：
-- 根據任務 ID 自動載入 `TASK_QUEUE.json` 詳情
-- 根據 `agent_type` 匹配相關失敗記錄
-- 根據 `scope_paths` 匹配相關失敗記錄
-- 支援關鍵詞模糊搜尋
-- 輸出預防檢查清單和解決方案參考
-- 按嚴重程度排序顯示結果
-
-**使用範例**：
-```powershell
-# 查看幫助
-.\.failure\tools\check_failures.ps1 -Help
-
-# 根據任務 ID 檢查
-.\.failure\tools\check_failures.ps1 -TaskID "TASK_077"
-
-# 根據 Agent 類型檢查
-.\.failure\tools\check_failures.ps1 -AgentType "developer"
-
-# 根據路徑檢查
-.\.failure\tools\check_failures.ps1 -ScopePath "dev/pipeline/"
-
-# 關鍵詞搜尋
-.\.failure\tools\check_failures.ps1 -Keywords "JSON,BOM"
-
-# 組合過濾
-.\.failure\tools\check_failures.ps1 `
-  -Category "pipeline" `
-  -Severity "high" `
-  -AgentType "developer"
-```
-
----
-
-### 2. log_failure.ps1（記錄失敗經驗）
-
-**用途**：任務失敗後記錄失敗經驗，自動更新索引
-
-**功能**：
-- 自動生成 `FAIL-XXX` ID（根據 `INDEX.yaml` 中的最大 ID）
-- 根據分類選擇正確的目錄
-- 使用標準模板建立 YAML 文件
-- 自動更新 `INDEX.yaml` 的 `load_order` 和統計數據
-- 支援互動式和參數化兩種模式
-
-**使用範例**：
-```powershell
-# 查看幫助
-.\.failure\tools\log_failure.ps1 -Help
-
-# 互動式模式（推薦）
-.\.failure\tools\log_failure.ps1
-
-# 參數化模式
-.\.failure\tools\log_failure.ps1 `
-  -Category "pipeline" `
-  -Title "任務佇列損壞問題" `
-  -Severity "high" `
-  -TaskID "TASK_088"
-```
-
-**互動式流程**：
-1. 選擇失敗分類（agent_execution, code_quality, architecture, pipeline, data_integrity）
-2. 輸入失敗標題
-3. 選擇嚴重程度（critical, high, medium, low）
-4. 輸入相關任務 ID（可選）
-
-**輸出結果**：
-```
-✅ 成功建立失敗記錄: FAIL-007
-   檔案位置: .failure/pipeline/FAIL-007-task-queue-corruption.yaml
-   已更新 INDEX.yaml
-```
-
----
-
-### 3. validate_json.js（驗證 JSON 文件）
-
-**用途**：驗證 JSON 文件完整性，檢測 BOM
-
-**功能**：
-- 驗證 JSON 語法正確性
-- 檢測 BOM (Byte Order Mark)
-- 提供錯誤診斷提示
-
-**使用範例**：
-```bash
-# 驗證單個文件
-node .failure/tools/validate_json.js dev/pipeline/TASK_QUEUE.json
-
-# 驗證多個文件
-node .failure/tools/validate_json.js *.json
-```
-
-**輸出結果**：
-```
-✅ dev/pipeline/TASK_QUEUE.json - Valid JSON (no BOM)
-❌ dev/pipeline/CONFIG.json - Invalid JSON: Unexpected token } in JSON at position 123
-⚠️ dev/pipeline/STATE.json - Valid JSON (BOM detected - use remove_bom.js to fix)
-```
-
----
-
-### 4. fix_json.js（一鍵修復 JSON）
-
-**用途**：一鍵修復 JSON 文件（移除 BOM + 驗證 + 重新格式化）
-
-**功能**：
-- 自動移除 BOM
-- 驗證 JSON 語法
-- 重新格式化（統一縮排 2 空格）
-- 寫回無 BOM 的 UTF-8 文件
-
-**使用範例**：
-```bash
-# 修復單個文件
-node .failure/tools/fix_json.js dev/pipeline/TASK_QUEUE.json
-
-# 修復多個文件
-node .failure/tools/fix_json.js dev/pipeline/*.json
-```
-
-**輸出結果**：
-```
-✅ dev/pipeline/TASK_QUEUE.json - Fixed (removed BOM, reformatted)
-⚠️ dev/pipeline/CONFIG.json - Already valid (no changes needed)
-❌ dev/pipeline/STATE.json - Invalid JSON: Unexpected token }
-```
-
----
-
-### 5. remove_bom.js（移除 BOM）
-
-**用途**：移除 UTF-8 文件開頭的 BOM (Byte Order Mark)
-
-**功能**：
-- 檢測並移除 BOM (0xFEFF)
-- 不修改其他內容
-- 無 BOM 時不做任何操作
-
-**使用範例**：
-```bash
-# 移除單個文件的 BOM
-node .failure/tools/remove_bom.js dev/pipeline/TASK_QUEUE.json
-```
-
-**輸出結果**：
-```
-✅ dev/pipeline/TASK_QUEUE.json - BOM removed
-⚠️ dev/pipeline/CONFIG.json - No BOM found
-```
-
----
-
-### 6. check_bom.js（批量檢查 BOM）
-
-**用途**：批量檢查 JSON 文件是否有 BOM（用於 CI/CD 或 pre-commit hook）
-
-**功能**：
-- 批量檢查 JSON 文件
-- 遞迴掃描目錄（使用 `--recursive`）
-- 列出所有有 BOM 的文件
-- 退出碼：0（無 BOM）或 1（檢測到 BOM）
-
-**使用範例**：
-```bash
-# 檢查單個文件
-node .failure/tools/check_bom.js dev/pipeline/TASK_QUEUE.json
-
-# 遞迴檢查目錄中所有 JSON 文件
-node .failure/tools/check_bom.js dev/pipeline --recursive
-
-# Pre-commit Hook 整合
-# .git/hooks/pre-commit
-#!/bin/bash
-node .failure/tools/check_bom.js dev/pipeline --recursive || exit 1
-```
-
-**輸出結果**：
-```
-Checking JSON files for BOM...
-
-Found 2 files with BOM:
-  - dev/pipeline/TASK_QUEUE.json
-  - dev/pipeline/STATE.json
-
-Recommendation: Run fix_json.js to remove BOM and reformat
-
-Exit code: 1
-```
-
----
-
-## 失敗記錄範例
-
-### FAIL-001: Agent 執行無輸出
-
-**分類**：agent-execution
-**嚴重程度**：Critical 🔴
-**檔案**：`.failure/agent-execution/FAIL-001-agent-no-output.yaml`
-
-**問題**：Agent 執行後沒有實際輸出，導致任務失敗
-**根因**：Agent 未正確理解任務需求或工作流程
-**解決方案**：
-- 明確任務步驟（使用 `requirements` 和 `acceptance_criteria`）
-- 檢查 Skill 定義（確保 Agent 理解角色和職責）
-- 確保輸出驗證（檢查 Git commit、文件修改）
-
-**預防措施**：
-- [ ] 確保任務描述清晰具體
-- [ ] 提供可驗證的驗收標準
-- [ ] 檢查 Agent 的 Skill 定義
-
-**相關規則**：PPL-112（驗收標準驗證）
-
----
-
-### FAIL-002: JSON BOM 編碼問題
-
-**分類**：data-integrity
-**嚴重程度**：High 🟠
-**檔案**：`.failure/data-integrity/FAIL-002-json-bom.yaml`
-
-**問題**：Windows 產生的 JSON 文件帶有 BOM，導致 JSON 解析失敗
-**根因**：Windows 編輯器預設使用 UTF-8 with BOM
-**解決方案**：
-- 使用 `fix_json.js` 一鍵修復（移除 BOM + 驗證 + 格式化）
-- 或使用 `remove_bom.js` 移除 BOM
-
-**預防措施**：
-- [ ] 修改 JSON 文件後立即驗證（使用 `validate_json.js`）
-- [ ] 設置編輯器預設為 UTF-8 without BOM
-- [ ] 在 CI/CD 中整合 `check_bom.js`
-
-**相關規則**：DATA-001（數據完整性驗證）
-
----
-
-### FAIL-003: TASK_QUEUE 污染問題
-
-**分類**：pipeline
-**嚴重程度**：High 🟠
-**檔案**：`.failure/pipeline/FAIL-003-queue-pollution.yaml`
-
-**問題**：已完成任務被移到 `.memory/` 後，Multi-Agent Scheduler 又把它們加回 `TASK_QUEUE.json` 並標記為 completed
-**根因**：Scheduler 從 `completed/` 資料夾同步任務時，會把所有歷史任務重新加入 queue
-**解決方案**：清理時必須同時清理 `TASK_QUEUE.json` 中的 completed 任務
-
-**預防措施**：
-- [ ] 封存任務時同時清理 TASK_QUEUE.json
-- [ ] 驗證 completed/ 目錄為空
-- [ ] 執行排程器前檢查佇列狀態
-
-**相關規則**：PPL-002（已完成任務必須封存到 .memory/）
-**狀態**：已提升為規則（.rule/pipeline/task-execution.yaml）
-
----
-
-## 與其他系統的關係
-
-### 優先級順序
-
-```
-1. .rule/ (最高優先級 - 必須遵守的規則)
-2. .failure/ (失敗經驗 - 應避免的模式)
-3. .memory/ (經驗記錄 - 一般性筆記)
-4. CLAUDE.md (專案指導)
-```
-
-### 升級機制
-
-當失敗模式**重複發生（>2 次）**時，應將其提升為 `.rule/` 規則，成為強制約束。
-
-**範例**：
-```yaml
-失敗: "FAIL-003: TASK_QUEUE 被 completed 任務污染"
-  ↓ 重複發生 2 次
-規則: "PPL-002: 已完成任務必須封存到 .memory/"
-```
-
-**提升標準**：
-- **Critical 失敗**：發生 1 次即提升
-- **High 失敗**：發生 2 次提升
-- **Medium 失敗**：發生 3 次提升
-- **Low 失敗**：視情況決定
-
----
-
-## 執行環境要求
-
-### PowerShell 腳本執行
-
-由於腳本包含中文字符，需要確保 PowerShell 正確支援 UTF-8 編碼。
-
-**推薦執行方式**（Windows PowerShell 或 PowerShell 7+）：
-
-```powershell
-# 方法 1：直接在 Windows PowerShell 中執行
-cd D:\repo\side\ava\KenazAI
-.\.failure\tools\log_failure.ps1 -Help
-
-# 方法 2：使用 PowerShell 7+（推薦）
-pwsh -File ".failure/tools/log_failure.ps1" -Help
-
-# 方法 3：設置編碼（Windows PowerShell 5.1）
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-chcp 65001  # 切換到 UTF-8 代碼頁
-```
-
-### 執行策略限制
-
-```powershell
-# 方法 1：暫時繞過執行策略
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-
-# 方法 2：使用參數執行
-powershell -ExecutionPolicy Bypass -File ".failure/tools/log_failure.ps1" -Help
-```
-
----
-
-## 常見問題
-
-### Q1: 執行腳本時顯示「無法辨識字元」或亂碼
-
-**原因**：PowerShell 預設編碼不是 UTF-8，無法正確解析中文字符。
-
-**解決方案**：
-```powershell
-# 使用 PowerShell 7+（推薦）
-pwsh -File ".failure/tools/log_failure.ps1" -Help
-
-# 或在 Windows PowerShell 5.1 中設置編碼
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-chcp 65001  # 切換到 UTF-8 代碼頁
-```
-
----
-
-### Q2: 執行策略阻止腳本運行
-
-**錯誤訊息**：「因為在此系統上禁止執行指令碼」
-
-**解決方案**：
-```powershell
-# 方法 1：暫時繞過執行策略
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-
-# 方法 2：使用參數執行
-powershell -ExecutionPolicy Bypass -File ".failure/tools/log_failure.ps1" -Help
-```
-
----
-
-### Q3: 無法找到 TASK_QUEUE.json
-
-**原因**：`check_failures.ps1` 依賴 `dev/pipeline/TASK_QUEUE.json`。
-
-**解決方案**：
-```powershell
-# 確認工作目錄在專案根目錄
-cd D:\repo\side\ava\KenazAI
-
-# 或使用其他參數而非 -TaskID
-.\.failure\tools\check_failures.ps1 -Keywords "JSON"
-```
-
----
-
-### Q4: INDEX.yaml 解析失敗
-
-**原因**：YAML 格式錯誤或 BOM 問題。
-
-**解決方案**：
-```bash
-# 檢查 BOM
-node .failure/tools/check_bom.js .failure/INDEX.yaml
-
-# 修復 BOM（注意：INDEX.yaml 不是 JSON，僅移除 BOM）
-node .failure/tools/remove_bom.js .failure/INDEX.yaml
-
-# 驗證 YAML 語法（需要安裝 yq）
-yq eval .failure/INDEX.yaml
-```
-
----
-
-## 工作流程整合
-
-### Agent 執行前（預防檢查）
-
-```powershell
-# 檢查相關失敗模式
-$taskID = "TASK_081"
-.\.failure\tools\check_failures.ps1 -TaskID $taskID
-```
-
-### Agent 執行中（數據驗證）
-
-```bash
-# 修改 JSON 文件後立即驗證
-node .failure/tools/validate_json.js dev/pipeline/TASK_QUEUE.json
-
-# 一鍵修復
-node .failure/tools/fix_json.js dev/pipeline/TASK_QUEUE.json
-```
-
-### Agent 執行失敗後（經驗記錄）
-
-```powershell
-# 建立失敗記錄
-.\.failure\tools\log_failure.ps1 -Interactive
-```
-
-### 定期維護（每週）
-
-```powershell
-# 檢視所有失敗記錄
-Get-ChildItem .failure/*/FAIL-*.yaml | ForEach-Object {
-    Write-Host $_.Name -ForegroundColor Cyan
-    Select-String -Path $_.FullName -Pattern "^# \[" | Select-Object -First 1
-}
-
-# 統計失敗記錄數量
-$stats = @{
-    Total = (Get-ChildItem .failure/*/FAIL-*.yaml).Count
-    AgentExecution = (Get-ChildItem .failure/agent-execution/*.yaml).Count
-    CodeQuality = (Get-ChildItem .failure/code-quality/*.yaml).Count
-    Architecture = (Get-ChildItem .failure/architecture/*.yaml).Count
-    Pipeline = (Get-ChildItem .failure/pipeline/*.yaml).Count
-    DataIntegrity = (Get-ChildItem .failure/data-integrity/*.yaml).Count
-}
-$stats | Format-Table -AutoSize
-```
-
----
-
-## 下一步計劃
-
-以下工具尚未實作（標記為「計劃中」）：
-
-### 1. failure-report.ps1（生成失敗經驗報告）
-
-**功能**：
-- 統計失敗記錄數量
-- 按分類和嚴重程度分組
-- 列出已轉化為規則的失敗
-- 生成 Markdown 報告
-
-**使用範例**：
-```powershell
-# 生成完整報告
-.\.failure\tools\failure-report.ps1
-
-# 只生成特定分類的報告
-.\.failure\tools\failure-report.ps1 -Category "pipeline"
-
-# 輸出為 Markdown 格式
-.\.failure\tools\failure-report.ps1 -Format "markdown" -Output "failure-report.md"
-```
-
----
-
-### 2. failure-to-rule.ps1（將失敗轉化為規則）
-
-**功能**：
-- 分析失敗記錄，建議哪些應該轉化為規則
-- 自動生成規則文件草稿
-- 更新失敗記錄的 `converted_to_rules` 狀態
-- 更新 `INDEX.yaml` 統計數據
-
-**使用範例**：
-```powershell
-# 檢查哪些失敗應該轉化為規則
-.\.failure\tools\failure-to-rule.ps1 -Analyze
-
-# 將特定失敗轉化為規則
-.\.failure\tools\failure-to-rule.ps1 -FailureID "FAIL-003" -RuleID "PPL-002"
-```
-
----
-
-## 相關資源
-
-| 文檔 | 路徑 |
-|------|------|
-| **失敗記錄索引** | `.failure/INDEX.yaml` |
-| **工具使用說明** | `.failure/tools/README.md` |
-| **詳細使用指南** | `.failure/tools/USAGE_GUIDE.md` |
-| **規則系統** | `.rule/INDEX.yaml` |
-| **Agent 工作流程** | `.rule/general/agent-workflow.yaml` |
-| **記憶系統** | `.memory/MEMORY.md` |
-| **CLAUDE.md 失敗學習章節** | `CLAUDE.md#失敗學習系統` |
-
----
-
-## 統計數據（截至 2026-02-17）
-
-```yaml
-total_failures: 6
-by_category:
-  agent_execution: 3   # FAIL-001, FAIL-004, FAIL-005
-  data_integrity: 1    # FAIL-002
-  pipeline: 1          # FAIL-003
-  architecture: 1      # FAIL-006
-by_severity:
-  critical: 2          # FAIL-001, FAIL-005
-  high: 4              # FAIL-002, FAIL-003, FAIL-004, FAIL-006
-  medium: 0
-  low: 0
-resolved: 5            # 已解決的失敗（有解決方案）
-converted_to_rules: 2  # 已提升為規則（PPL-002, AGT-005）
-```
-
----
-
-*建立日期: 2026-02-19 | 更新: 2026-02-19*