用途:位于用例设计与执行之间的转换层,把 qa-testcase-designer 产出的人工用例转成执行阶段可运行的 spec-task 与测试脚本,产出 test-spec-tasks.json。仅生成可执行内容,不执行、不标记 pass/fail、不判断就绪;实现状态只到 implemented,执行状态保持 not-run。
主要能力:按完整测试金字塔拆解(单元>集成>API>E2E),默认最小 task 数 P0=8、P1=5、P2=3、P3=1,默认比例 unit 60%/integration 20%/api 15%/e2e 5%,纯后端 scope 自动跳过 E2E。每条 task 含 sourceCaseId、priority、layer、targetFile、testName、command、assertions、结构化 oracle(ui/api/db/sideEffects/negativeAssertions)、traceability、dataBindings 等字段。
使用方式:CLI 为 quality-assurance-agent/scripts/qa_agent.py,命令写成 python "$QA_AGENT_DIR/scripts/qa_agent.py" <cmd>。流程:先 validate-cases 校验用例(仅 confirmed 用例生成 task),再 generate-spec-tasks,然后 coverage-balance --strict,并用 assert-script-implementation 校验脚本真实实现,最后实现测试文件。E2E 用 @playwright/test,路径 tests/e2e/<module>/<case-id>.spec.ts,命令 npx playwright test <targetFile>。
限制:不标记 passed/failed,不减少 task 数绕过门禁,不生成占位 stub(如 echo "BLOCKED"; exit 0),DB 断言须固化为结构化 oracle.db,数据准备用 PRE/POST 注释由 runner 经 MySQL MCP 完成。上游用例缺失或校验失败应退回,不强行生成。编码损坏需跑 check-mojibake --strict。具体收费、价格、平台支持等信息暂未提供。