用途:在实现和测试完成后、创建拉取请求前或标记功能完成前,对已实现功能进行系统化验证,确保代码质量、测试覆盖、性能、安全和需求满足,是部署前的最终质量门。
主要能力:包括九类验证。代码质量:用Black做格式检查、mypy做类型检查、flake8做lint;要求类型提示、公共函数文档字符串、单文件不超过500行等。测试覆盖:pytest --cov=src --cov-fail-under=80,目标总覆盖≥80%、核心业务≥90%、工具≥85%。测试质量:检查是否有跳过或间歇失败测试,可用pytest --random-order随机顺序运行。性能:pytest tests/performance/,用cProfile与memory_profiler分析,响应时间、吞吐、内存等目标。安全:输入校验、认证授权、数据保护、依赖漏洞扫描(pip-audit、safety check --json)。需求:核对验收标准、手动测试与回归测试。文档:代码、技术、用户文档及CHANGELOG。集成与最终验证:运行集成和端到端测试,并生成验证报告。
使用方式:按流程逐项执行命令,例如black --check src/ tests/、mypy src/、pytest --cov=src --cov-report=html,也可用python scripts/run_checks.py --all或--quality/--tests/--coverage/--security/--performance;支持--report validation-report.md生成报告。失败时按对应类别修复并重跑验证。
适用场景:Python项目中功能开发完成后的质量把关,尤其适合需要统一质量标准和自动检查的团队。
限制:资料仅提供英文命令与清单,未给出安装方式、依赖版本、具体平台支持范围或收费信息;引用文件如quality-checklist.md、performance-benchmarks.md、scripts/run_checks.py需在项目中存在方可使用。