القائمة
修復前強制評估系統. Use for: (1) 測試失敗自動評估, (2) 編譯錯誤分類處理, (3) 強制 Ticket 開設流程
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
broken-link 偵測工具。掃描 .claude/ 目錄所有 Markdown 文件中的路徑引用，偵測失效連結。Use for: (1) 一次性掃描所有 broken links, (2) 搭配 /loop 定期監控, (3) 修改規則/方法論/代理人文件後驗證路徑完整性。Use when: user runs /broken-link-check, 或搭配 /loop 定期執行, 或發現 broken link 錯誤後。
Dart/Flutter copyWith 收窄判準與 entity 不變式設計。Use when designing or reviewing copyWith, entity classes, value objects, freezed models, domain invariants, or state transition methods (markAsX/completeY).
全量掃描硬編碼中文字串並生成 i18n 修正建議。檢測所有層（Model/Service/Domain/UI）中文硬編碼，生成 ARB 鍵值建議，支援批量替換工作流程。Use for: (1) 檢查專案全部硬編碼中文（不只 UI 層）, (2) 進行大規模 i18n 修復, (3) 生成 ARB 鍵值建議, (4) i18n 技術債務評估
Riverpod Provider 架構設計規範 - 確保正確的依賴注入、介面隔離和測試可行性。Use for: (1) 設計新的 ViewModel/Notifier 類別, (2) 審查 Provider 依賴注入是否正確, (3) 測試中配置 ProviderScope.overrides, (4) 發現 ref.read/watch 使用錯誤時。Use when: 程式碼涉及 Riverpod Provider、Notifier、ViewModel 設計或出現 ref 操作問題時。
Performs security review for Flutter/Dart code. Use when implementing authentication, handling user input, working with API keys or secrets, managing permissions, storing sensitive data locally, or integrating third-party APIs. Provides Flutter-specific security checklists and patterns.
Style Guardian - Unified Design System Enforcement Tool. Use for: (1) Preventing hardcoded styles (colors, spacing, typography), (2) Preventing hardcoded text (i18n violations), (3) Guiding unified configuration usage, (4) Detecting and fixing style violations
| name | pre-fix-eval |
| description | 修復前強制評估系統. Use for: (1) 測試失敗自動評估, (2) 編譯錯誤分類處理, (3) 強制 Ticket 開設流程 |
錯誤發生時的強制閘門。確保在修復任何非語法問題前，都完成分析、開設 Ticket、正確分派代理人。
PostToolUse Hook 自動識別四種錯誤類型：
| 錯誤類型 | 識別模式 | 開 Ticket | 流程 |
|---|---|---|---|
| SYNTAX_ERROR | 括號、分號、拼字 | 不需 | 簡化流程，直接分派 mint-format-specialist |
| COMPILATION_ERROR | 類型、引用、導入 | 必須 | 完整六階段評估 |
| TEST_FAILURE | 斷言失敗、失敗計數 | 必須 | 完整六階段評估 |
| ANALYZER_WARNING | lint 警告、棄用 API | 必須 | 評估 + 延遲處理 |
分類優先級：SYNTAX_ERROR > COMPILATION_ERROR > TEST_FAILURE > ANALYZER_WARNING
正則表達式模式詳見：references/error-patterns.md
非語法錯誤必須完成全部六階段：
Stage 1: 錯誤分類 (Hook 自動完成)
|
Stage 2: BDD 意圖分析 (Given-When-Then)
|
Stage 3: 設計文件查詢 (需求/用例/工作日誌)
|
Stage 4: 根因定位 (確定問題根本原因)
|
Stage 5: 開 Ticket 記錄 (強制, /ticket create)
|
Stage 6: 分派執行 (依 incident-response.md 派發對應表)
各階段詳細說明、輸出範例和 Ticket 模板：references/six-stage-evaluation.md
Stage 6 的代理人分派依據 .claude/pm-rules/incident-response.md 的「派發對應表」。
快速參考：
| 錯誤類型 | 預設代理人 |
|---|---|
| SYNTAX_ERROR | mint-format-specialist（無需 Ticket） |
| COMPILATION_ERROR | 依子分類，見 incident-response.md |
| TEST_FAILURE | 依子分類，見 incident-response.md |
| ANALYZER_WARNING | mint-format-specialist |
完整派發對應表（含子分類）：.claude/pm-rules/incident-response.md
| 情況 | 測試狀態 | 程式狀態 | Ticket | 修復行動 |
|---|---|---|---|---|
| 語法錯誤 | - | 語法錯誤 | 不需 | 直接精確修復 |
| 程式實作不完整 | 失敗 | 缺少實作 | 必須 | 評估 -> 補完實作 |
| 程式邏輯錯誤 | 失敗 | 已實作 | 必須 | 評估 -> 修正邏輯 |
| 測試過時 | 失敗 | 正確 | 必須 | 評估 -> 驗證文件 -> 更新測試 |
| 設計變更 | 失敗 | 無實作 | 必須 | 評估 -> PM 審核 -> 實作 |
| 功能未實作 | 失敗 | 接口存在但未實作 | 必須 | 評估 -> 查文件 -> 開 TD Ticket 或刪除測試 |
各情況的詳細處理流程和範例：references/common-scenarios.md
修復完成後驗證：
| 命令 | 觸發 |
|---|---|
flutter test 失敗 | 自動評估 |
dart analyze 失敗 | 自動評估 |
dart run 失敗 | 自動評估 |
mcp__dart__run_tests 失敗 | 自動評估 |
/pre-fix-eval 進入六階段評估flutter test 或 dart analyze/pre-fix-eval -> 六階段評估 -> /ticket create -> 分派代理人references/six-stage-evaluation.md - 六階段詳細說明和 Ticket 模板references/common-scenarios.md - 6 種常見情況處理指南references/error-patterns.md - 錯誤模式正則表達式references/decision-matrix.md - 修復決策矩陣詳細說明.claude/pm-rules/incident-response.md - 代理人派發對應表（Stage 6 的 Source of Truth）Last Updated: 2026-03-02 Version: 1.0.0