SuperAPI AI 工具集

test-validator

测试与质量

查看项目

更新于 10-16 00:06

技能介绍

用途:在 CakePHP 项目中校验 PHP 测试文件,确保测试真正保障生产代码行为。由 quality-reviewer、test-developer、deliverable-evaluator 等代理在代码审查、实现与提交前调用。

主要能力:读取项目 CLAUDE.md 与 tests/README.md 中的测试规则;检查 PHPDoc 是否含 @covers、@group 及规范命名;校验配置值是否统一用 Configure::read() 而非硬编码;检测禁止模式,如条件断言、Configure::write() 覆盖配置、缺少 @covers、method_exists() 等存在性检查、markTestSkipped()/assertTrue(true) 占位、PHPDoc 写实现细节、防御性 define()、仅 assertResponseOk() 的浅断言、保证项无法追溯到 @covers 分支、不同代码路径断言不可区分、Mock 生产组件、_initializeSchema 覆盖、无 Fixture 直接 newEntity();核对控制器/动作/路由是否存在;按 CLAUDE.md 指定命令校验测试命令;比对 README 与测试代码,计算一致性分数(100 完美,90-99 轻微偏差,70-89 需修复,0-69 严重)。

使用方式:先读 tests/README.md 加载项目规则,再解析 PHPDoc、扫描硬编码、检测禁止模式、核对生产代码与 Fixture、校验规格一致性。输出为 ✅ PASS、❌ FAIL(含行号与修复建议)、⚠️ WARN。

适用场景:CakePHP 4.x/5.x、多租户数据库、PHP 8.x、遵循严格测试原则的项目,尤其版本升级期间。

限制:仅针对上述技术栈;具体测试命令、项目专属禁止示例依赖项目文档,资料未提供通用默认值;一致性分数需 ≥90 才建议通过 PR。