Verification Loop

affaan-m/ECC/pi/core/skills/verification-loop

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775MIT275K 个星标收录于 2026年10月9日更新于 2026年10月9日仓库4天前更新

Run a six-phase verification of a Claude Code session's work — build, type check, lint, tests with coverage, security grep, and diff review — then produce a PASS/FAIL verification report. Use when verifying work after completing a feature or refactor, before creating a PR, or when quality gates must pass.

AI 生成的概览

执行六阶段代码验证流程,并生成 PASS/FAIL 就绪报告。

功能
引导智能体对代码会话执行六个验证阶段:构建、类型检查、代码检查、带覆盖率的测试、针对密钥与调试语句的安全 grep,以及差异审查。它为每个阶段给出具体 shell 命令,并规定固定报告格式,涵盖构建、类型、检查、测试、安全和变更文件。产出是一份验证报告,包含面向 PR 的 READY/NOT READY 总体结论和待修复问题清单。
适用场景
适用于完成功能、重构或较大代码改动之后,以及创建 PR 之前。也适合必须通过质量门禁时,或长会话中需要定期检查的场景。
运行要求
仅为说明文档,不含随附脚本。智能体需要具备构建、类型检查、代码检查和测试工具的项目(例如 npm 或 pnpm、tsc 或 pyright、ruff),以及用于差异审查的 git。命令在本地运行,包管理工具可能需要网络访问。

Verification Loop Skill

A comprehensive verification system for Claude Code sessions.

When to Use

Invoke this skill:

  • After completing a feature or significant code change
  • Before creating a PR
  • When you want to ensure quality gates pass
  • After refactoring

Verification Phases

Phase 1: Build Verification

bash
# Check if project buildsnpm run build 2>&1 | tail -20# ORpnpm build 2>&1 | tail -20

If build fails, STOP and fix before continuing.

Phase 2: Type Check

bash
set -o pipefail# TypeScript projectsnpx --no-install tsc --noEmit 2>&1 | head -30
# Python projectspyright . 2>&1 | head -30

Report all type errors. Fix critical ones before continuing.

Phase 3: Lint Check

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

Phase 4: Test Suite

bash
# Run tests with coveragenpm run test -- --coverage 2>&1 | tail -50
# Check coverage threshold# Target: 80% minimum

Report:

  • Total tests: X
  • Passed: X
  • Failed: X
  • Coverage: X%

Phase 5: Security Scan

bash
# Check for secretsgrep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
# Check for console.loggrep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

Phase 6: Diff Review

bash
# Show what changedgit diff --statgit diff HEAD~1 --name-only

Review each changed file for:

  • Unintended changes
  • Missing error handling
  • Potential edge cases

Output Format

After running all phases, produce a verification report:

VERIFICATION REPORT==================
Build:     [PASS/FAIL]Types:     [PASS/FAIL] (X errors)Lint:      [PASS/FAIL] (X warnings)Tests:     [PASS/FAIL] (X/Y passed, Z% coverage)Security:  [PASS/FAIL] (X issues)Diff:      [X files changed]
Overall:   [READY/NOT READY] for PR
Issues to Fix:1. ...2. ...

Continuous Mode

For long sessions, run verification every 15 minutes or after major changes:

markdown
Set a mental checkpoint:- After completing each function- After finishing a component- Before moving to next task
Run: /verify

Integration with Hooks

This skill complements PostToolUse hooks but provides deeper verification. Hooks catch issues immediately; this skill provides comprehensive review.

来源与署名

来源:affaan-m/ECC位于pi/core/skills/verification-loop提交ef648e0

许可证: MIT

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架