| name | error-pattern |
| description | 錯誤模式知識庫管理工具。Use for: (1) 查詢既有錯誤經驗和防護措施 (query), (2) 記錄新發現的錯誤模式和教訓 (add), (3) Ticket 開始前查詢歷史問題避免再犯, (4) 系統化管理錯誤學習經驗。Use when: user mentions error pattern, 錯誤模式, 教訓, 經驗記錄, 學習經驗, 防護措施, 錯誤紀錄, or needs to avoid recurring issues. |
error-pattern SKILL
錯誤模式知識庫管理工具。查詢既有錯誤經驗，記錄新發現的錯誤模式。
指令
/error-pattern query <關鍵字>
查詢既有錯誤模式經驗。
使用時機：每個 Ticket 開始前
執行流程：
- 搜尋
.claude/error-patterns/ 目錄下所有 .md 檔案
- 使用關鍵字匹配錯誤症狀、根因、解決方案
- 返回匹配的錯誤模式清單
輸出格式：
找到 N 個相關錯誤模式：
1. [編號] 錯誤名稱
- 症狀：簡短描述
- 解決方案：簡短描述
- 相關 Ticket：TICKET-XXX
（無匹配時）
未找到相關錯誤模式。這可能是新發現的問題，請使用 /error-pattern add 記錄。
/error-pattern add
互動式記錄新發現的錯誤模式。
使用時機：發現新問題時
執行流程：
-
選擇錯誤類別
- di-registration: DI 註冊相關
- widget-finder: Widget Finder 相關
- async-resource: 異步資源相關
- type-mismatch: 類型不匹配
- hook-schema: Hook Schema 相關
- code-quality: 程式碼品質相關
- process-compliance: 流程合規相關
- other: 其他（需要新建分類）
-
輸入症狀描述
-
分析根因
-
記錄解決方案
-
提出預防措施
-
關聯 Ticket
輸出：
- 在對應的分類檔案中新增錯誤記錄
- 更新 README.md 統計資訊
/error-pattern list
列出所有已記錄的錯誤模式。
輸出格式：
錯誤模式知識庫統計：
DI 註冊 (3)
├─ [DI-001] 服務未註冊到 ServiceLocator
├─ [DI-002] 依賴服務尚未初始化
└─ [DI-003] 循環依賴
Widget Finder (2)
├─ [WF-001] 多重匹配
└─ [WF-002] 找不到元素
...
錯誤編號規則
| 類別 | 前綴 | 範例 |
|---|
| DI 註冊 | DI | DI-001 |
| Widget Finder | WF | WF-001 |
| 異步資源 | AR | AR-001 |
| 類型不匹配 | TM | TM-001 |
| Hook Schema | HS | HS-001 |
| 程式碼品質 | CQ | CQ-001 |
| 流程合規 | PC | PC-001 |
整合到工作流程
Ticket 模板整合
在 Ticket 中加入：
## 參考既有錯誤模式
<!-- 執行 /error-pattern query 後填寫 -->
- [ ] 已查詢既有模式
- 匹配模式：[編號] 或「無匹配 - 新發現模式」
Worklog 整合
在工作日誌中記錄：
## 錯誤模式學習
- 發現新模式：[編號] 錯誤名稱
- 參考既有模式：[編號] 錯誤名稱
檔案位置
| 檔案 | 用途 |
|---|
.claude/error-patterns/README.md | 知識庫索引 |
.claude/error-patterns/{category}/*.md | 各分類錯誤模式檔案 |
Last Updated: 2026-03-02
Version: 1.0.0
