kenaz 0.3.17 → 0.3.19

package/core/.failure/tools/USAGE_GUIDE.md

@@ -1,323 +0,0 @@
-# Failure Logging Tools - Usage Guide
-
-## 執行環境要求
-
-### PowerShell 腳本執行
-由於腳本包含中文字符，需要確保 PowerShell 正確支援 UTF-8 編碼。
-
-**推薦執行方式**（Windows PowerShell 或 PowerShell 7+）：
-
-1. 直接在 Windows PowerShell 中執行：
-   ```powershell
-   # 開啟 PowerShell（不是 Git Bash）
-   cd D:\repo\side\ava\KenazAI
-
-   # 執行腳本
-   .\.failure\tools\log_failure.ps1 -Help
-   .\.failure\tools\check_failures.ps1 -Help
-   ```
-
-2. 如果遇到執行策略限制：
-   ```powershell
-   # 暫時允許執行腳本
-   Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-
-   # 或使用 -ExecutionPolicy 參數
-   powershell -ExecutionPolicy Bypass -File ".failure/tools/log_failure.ps1" -Help
-   ```
-
-3. 如果遇到編碼問題（亂碼）：
-   ```powershell
-   # PowerShell 7+ 預設 UTF-8，推薦使用
-   pwsh -File ".failure/tools/log_failure.ps1" -Help
-
-   # 或在 Windows PowerShell 5.1 中設置編碼
-   [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-   $OutputEncoding = [System.Text.Encoding]::UTF8
-   ```
-
-## 工具 1: log_failure.ps1
-
-### 功能說明
-自動化建立失敗記錄文件的 PowerShell 腳本。
-
-### 使用範例
-
-#### 1. 互動式模式（推薦）
-```powershell
-.\.failure\tools\log_failure.ps1
-```
-
-互動式模式會逐步引導您：
-1. 選擇失敗分類（agent_execution, code_quality, architecture, pipeline, data_integrity）
-2. 輸入失敗標題
-3. 選擇嚴重程度（critical, high, medium, low）
-4. 輸入相關任務 ID（可選）
-
-#### 2. 參數化模式
-```powershell
-# 基本用法
-.\.failure\tools\log_failure.ps1 `
-  -Category "pipeline" `
-  -Title "任務佇列損壞問題" `
-  -Severity "high"
-
-# 包含任務 ID
-.\.failure\tools\log_failure.ps1 `
-  -Category "data_integrity" `
-  -Title "JSON BOM 編碼錯誤" `
-  -Severity "high" `
-  -TaskID "TASK_089"
-```
-
-#### 3. 查看幫助
-```powershell
-.\.failure\tools\log_failure.ps1 -Help
-```
-
-### 輸出結果
-腳本執行後會：
-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-"
-```
-
-## 工具 2: check_failures.ps1
-
-### 功能說明
-檢查當前任務是否匹配已知失敗模式的腳本。
-
-### 使用範例
-
-#### 1. 根據任務 ID 檢查
-```powershell
-# 自動從 TASK_QUEUE.json 載入任務詳情
-.\.failure\tools\check_failures.ps1 -TaskID "TASK_077"
-```
-
-#### 2. 根據 Agent 類型檢查
-```powershell
-.\.failure\tools\check_failures.ps1 -AgentType "developer"
-```
-
-#### 3. 根據路徑檢查
-```powershell
-.\.failure\tools\check_failures.ps1 -ScopePath "dev/pipeline/"
-```
-
-#### 4. 關鍵詞搜尋
-```powershell
-# 單個關鍵詞
-.\.failure\tools\check_failures.ps1 -Keywords "JSON"
-
-# 多個關鍵詞（用逗號分隔）
-.\.failure\tools\check_failures.ps1 -Keywords "JSON,BOM,encoding"
-```
-
-#### 5. 過濾分類和嚴重程度
-```powershell
-# 只檢查 pipeline 分類的失敗
-.\.failure\tools\check_failures.ps1 -Category "pipeline"
-
-# 只檢查 critical 嚴重程度的失敗
-.\.failure\tools\check_failures.ps1 -Severity "critical"
-
-# 組合過濾
-.\.failure\tools\check_failures.ps1 `
-  -Category "pipeline" `
-  -Severity "high" `
-  -AgentType "developer"
-```
-
-#### 6. 查看幫助
-```powershell
-.\.failure\tools\check_failures.ps1 -Help
-```
-
-### 輸出結果
-腳本會顯示：
-1. 匹配的失敗記錄數量
-2. 每個失敗記錄的：
-   - ID 和標題
-   - 分類和嚴重程度
-   - 預防檢查清單
-   - 解決方案參考
-3. 按嚴重程度排序（critical > high > medium > low）
-
-## 測試驗證
-
-### 測試場景 1：建立新失敗記錄
-```powershell
-# 1. 執行腳本建立失敗記錄
-.\.failure\tools\log_failure.ps1 `
-  -Category "pipeline" `
-  -Title "測試失敗記錄" `
-  -Severity "low" `
-  -TaskID "TASK_TEST"
-
-# 2. 驗證文件已建立
-Test-Path .failure/pipeline/FAIL-*.yaml
-
-# 3. 驗證 INDEX.yaml 已更新
-$index = Get-Content .failure/INDEX.yaml -Raw
-$index -match "測試失敗記錄"  # 應該返回 True
-```
-
-### 測試場景 2：檢查失敗模式
-```powershell
-# 1. 檢查是否有 pipeline 相關的失敗
-.\.failure\tools\check_failures.ps1 -Category "pipeline"
-
-# 2. 檢查關鍵詞 "JSON" 相關的失敗
-.\.failure\tools\check_failures.ps1 -Keywords "JSON"
-
-# 3. 驗證輸出包含預防措施
-.\.failure\tools\check_failures.ps1 -Category "data_integrity" | Select-String "預防"
-```
-
-### 測試場景 3：統計數據驗證
-```powershell
-# 讀取 INDEX.yaml 並驗證統計數據
-$index = Get-Content .failure/INDEX.yaml -Raw | ConvertFrom-Yaml
-
-# 驗證 total_failures 正確
-$totalFiles = (Get-ChildItem .failure/*/FAIL-*.yaml).Count
-Write-Host "Total failures in INDEX: $($index.statistics.total_failures)"
-Write-Host "Actual YAML files: $totalFiles"
-
-# 驗證分類統計
-$pipelineFiles = (Get-ChildItem .failure/pipeline/FAIL-*.yaml).Count
-Write-Host "Pipeline failures in INDEX: $($index.statistics.by_category.pipeline)"
-Write-Host "Actual pipeline YAML files: $pipelineFiles"
-```
-
-**注意**：ConvertFrom-Yaml 需要安裝 powershell-yaml 模組：
-```powershell
-Install-Module -Name powershell-yaml -Force
-```
-
-## 常見問題
-
-### 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
-node .failure/tools/fix_json.js .failure/INDEX.yaml
-
-# 驗證 YAML 語法（需要安裝 yq）
-yq eval .failure/INDEX.yaml
-```
-
-## 整合到工作流程
-
-### Agent 執行前
-```powershell
-# 檢查相關失敗模式
-$taskID = "TASK_081"
-.\.failure\tools\check_failures.ps1 -TaskID $taskID
-```
-
-### 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
-```
-
-## 相關資源
-
-- **失敗記錄索引**: `.failure/INDEX.yaml`
-- **規則系統**: `.rule/INDEX.yaml`
-- **Agent 工作流程**: `.rule/general/agent-workflow.yaml`
-- **工具 README**: `.failure/tools/README.md`
-- **記憶系統**: `.memory/MEMORY.md`
-
-## 下一步計劃
-
-以下工具尚未實作（標記為「計劃中」）：
-
-1. **failure-report.ps1**：生成失敗經驗報告
-   - 統計失敗記錄數量
-   - 按分類和嚴重程度分組
-   - 輸出 Markdown 報告
-
-2. **failure-to-rule.ps1**：將失敗轉化為規則
-   - 分析重複失敗模式
-   - 自動生成規則文件草稿
-   - 更新 INDEX.yaml 統計
-
-這些工具將在後續任務中實作（見 TASK_082）。

package/core/.failure/tools/check_failures.ps1

@@ -1,387 +0,0 @@
-# check_failures.ps1
-# 檢查當前任務是否匹配已知失敗模式的腳本
-
-<#
-.SYNOPSIS
-    檢查任務是否匹配已知的失敗模式
-
-.DESCRIPTION
-    此腳本根據任務類型、scope_paths 或關鍵詞搜尋相關失敗記錄，
-    輸出預防檢查清單和解決方案參考。
-
-.PARAMETER TaskID
-    任務 ID（如 TASK_077），會從 TASK_QUEUE.json 載入任務詳情
-
-.PARAMETER AgentType
-    Agent 類型（developer, backend, frontend, designer, qa, sre）
-
-.PARAMETER ScopePath
-    任務的 scope_paths（如 "dev/pipeline/"）
-
-.PARAMETER Keywords
-    搜尋關鍵詞（用逗號分隔）
-
-.PARAMETER Category
-    失敗分類過濾（agent_execution, code_quality, architecture, pipeline, data_integrity）
-
-.PARAMETER Severity
-    嚴重程度過濾（critical, high, medium, low）
-
-.PARAMETER Help
-    顯示幫助訊息
-
-.EXAMPLE
-    .\check_failures.ps1 -TaskID "TASK_077"
-    檢查特定任務的失敗模式
-
-.EXAMPLE
-    .\check_failures.ps1 -AgentType "developer" -ScopePath "dev/pipeline/"
-    檢查特定類型和路徑的失敗模式
-
-.EXAMPLE
-    .\check_failures.ps1 -Keywords "JSON,BOM,encoding"
-    根據關鍵詞搜尋失敗記錄
-#>
-
-param(
-    [Parameter(Mandatory=$false)]
-    [string]$TaskID,
-
-    [Parameter(Mandatory=$false)]
-    [ValidateSet("developer", "backend", "frontend", "designer", "qa", "sre", "architect")]
-    [string]$AgentType,
-
-    [Parameter(Mandatory=$false)]
-    [string]$ScopePath,
-
-    [Parameter(Mandatory=$false)]
-    [string]$Keywords,
-
-    [Parameter(Mandatory=$false)]
-    [ValidateSet("agent_execution", "code_quality", "architecture", "pipeline", "data_integrity")]
-    [string]$Category,
-
-    [Parameter(Mandatory=$false)]
-    [ValidateSet("critical", "high", "medium", "low")]
-    [string]$Severity,
-
-    [Parameter(Mandatory=$false)]
-    [switch]$Help
-)
-
-# ============================================================
-# 常量定義
-# ============================================================
-$FAILURE_ROOT = Join-Path (Split-Path $PSScriptRoot -Parent) ""
-$INDEX_FILE = Join-Path $FAILURE_ROOT "INDEX.yaml"
-$TASK_QUEUE_FILE = "dev/pipeline/TASK_QUEUE.json"
-
-$CATEGORY_PATHS = @{
-    "agent_execution" = "agent-execution"
-    "code_quality" = "code-quality"
-    "architecture" = "architecture"
-    "pipeline" = "pipeline"
-    "data_integrity" = "data-integrity"
-}
-
-$SEVERITY_ICONS = @{
-    "critical" = "🔴"
-    "high" = "🟠"
-    "medium" = "🟡"
-    "low" = "🟢"
-}
-
-# ============================================================
-# 函數定義
-# ============================================================
-
-function Show-Help {
-    Write-Host @"
-🔍 Failure Pattern Checker
-
-使用方式:
-  .\check_failures.ps1 -TaskID <id>              # 檢查特定任務
-  .\check_failures.ps1 -AgentType <type>         # 檢查特定 Agent 類型
-  .\check_failures.ps1 -ScopePath <path>         # 檢查特定路徑
-  .\check_failures.ps1 -Keywords <keywords>      # 關鍵詞搜尋
-
-參數:
-  -TaskID      任務 ID（會從 TASK_QUEUE.json 載入詳情）
-  -AgentType   Agent 類型 (developer, backend, frontend, designer, qa, sre)
-  -ScopePath   任務的 scope_paths（如 "dev/pipeline/"）
-  -Keywords    搜尋關鍵詞（用逗號分隔）
-  -Category    失敗分類過濾
-  -Severity    嚴重程度過濾
-  -Help        顯示此幫助訊息
-
-範例:
-  .\check_failures.ps1 -TaskID "TASK_077"
-  .\check_failures.ps1 -AgentType "developer" -ScopePath "dev/pipeline/"
-  .\check_failures.ps1 -Keywords "JSON,BOM"
-  .\check_failures.ps1 -Category "pipeline" -Severity "critical"
-
-相關資源:
-  - 失敗記錄索引: .failure/INDEX.yaml
-  - 任務佇列: dev/pipeline/TASK_QUEUE.json
-"@
-    exit 0
-}
-
-function Get-TaskDetails {
-    param([string]$TaskID)
-
-    if (-not (Test-Path $TASK_QUEUE_FILE)) {
-        Write-Warning "⚠️  TASK_QUEUE.json not found, using parameters only"
-        return $null
-    }
-
-    try {
-        $queue = Get-Content $TASK_QUEUE_FILE -Raw | ConvertFrom-Json
-        $task = $queue.tasks | Where-Object { $_.id -eq $TaskID }
-
-        if (-not $task) {
-            Write-Warning "⚠️  Task $TaskID not found in queue"
-            return $null
-        }
-
-        return $task
-    } catch {
-        Write-Warning "⚠️  Failed to parse TASK_QUEUE.json: $_"
-        return $null
-    }
-}
-
-function Get-FailureRecords {
-    if (-not (Test-Path $INDEX_FILE)) {
-        Write-Error "❌ INDEX.yaml not found at: $INDEX_FILE"
-        exit 1
-    }
-
-    $records = @()
-
-    # 遍歷所有分類目錄
-    foreach ($cat in $CATEGORY_PATHS.Keys) {
-        $categoryDir = Join-Path $FAILURE_ROOT $CATEGORY_PATHS[$cat]
-
-        if (-not (Test-Path $categoryDir)) {
-            continue
-        }
-
-        # 讀取所有 .yaml 文件
-        $yamlFiles = Get-ChildItem -Path $categoryDir -Filter "*.yaml" -File
-
-        foreach ($file in $yamlFiles) {
-            try {
-                $content = Get-Content $file.FullName -Raw
-
-                # 簡單解析 YAML（提取關鍵欄位）
-                $id = if ($content -match 'id:\s*"([^"]+)"') { $matches[1] } else { "" }
-                $category = if ($content -match 'category:\s*"([^"]+)"') { $matches[1] } else { $cat }
-                $severity = if ($content -match 'severity:\s*"([^"]+)"') { $matches[1] } else { "unknown" }
-                $title = if ($content -match '# \[([^\]]+)\] (.+)') { $matches[2] } else { $file.BaseName }
-
-                $records += [PSCustomObject]@{
-                    ID = $id
-                    Category = $category
-                    Severity = $severity
-                    Title = $title
-                    FilePath = $file.FullName
-                    Content = $content
-                }
-            } catch {
-                Write-Warning "⚠️  Failed to parse $($file.Name): $_"
-            }
-        }
-    }
-
-    return $records
-}
-
-function Test-FailureMatch {
-    param(
-        [object]$Record,
-        [hashtable]$Filters
-    )
-
-    # 分類過濾
-    if ($Filters.Category -and $Record.Category -ne $Filters.Category) {
-        return $false
-    }
-
-    # 嚴重程度過濾
-    if ($Filters.Severity -and $Record.Severity -ne $Filters.Severity) {
-        return $false
-    }
-
-    # Agent 類型匹配
-    if ($Filters.AgentType) {
-        # 檢查失敗記錄中是否提到該 agent_type
-        $agentMatch = $Record.Content -match $Filters.AgentType
-        if (-not $agentMatch) {
-            return $false
-        }
-    }
-
-    # Scope 路徑匹配
-    if ($Filters.ScopePath) {
-        # 檢查失敗記錄中是否提到該路徑
-        $pathMatch = $Record.Content -match [regex]::Escape($Filters.ScopePath)
-        if (-not $pathMatch) {
-            return $false
-        }
-    }
-
-    # 關鍵詞匹配
-    if ($Filters.Keywords) {
-        $keywordList = $Filters.Keywords -split ','
-        $matched = $false
-
-        foreach ($keyword in $keywordList) {
-            if ($Record.Content -match [regex]::Escape($keyword.Trim())) {
-                $matched = $true
-                break
-            }
-        }
-
-        if (-not $matched) {
-            return $false
-        }
-    }
-
-    return $true
-}
-
-function Show-FailureRecord {
-    param([object]$Record)
-
-    $icon = $SEVERITY_ICONS[$Record.Severity]
-    Write-Host "`n$icon [$($Record.ID)] $($Record.Title)" -ForegroundColor Cyan
-    Write-Host "   分類: $($Record.Category) | 嚴重程度: $($Record.Severity)" -ForegroundColor Gray
-
-    # 提取預防措施
-    if ($Record.Content -match '## 預防措施(.+?)(?=##|$)') {
-        $prevention = $matches[1].Trim()
-
-        # 提取檢查清單
-        if ($prevention -match '### 檢查清單(.+?)(?=###|$)') {
-            $checklist = $matches[1].Trim()
-            Write-Host "`n   📋 預防檢查清單:" -ForegroundColor Yellow
-            $checklistItems = $checklist -split "`n" | Where-Object { $_ -match '- \[' }
-            foreach ($item in $checklistItems) {
-                Write-Host "      $item" -ForegroundColor White
-            }
-        }
-    }
-
-    # 提取解決方案
-    if ($Record.Content -match '## 解決方案(.+?)(?=##|$)') {
-        $solution = $matches[1].Trim()
-        Write-Host "`n   💡 解決方案參考:" -ForegroundColor Yellow
-        $solutionLines = $solution -split "`n" | Select-Object -First 3
-        foreach ($line in $solutionLines) {
-            if ($line.Trim()) {
-                Write-Host "      $($line.Trim())" -ForegroundColor White
-            }
-        }
-        Write-Host "      （詳見: $($Record.FilePath)）" -ForegroundColor Gray
-    }
-}
-
-# ============================================================
-# 主程序
-# ============================================================
-
-if ($Help) {
-    Show-Help
-}
-
-Write-Host "🔍 Failure Pattern Checker" -ForegroundColor Cyan
-Write-Host "=========================`n" -ForegroundColor Cyan
-
-# 如果提供了 TaskID，載入任務詳情
-$task = $null
-if ($TaskID) {
-    Write-Host "📋 載入任務: $TaskID" -ForegroundColor Yellow
-    $task = Get-TaskDetails -TaskID $TaskID
-
-    if ($task) {
-        Write-Host "   Agent Type: $($task.agent_type)" -ForegroundColor Gray
-        Write-Host "   Scope Paths: $($task.scope_paths -join ', ')" -ForegroundColor Gray
-
-        # 自動填充參數
-        if (-not $AgentType) { $AgentType = $task.agent_type }
-        if (-not $ScopePath -and $task.scope_paths) { $ScopePath = $task.scope_paths[0] }
-    }
-}
-
-# 建立過濾器
-$filters = @{}
-if ($Category) { $filters.Category = $Category }
-if ($Severity) { $filters.Severity = $Severity }
-if ($AgentType) { $filters.AgentType = $AgentType }
-if ($ScopePath) { $filters.ScopePath = $ScopePath }
-if ($Keywords) { $filters.Keywords = $Keywords }
-
-# 顯示搜尋條件
-Write-Host "`n🔎 搜尋條件:" -ForegroundColor Yellow
-if ($filters.Count -eq 0) {
-    Write-Host "   （無過濾條件，顯示所有失敗記錄）" -ForegroundColor Gray
-} else {
-    foreach ($key in $filters.Keys) {
-        Write-Host "   $key`: $($filters[$key])" -ForegroundColor Gray
-    }
-}
-
-# 載入所有失敗記錄
-Write-Host "`n📂 載入失敗記錄..." -ForegroundColor Cyan
-$allRecords = Get-FailureRecords
-Write-Host "   找到 $($allRecords.Count) 筆失敗記錄" -ForegroundColor Gray
-
-# 過濾匹配的記錄
-$matchedRecords = @()
-foreach ($record in $allRecords) {
-    if (Test-FailureMatch -Record $record -Filters $filters) {
-        $matchedRecords += $record
-    }
-}
-
-# 顯示結果
-Write-Host "`n📊 匹配結果: $($matchedRecords.Count) 筆" -ForegroundColor Green
-
-if ($matchedRecords.Count -eq 0) {
-    Write-Host "`n✅ 未發現相關失敗模式" -ForegroundColor Green
-    Write-Host "   建議繼續進行任務，但保持警覺" -ForegroundColor Gray
-    exit 0
-}
-
-# 按嚴重程度排序
-$sortedRecords = $matchedRecords | Sort-Object @{Expression={
-    switch ($_.Severity) {
-        "critical" { 1 }
-        "high" { 2 }
-        "medium" { 3 }
-        "low" { 4 }
-        default { 5 }
-    }
-}}
-
-# 顯示匹配的失敗記錄
-Write-Host "`n⚠️  發現以下相關失敗模式，請注意預防:" -ForegroundColor Yellow
-
-foreach ($record in $sortedRecords) {
-    Show-FailureRecord -Record $record
-}
-
-# 總結建議
-Write-Host "`n" + ("="*60) -ForegroundColor Cyan
-Write-Host "📌 建議行動:" -ForegroundColor Yellow
-Write-Host "  1. 仔細閱讀上述失敗記錄的預防檢查清單" -ForegroundColor White
-Write-Host "  2. 在執行任務前完成所有相關檢查" -ForegroundColor White
-Write-Host "  3. 參考解決方案避免重複失敗" -ForegroundColor White
-Write-Host "  4. 如遇到新的失敗模式，執行 .\log_failure.ps1 記錄" -ForegroundColor White
-Write-Host "`n相關資源:" -ForegroundColor Yellow
-Write-Host "  - 規則系統: .rule/INDEX.yaml" -ForegroundColor Gray
-Write-Host "  - Agent 工作流程: .rule/general/agent-workflow.yaml" -ForegroundColor Gray
-Write-Host "  - 失敗記錄索引: .failure/INDEX.yaml" -ForegroundColor Gray
-
-exit 0