--- name: pre-commit-validator description: Git commit 前的完整驗證檢查。當用戶提到「commit」、「提交」、「push」或完成重要修改時自動執行。 allowed-tools: Bash, Grep, Read --- # Pre-Commit Validator Skill 在 Git commit 前執行完整的代碼品質驗證，確保所有修改符合最高規格標準。 ## 🎯 執行時機 - 用戶提到要「commit」或「提交代碼」 - 用戶提到要「push」到遠端 - 完成重要功能開發後 - 用戶明確要求「檢查」或「驗證」在提交前 ## 📋 完整檢查清單 ### 1. Git 狀態檢查 ```bash git status ``` 確認： - ✅ 有未提交的修改 - ✅ 在正確的分支上 - ✅ 沒有未追蹤的重要檔案被遺漏 ### 2. TypeScript 類型檢查 ```bash npm run typecheck ``` **必須通過，無任何錯誤** 如果有錯誤： 1. 使用 `type-checker` skill 修復 2. 重新執行驗證 3. 不可跳過或忽略 ### 3. ESLint 代碼風格檢查 ```bash npm run lint ``` **必須通過，無任何警告或錯誤** 如果有錯誤： 1. 優先使用自動修復: `npm run lint -- --fix` 2. 手動修復無法自動處理的問題 3. 重新執行驗證 ### 4. 單元測試（如果有） ```bash npm test ``` 所有測試必須通過。 ### 5. Build 構建檢查 ```bash npm run build ``` **必須成功構建，無任何錯誤** 這確保： - 所有 import/export 正確 - 所有依賴可解析 - 生產環境代碼可用 ### 6. 禁止模式搜尋使用 Grep 搜尋絕對禁止出現的模式： ```bash # 搜尋 console.log (僅在新修改的檔案中) git diff --name-only | xargs grep -n "console\.log" # 搜尋 debugger 語句 git diff --name-only | xargs grep -n "debugger" # 搜尋 TODO/FIXME 標記 git diff --name-only | xargs grep -n "TODO\|FIXME" ``` 如果發現： - `console.log` → 必須移除或改用 logger - `debugger` → 必須移除 - `TODO`/`FIXME` → 確認是否需要在此 commit 完成 ### 7. 敏感資訊檢查 ```bash # 檢查是否包含 API keys, tokens, passwords git diff --cached | grep -iE "(api[_-]?key|secret|password|token|credential)" ``` 如果發現敏感資訊： - 🚨 **立即停止 commit** - 移除敏感資訊 - 使用環境變數或配置檔案 ### 8. 檔案大小檢查 ```bash # 檢查是否有大檔案（>1MB） git diff --cached --name-only | xargs ls -lh | awk '$5 ~ /M/ {print}' ``` 大檔案應該： - 圖片/媒體 → 使用 CDN 或壓縮 - 資料檔案 → 不應提交到 git ### 9. 相依性檢查 ```bash # 檢查 package.json 是否有變更 git diff --name-only | grep "package.json" ``` 如果 `package.json` 有變更： - 確認 `package-lock.json` 也有變更 - 執行 `npm install` 確保依賴正確 ## 📝 驗證報告格式 ```markdown ## Pre-Commit 驗證報告 ### Git 狀態 - 分支: `feature/xxx` - 修改檔案: 5 個 - 新增檔案: 2 個 ### 驗證結果 ✅ TypeScript 類型檢查通過 ✅ ESLint 代碼風格檢查通過 ✅ 單元測試通過 (12/12) ✅ Build 構建成功 ✅ 無禁止模式 ✅ 無敏感資訊 ✅ 無異常大檔案 ✅ 相依性正確 ### 可以安全提交 ✅ 建議 commit message: ``` feat: 實作用戶認證功能 - 新增 Login 組件 - 實作 JWT 驗證 - 加入錯誤處理 ``` ``` ## 🚨 如果驗證失敗 ```markdown ## Pre-Commit 驗證報告 ### 驗證結果 ❌ TypeScript 類型檢查失敗 - src/components/Login.tsx:42 - TS7006 - src/api/auth.ts:15 - TS2345 ✅ ESLint 代碼風格檢查通過 ⚠️ 發現 3 個 console.log - src/utils/debug.ts:12 - src/components/Form.tsx:45 - src/hooks/useAuth.ts:88 ### ⛔ 不可提交！必須先修復以上問題。 ``` **處理步驟：** 1. 使用相應的 skill 修復問題（如 `type-checker`） 2. 重新執行完整驗證 3. 直到所有檢查通過 ## ⚠️ 絕對禁止 ```bash # ❌ 永遠不要這樣做 git commit --no-verify git push --force git commit -m "wip" # 沒有描述性的 message ``` ## ✅ 最佳實踐 ### Commit Message 格式 ``` ():