SuperAPI AI 工具集

quality-gates

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:为项目补齐并验证质量门禁基础设施,每次运行都完整执行审计、修复、验证,没有部分模式。

主要能力:审计项目质量配置缺口;规划必须项与生产应用应具备项;实施修复;端到端验证。必须项包括 Lefthook 的 pre-commit(对暂存文件做 lint、format、typecheck)与 pre-push(test、build)、Vitest 覆盖率配置、GitHub Actions CI(每个 PR 跑 lint、typecheck、test、build)、main 分支保护。生产应用应具备 commitlint 约定式提交、PR 覆盖率报告、关键流程 E2E、CI 安全审计。

使用方式:运行 /quality-gates。审计阶段可生成 infrastructure-guardian 代理做全面审计,并用命令快速检查 lefthook.yml、vitest.config.ts/js、.github/workflows/ci.yml、commitlint.config.js/cjs 及 package.json 中的 coverage 脚本。安装 Lefthook 用 pnpm add -D lefthook 与 pnpm lefthook install;安装 Vitest 用 pnpm add -D vitest @vitest/coverage-v8;commitlint 用 pnpm add -D @commitlint/cli @commitlint/config-conventional。验证时实际运行钩子、pnpm test --run、commitlint 等,失败需先修复。

适用场景:需要统一 git 钩子、测试与 CI 质量门禁的前端或 Node 项目。

限制与原则:工具选择是强推荐而非强制,已有可用替代方案时不折腾。覆盖率是诊断工具而非目标,补丁覆盖率建议 80%+,关键路径 90%+,总体跟踪但不阻塞。绝不为了通过 CI 而降低质量门禁,阈值确实有误应上报用户。详细配置见 references/ 下的 lefthook-config.md、github-actions.md、vitest-config.md、branch-protection.md、testing-standards.md。