SuperAPI AI 工具集

quality-run-quality-gates

测试与质量

查看项目

更新于 10-16 05:05

技能介绍

用途:在声明任务“完成”、标记 todo 完成、创建提交或 PR 前,强制执行 Definition of Done,运行全部质量门禁并阻止未通过的任务被标记完成。触发语包括“run quality gates”“check all”“validate code quality”“is this done?”等;也用于只跑了单个工具(如 ruff check)后的补全检查。

主要能力:检测项目类型(Python、JavaScript/TypeScript、Go、Rust 等)与可用工具;优先使用统一脚本 ./scripts/check_all.sh、npm run check 或 make check,否则回退到各语言单独工具;并行运行门禁;按类型归类失败(类型错误、Lint、死代码、测试失败);为每类失败给出文件行号、错误描述、修复建议与优先级;修复后重跑直至全部通过。

常用工具:Python 用 uv run pyright 或 mypy、uv run ruff check、uv run vulture src/ --min-confidence 80、uv run pytest tests/ -q、uv run ruff format --check;JS/TS 用 npx tsc --noEmit、npx eslint src/、npm test、npx prettier --check src/;Go 用 go build ./...、golangci-lint run、go test ./...、go fmt ./...;Rust 用 cargo check、cargo clippy、cargo test、cargo fmt --check。

使用方式:先检测统一脚本或项目类型,运行门禁并捕获退出码,解析输出归类失败,给出修复项,修复后重跑;全部通过才输出“DEFINITION OF DONE: MET”。可读取 CLAUDE.md、pyproject.toml、package.json、.pre-commit-config.yaml 中的项目配置,也支持 .claude/quality-gates.json 自定义 runner 与工具。

适用场景:功能或修复实现后、重构后、提交前、PR 前、标记 todo 完成前,以及只做了部分质量检查时。

限制:资料未提供具体安装命令、收费与价格信息;未检测到质量门禁工具时无法验证,需询问用户或建议创建 check_all.sh;多次修复仍失败时需升级给用户;vulture 可能出现误报,可通过 pyproject.toml 排除;本地通过但 CI 失败需检查环境一致性。