skills/pre-fix-eval/SKILL.md
修復前強制評估系統. Use for: (1) 測試失敗自動評估, (2) 編譯錯誤分類處理, (3) 強制 Ticket 開設流程
npx skillsauth add tarrragon/claude pre-fix-evalInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
錯誤發生時的強制閘門。確保在修復任何非語法問題前,都完成分析、開設 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
development
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
development
Claude Code release notes 框架影響評估工具。比對 last-reviewed 版本篩出新版本,逐項分類(對框架有幫助 / 需評估 / 無影響 / 不適用),對採用項引導建 ANA + WRAP + spawn 落地。Use when: 執行 /release-notes 看到新版本、定期檢查 CC 更新、評估新功能對專案框架的影響時。Triggers: release notes, release-notes, CC 更新, claude code 更新, 版本更新評估, 新功能評估, 框架影響評估。
development
Assertion design judgment framework for flaky and design-quality issues. Use when writing tests, reviewing assertions, diagnosing flaky tests, or deciding if a timing/float/cache assertion is appropriate. Do NOT use for API syntax or refactoring.
tools
Chrome Extension 實機測試與 debug 工作流,以 chrome-devtools-mcp 為核心工具。Use when: (1) 完成功能後實機驗證 / manual test / 試看看 / 跑看看 / verify feature, (2) extension debug / popup 不作動 / content script 不注入 / service worker 報錯 / background 出問題, (3) 安裝 unpacked extension / load unpacked / 載入未封裝, (4) 看 console / 看 network / 看 log / view console / inspect requests, (5) 功能更新後重新載入 extension / rebuild reload / reload extension。涵蓋 Manifest V3 service worker / content script / popup / options page 的 chrome-devtools-mcp 工具呼叫流程。不取代 Puppeteer / Playwright 自動化 E2E(CI 用),定位為開發期手動驗證與 LLM-assisted debug。