2.3 KiB

Raw Blame History

name	description
verification-loop	適用於 Claude Code 會話的全面驗證系統。

驗證循環技能 (Verification Loop Skill)

用於確保 Claude Code 任務執行品質的全面驗證流程。

何時啟用

完成一項功能開發或重大的程式碼變更後。
在建立 Pull Request (PR) 之前。
希望進行品質關卡 (Quality Gates) 檢查時。
重構現有程式碼後。

驗證階段詳解

階段 1：構建驗證 (Build)

執行 npm run build 或 pnpm build。若構建失敗，必須立即停止並修正，嚴禁在報錯基礎上繼續開發。

階段 2：類型檢查 (Type Check)

TypeScript：執行 npx tsc --noEmit。
Python：執行 pyright .。回報所有類型錯誤，並在繼續前修正關鍵錯誤。

階段 3：代碼風格與語法檢查 (Lint)

執行 npm run lint 或 ruff check .，確保代碼風格一致且無明顯低級錯誤。

階段 4：測試套件 (Tests)

執行完整測試並產出覆蓋率報告。

目標：整體覆蓋率應達到 80% 以上。回報項目：測試總數、通過數、失敗數、覆蓋率百分比。

階段 5：安全性掃描 (Security)

秘密資訊檢查：搜尋代碼中是否存在硬編碼的 sk-、api_key 等敏感字串。
調試資訊清除：檢查是否殘留過多的 console.log。

階段 6：變更內容審查 (Diff Review)

執行 git diff 系列指令，審查每個變動的項目：

是否有無意間修改到的部分？
錯誤處理是否完整？
是否考慮到了邊際案例 (Edge Cases)？

驗證報告模板

完成所有階段後，請產出如下格式的報告：

驗證報告 (VERIFICATION REPORT)
=============================

專案編譯：    [通過/失敗]
類型檢查：    [通過/失敗] (共 X 個錯誤)
語法檢查：    [通過/失敗] (共 X 個警告)
全量測試：    [通過/失敗] (X 通過 / Y 總數, 覆蓋率 Z%)
安全掃描：    [通過/失敗] (共 X 個問題)
變更審查：    [共 X 個檔案變動]

綜合評定：    [READY / NOT READY] (是否建議建立 PR)

需修正事項：
1. ...

核心原則：儘早發現問題，保持嚴格的驗證標準。對於生產環境，應將所有警告視為必須修復的軟體缺陷。

2.3 KiB Raw Blame History Unescape Escape