菜单
錯誤模式知識庫管理工具。Use for: (1) 查詢既有錯誤經驗和防護措施 (query), (2) 記錄新發現的錯誤模式和教訓 (add), (3) Ticket 開始前查詢歷史問題避免再犯, (4) 系統化管理錯誤學習經驗。Use when: user mentions error pattern, 錯誤模式, 教訓, 經驗記錄, 學習經驗, 防護措施, 錯誤紀錄, or needs to avoid recurring issues.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
Claude Code release notes 框架影響評估工具。比對 last-reviewed 版本篩出新版本，逐項分類（對框架有幫助 / 需評估 / 無影響 / 不適用），對採用項引導建 ANA + WRAP + spawn 落地。Use when: 執行 /release-notes 看到新版本、定期檢查 CC 更新、評估新功能對專案框架的影響時。Triggers: release notes, release-notes, CC 更新, claude code 更新, 版本更新評估, 新功能評估, 框架影響評估。
Use this skill for managing git worktrees for Ticket-based development. Triggers include: creating a worktree for a new ticket, checking worktree status, viewing all worktrees, or any mention of /worktree, worktree management, feature branches, or setting up development environment.
版本發布整合工具。Use for: (1) 發布新版本（合併到 main、打 Tag、推送）, (2) 發布前健康檢查（所有 Ticket 完成？CHANGELOG 更新？）, (3) 更新版本文件（worklog 狀態、CHANGELOG）。Use when: 準備發布版本、執行 /version-release check 確認發布前狀態、完成所有 Ticket 後要收尾時。
Composes atomic, intent-revealing, grep-friendly writing (Zettelkasten) for code comments, docs, logs, prompts, schema/ticket fields, external-analysis transformation, and long-form technical articles. Use when cognitive load and token cost matter. **Also triggers during multi-round review / batch review / 寫作 audit** — provides the keyword bank (正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架) and frame-specific check lists that multi-round-review reviewer agents need. Triggers: 寫註解, 寫文件, 寫日誌, 寫 prompt, 寫文章, 技術文章, 商業分析, 外部分析文章, post-mortem, 架構決策, 除錯復盤, 欄位設計, atomic, reusable, 多輪審查, multi-round review, batch review, 寫作 audit, 正向陳述, 口語修辭, 字句層 grep.
寫多篇章節後做多輪 agent reviewer audit 的標準操作流程。每輪用不同 frame 切換、跨輪 finding 互不重疊、停止訊號是 frame 涵蓋而非 finding 數遞減。Round 1-A 寫作規範 reviewer 必須同步 invoke `compositional-writing` skill 的字句層 keyword bank（正向陳述 / 口語修辭 / 地區用語 / 廢話前綴 / 裝飾符號 / 對讀者喊話 / 自評誇飾 / 必然性框架）、且命中後要做語意判定（命中是候選不是判決）。觸發詞：多輪審查、Round 1/2/3、frame 切換、跨輪審查、reviewer 規劃、何時停止 review、寫作 audit、batch review、cadence 同骨化、enumeration 不窮盡、正向陳述、self-application sweep。Trigger when reviewing multiple writings via successive rounds of agent reviewers.
| 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 query <關鍵字>查詢既有錯誤模式經驗。
使用時機：每個 Ticket 開始前
執行流程：
.claude/error-patterns/ 目錄下所有 .md 檔案輸出格式：
找到 N 個相關錯誤模式：
1. [編號] 錯誤名稱
- 症狀：簡短描述
- 解決方案：簡短描述
- 相關 Ticket：TICKET-XXX
（無匹配時）
未找到相關錯誤模式。這可能是新發現的問題，請使用 /error-pattern add 記錄。
/error-pattern add互動式記錄新發現的錯誤模式。
使用時機：發現新問題時
執行流程：
選擇錯誤類別
輸入症狀描述
分析根因
記錄解決方案
提出預防措施
關聯 Ticket
自動分配來源前綴 ID（跨專案共享框架必用）
<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>", # git rev-parse --show-toplevel
)
pattern_id = allocate_pattern_id("<CATEGORY>", ".claude", proj)
<CATEGORY>-NNN（凍結 base 不再新增，見編號章節）。輸出：
<CATEGORY>-<PROJ>-NNN-<slug>.md 命名新增錯誤記錄/error-pattern list列出所有已記錄的錯誤模式。
輸出格式：
錯誤模式知識庫統計：
DI 註冊 (3)
├─ [DI-001] 服務未註冊到 ServiceLocator
├─ [DI-002] 依賴服務尚未初始化
└─ [DI-003] 循環依賴
Widget Finder (2)
├─ [WF-001] 多重匹配
└─ [WF-002] 找不到元素
...
| 類別目錄 | 前綴 | 凍結 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
<CATEGORY>-NNN 為凍結 canonical base，原樣保留、不再新增 flat 號。<PROJ> 取自 .claude/error-patterns/_project-registry.yaml（tooling 以 git
toplevel basename 對應 dir 欄自動取得）。.claude/methodologies/error-pattern-numbering-methodology.md。單一專案使用本框架時：無碰撞風險，可沿用 flat
<CATEGORY>-NNN。來源前綴僅在 多專案共享同步情境強制。
在 Ticket 中加入：
## 參考既有錯誤模式
<!-- 執行 /error-pattern query 後填寫 -->
- [ ] 已查詢既有模式
- 匹配模式：[編號] 或「無匹配 - 新發現模式」
在工作日誌中記錄：
## 錯誤模式學習
- 發現新模式：[編號] 錯誤名稱
- 參考既有模式：[編號] 錯誤名稱
| 檔案 | 用途 |
|---|---|
.claude/error-patterns/README.md | 知識庫索引 |
.claude/error-patterns/{category}/*.md | 各分類錯誤模式檔案 |
Last Updated: 2026-03-02 Version: 1.0.0