Verification Loop

affaan-m/ECC/docs/zh-TW/skills/verification-loop

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

A comprehensive verification system for Claude Code sessions.

AI 產生的概覽

為程式碼變更執行六階段驗證循環:建置、型別檢查、Lint、測試、安全掃描與差異審查。

功能
此技能定義了一套分階段的編碼工作階段驗證流程。它依序執行建置、型別檢查、Lint、含覆蓋率的測試套件、密鑰與 console.log 掃描,以及 git 差異審查,接著產出含通過/失敗狀態的驗證報告,並給出是否可供 PR 使用的整體結論。它也描述具心理檢查點的持續模式,並說明其與 PostToolUse hooks 的互補關係。
適用情境
適用於完成功能或重大程式碼變更之後、建立 PR 之前、重構之後,或需要確認品質門檻是否通過時。也適合長時間工作階段中每 15 分鐘或重大變更後執行驗證。
執行需求
需要具備建置、Lint 與測試指令的專案(範例使用 npm/pnpm、tsc、pyright、ruff),以及用於差異審查的 git。此技能僅包含說明,不含附帶指令碼,並假定可透過 shell 執行所列指令。

驗證循環技能

Claude Code 工作階段的完整驗證系統。

何時使用

在以下情況呼叫此技能:

  • 完成功能或重大程式碼變更後
  • 建立 PR 前
  • 想確保品質門檻通過時
  • 重構後

驗證階段

階段 1:建置驗證

bash
# 檢查專案是否建置npm run build 2>&1 | tail -20# 或pnpm build 2>&1 | tail -20

如果建置失敗,停止並在繼續前修復。

階段 2:型別檢查

bash
# TypeScript 專案npx tsc --noEmit 2>&1 | head -30
# Python 專案pyright . 2>&1 | head -30

報告所有型別錯誤。繼續前修復關鍵錯誤。

階段 3:Lint 檢查

bash
# JavaScript/TypeScriptnpm run lint 2>&1 | head -30
# Pythonruff check . 2>&1 | head -30

階段 4:測試套件

bash
# 執行帶覆蓋率的測試npm run test -- --coverage 2>&1 | tail -50
# 檢查覆蓋率門檻# 目標:最低 80%

報告:

  • 總測試數:X
  • 通過:X
  • 失敗:X
  • 覆蓋率:X%

階段 5:安全掃描

bash
# 檢查密鑰grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
# 檢查 console.loggrep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

階段 6:差異審查

bash
# 顯示變更內容git diff --statgit diff HEAD~1 --name-only

審查每個變更的檔案:

  • 非預期變更
  • 缺少錯誤處理
  • 潛在邊界案例

輸出格式

執行所有階段後,產生驗證報告:

驗證報告==================
建置:     [PASS/FAIL]型別:     [PASS/FAIL](X 個錯誤)Lint:     [PASS/FAIL](X 個警告)測試:     [PASS/FAIL](X/Y 通過,Z% 覆蓋率)安全性:   [PASS/FAIL](X 個問題)差異:     [X 個檔案變更]
整體:     [READY/NOT READY] for PR
待修復問題:1. ...2. ...

持續模式

對於長時間工作階段,每 15 分鐘或重大變更後執行驗證:

markdown
設定心理檢查點:- 完成每個函式後- 完成元件後- 移至下一個任務前
執行:/verify

與 Hooks 整合

此技能補充 PostToolUse hooks 但提供更深入的驗證。 Hooks 立即捕捉問題;此技能提供全面審查。

來源與署名

來源:affaan-m/ECC位於docs/zh-TW/skills/verification-loop提交ef648e0

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架