error-pattern

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 開始前

執行流程：

1. 搜尋 .claude/error-patterns/ 目錄下所有 .md 檔案
2. 使用關鍵字匹配錯誤症狀、根因、解決方案
3. 返回匹配的錯誤模式清單

輸出格式：

找到 N 個相關錯誤模式：

1. [編號] 錯誤名稱
   - 症狀：簡短描述
   - 解決方案：簡短描述
   - 相關 Ticket：TICKET-XXX

（無匹配時）
未找到相關錯誤模式。這可能是新發現的問題，請使用 /error-pattern add 記錄。

/error-pattern add

互動式記錄新發現的錯誤模式。

使用時機：發現新問題時

執行流程：

1. 選擇錯誤類別

   • di-registration: DI 註冊相關
   • widget-finder: Widget Finder 相關
   • async-resource: 異步資源相關
   • type-mismatch: 類型不匹配
   • hook-schema: Hook Schema 相關
   • code-quality: 程式碼品質相關
   • process-compliance: 流程合規相關
   • other: 其他（需要新建分類）

2. 輸入症狀描述

   • 錯誤訊息特徵
   • 發生位置類型

3. 分析根因

   • 為什麼會發生
   • 行為模式分析

4. 記錄解決方案

   • 具體修復步驟
   • 程式碼範例（如適用）

5. 提出預防措施

   • 如何避免再次發生
   • 相關 Hook 或檢查機制建議

6. 關聯 Ticket

   • 輸入相關 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