| 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 <關鍵字> [--category <CAT>]
查詢既有錯誤模式經驗。
使用時機：每個 Ticket 開始前
參數：
<關鍵字>：搜尋詞（必填）--category <CAT>：依 category 目錄篩選結果（選填）。有效值：PC、IMP、ARCH、CQ、DOC、TEST、PROC。對應 .claude/error-patterns/ 子目錄（PC → process-compliance/、IMP → implementation/、ARCH → architecture/、CQ → code-quality/、DOC → documentation/、TEST → test/、PROC → process/）。
執行流程：
- 同義詞擴展：比對
references/synonym-map.md 家族表（11 家族），若用戶關鍵字命中任一家族的同義詞，展開為該家族全部變體的 multi-term OR grep（如 grep -rli "confabul\|fabricat\|幻覺\|虛構\|腦補"）。未命中任何家族時使用原始關鍵字。
- 搜尋範圍：
- 未指定
--category：搜尋 .claude/error-patterns/ 全部子目錄
- 指定
--category PC：僅搜尋 .claude/error-patterns/process-compliance/
- 使用展開後的關鍵字匹配錯誤症狀、根因、解決方案
- 結果排序：有 YAML frontmatter（
id:/title:/severity:）的檔案優先顯示摘要；無 frontmatter 的檔案依標題行顯示
- 返回匹配的錯誤模式清單
輸出格式：
找到 N 個相關錯誤模式（共搜尋 M 檔）：
（命中率 > 30% 時追加提示：命中率 X%，建議加 --category 篩選縮小範圍）
--- 有 frontmatter 的結果（優先顯示）---
1. [PC-166] confabulation 觸發鏈與防護 [severity: high]
- 症狀：簡短描述
- 路徑：process-compliance/PC-166-...
--- 其餘結果 ---
2. [PC-147] ...（從標題行提取）
- 路徑：process-compliance/PC-147-...
（無匹配時）
未找到相關錯誤模式。這可能是新發現的問題，請使用 /error-pattern add 記錄。
/error-pattern add
互動式記錄新發現的錯誤模式。
使用時機：發現新問題時
執行流程：
-
選擇錯誤類別（對應 .claude/error-patterns/ 子目錄）
- architecture: 架構設計相關
- code-quality: 程式碼品質相關
- documentation: 文件相關
- implementation: 實作 bug 相關
- process-compliance: 流程合規相關
- test: 測試相關
-
輸入症狀描述
-
分析根因
-
記錄解決方案
-
提出預防措施
-
關聯 Ticket
-
自動分配來源前綴 ID（跨專案共享框架必用）
- 呼叫 allocator 取得下一個
<CATEGORY>-<PROJ>-NNN：
import sys; sys.path.insert(0, ".claude/skills/error-pattern/lib")
from allocator import identify_project_code, allocate_pattern_id
proj = identify_project_code(
".claude/error-patterns/_project-registry.yaml",
"<git toplevel>",
)
pattern_id = allocate_pattern_id("<CATEGORY>", ".claude", proj)
- allocator 自動：以 git toplevel basename 自我識別專案代號 → 掃該專案前綴空間
取最大號 +1（flat 凍結 base 不參與遞增）。
- 禁止手動指定 flat
<CATEGORY>-NNN（凍結 base 不再新增，見編號章節）。
輸出：
- 在對應的分類檔案中以
<CATEGORY>-<PROJ>-NNN-<slug>.md 命名新增錯誤記錄
- 更新 README.md 統計資訊
/error-pattern list
列出所有已記錄的錯誤模式。
輸出格式：
錯誤模式知識庫統計：
implementation (5)
├─ [IMP-008] Bash 工作目錄污染
├─ [IMP-MON-003] 貪婪字串替換誤中 URL 子字串
└─ ...
process-compliance (12)
├─ [PC-040] 派發前未寫 Context Bundle
├─ [PC-V1-001] sync-push 未知參數被當 commit message
└─ ...
錯誤編號規則
Category 前綴（依目錄）
| 類別目錄 | 前綴 | 凍結 base 範例 |
|---|
| architecture | ARCH | ARCH-001 |
| code-quality | CQ | CQ-001 |
| documentation | DOC | DOC-001 |
| implementation | IMP | IMP-001 |
| process | PROC | PROC-001 |
| process-compliance | PC | PC-001 |
| test | TEST | TEST-001 |
來源前綴（跨專案共享框架必用）
本框架透過共享 repo 同步至多個專案。為防多專案併發分配同號碰撞，新增任何
category 的 error-pattern 一律使用來源前綴格式：
<CATEGORY>-<PROJ>-NNN 例：PC-V1-001、IMP-APP-003、ARCH-SCLK-002
- 既有 flat
<CATEGORY>-NNN 為凍結 canonical base，原樣保留、不再新增 flat 號。
<PROJ> 取自 .claude/error-patterns/_project-registry.yaml（tooling 以 git
toplevel basename 對應 dir 欄自動取得）。- 完整規則（凍結語意、協議字串豁免、canonical 升格、dedup、rejected options）見
.claude/methodologies/error-pattern-numbering-methodology.md。
單一專案使用本框架時：無碰撞風險，可沿用 flat <CATEGORY>-NNN。來源前綴僅在
多專案共享同步情境強制。
整合到工作流程
Ticket 模板整合
在 Ticket 中加入：
## 參考既有錯誤模式
<!-- 執行 /error-pattern query 後填寫 -->
- [ ] 已查詢既有模式
- 匹配模式：[編號] 或「無匹配 - 新發現模式」
Worklog 整合
在工作日誌中記錄：
## 錯誤模式學習
- 發現新模式：[編號] 錯誤名稱
- 參考既有模式：[編號] 錯誤名稱
檔案位置
| 檔案 | 用途 |
|---|
.claude/error-patterns/README.md | 知識庫索引 |
.claude/error-patterns/{category}/*.md | 各分類錯誤模式檔案 |
Last Updated: 2026-07-05
Version: 1.1.0 — query 增強：--category 篩選、同義詞家族 5→11、frontmatter 摘要排序、命中數計數（1.5.0-W5-016）
