Agent skill · data analytics · aiskillstore
issue-review
系統化的問題分析專家技能，自動協調五個專門代理進行深度問題分析。 適用於： - 使用者或 PM 報告的線上問題 - 開發團隊反映的技術問題 - 測試發現的 bug - 生產環境告警和異常
Why this skill is useful
Adds a structured workflow with multiple executable scripts for problem analysis and root cause identification that aren't available in public documentation.
What it needs
Requires sonnet installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Issue Review - 系統化問題分析 你已進入 Issue Review 模式，將執行系統化的問題分析工作流程，協調五個專門代理。 五代理協作架構 代理角色 代理 顏色 模型 角色 ------ ------ ------ ------ problem-analyzer 🟡 黃色 Sonnet 問題資訊提取、分類、初步假設 codebase-investigator 🔵 藍色 Sonnet 程式碼定位、流程追蹤、原因評分 root-cause-finder 🟣 紫色 Opus 假設驗證、因果鏈、根本原因確認 diff-analyzer 🟢 綠色 Sonnet Git 歷史分析、變更追蹤 log-analyzer 🟠 橙色 Sonnet 日誌解析、錯誤模式識別 --- 完整工作流程 步驟 1：收集問題描述 如果用戶已提供問題描述，直接進入步驟 2。 如果用戶尚未提供，請詢問： 請描述您要分析的問題： - 問題現象是什麼？ - 發生在什麼環境？ - 有錯誤訊息嗎？ - 如何重現？ - 是最近才開始發生的嗎？ --- 步驟 2：啟動 problem-analyzer 收到問題描述後，立即使用 Task 工具啟動 problem-analyzer 代理： 階段完成後： 向用戶報告「✅ 階段 1 完成：問題分析」 展示關鍵假設和條件判斷結果 根據條件決定下一步 --- 步驟 2.5：啟動輔助代理（條件觸發） 根據 problem-analyzer 的條件判斷： 條件 A 觸發：啟動 diff-analyzer 條件 B 觸發：啟動 log-analyzer 如果兩個條件都觸發：使用 Task 工具並行啟動兩個代理。 階段完成後：向用戶報告「✅ 階段 1.5 完成：輔助調查」並展示關鍵發現。 --- 步驟 3：啟動 codebase-investigator 將所有前置階段的輸出傳遞給 codebase-investigator： 階段完成後：向用戶報告「✅ 階段 2 完成：程式碼調查」並展示可能原因列表。 --- 步驟 4：啟動 root-cause-finder（迭代） 從最高可能性假設開始驗證： 迭代邏輯： ✅ 確認：停止迭代，進入步驟 5 ❓ 部分確認：記錄，繼續驗證下一假設 ❌ 排除：繼續驗證下一假設 最多驗證 3 個假設 階段完成後：向用戶報告「✅ 階段 3 完成：根本原因定位」 --- 步驟 5：生成最終報告 生成結構化的分析報告： [根本原因] ↓ 導致 [中間影響] ↓ 導致 [直接原因] ↓ 表現為 [表面症狀] [language] // 問題程式碼 [code snippet] [language] // 修復後程式碼 [fixed code] --- 錯誤處理 代理執行失敗 如果某個代理執行失敗或返回不完整結果： 1. 重試一次（使用更明確的指示） 2. 降級處理： diff-analyzer/log-analyzer 失敗 → 跳過，繼續主流程 codebase-investigator 失敗 → 使用 problem-analyzer 的假設直接驗證 root-cause-finder 失敗 → 輸出 codebase-investigator 的分析結果 3. 告知用戶：說明哪個階段遇到問題 找不到確定的 Root Cause 如果所有假設都無法確認： 1. 彙總「部分確認」的假設 2. 說明需要的額外資訊 3. 提供基於當前分析的臨時建議 多個 Root Causes 如果發現多個確認的原因： 1. 分別說明每個 Root Cause 2. 分析它們的關係（獨立/共同作用） 3. 提供各自的修復建議和優先級 資訊不足 如果問題描述過於簡短，請詢問： 瀏覽器開發者工具的網路/主控台截圖 伺服器日誌 詳細的重現步驟 是否是最近才開始發生 --- 可用命令 除了此技能，你還可以使用： 命令 用途 ------ ------ /analyze-issue [問題描述] 快速啟動完整五代理分析流程 /quick-analyze [問題描述] 快速診斷（適用於有明確錯誤訊息） --- 開始分析 請提供您要分析的問題描述，我將立即啟動系統化的分析流程。 如果您已經在上方提供了問題描述，我將直接開始分析。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/issue-review