用途:位于 QA 管道中间阶段,上游是 qa-risk-analyzer,下游是 qa-test-script-generator。把风险分析转成可验证的简体中文业务用例,交用户审阅,用户明确确认后才放行;确认前不生成任何测试代码。
主要能力:从 context.json、existing-case-index.json、risk-analysis.json 出发,增量生成只含业务行为的 test-cases.json(不含 Maven/build/安装等技术检查);用例字段(title、preconditions、steps、expected、businessActor、businessAction、businessAssertions、risk 等)用中文,API 路径、代码标识符、枚举值、命令、URL、文件路径等保持原样;按 P0–P3 分级,每条 P0/P1 风险须映射到用例的 riskIds 或记为 open question;支持合并已有用例、校验、渲染 HTML 确认页、三模型交叉审查、编码完整性扫描。
使用方式:CLI 为 quality-assurance-agent/scripts/qa_agent.py,命令由 agent 执行,形式为 python "$QA_AGENT_DIR/scripts/qa_agent.py" <cmd>。流程:加载上游三文件与 .qa-agent/knowledge/ 经验(show-knowledge --category data-prep/api-quirk/test-pattern)→ 生成草稿 test-cases.generated.json → merge-existing-cases → validate-cases --summary --check-mojibake --strict-language → render-cases → review-cases → check-mojibake → 用户确认 → promote-cases 固化到 .qa-agent/cases/<module>.json → 移交下游。
适用场景:需要人工把关业务用例的 QA 流程,尤其是涉及资金、越权、主流程阻塞等 P0 风险的验收轮次。
限制:前置三文件缺一不可,缺失须退回对应阶段;确认是硬门禁,确认前不得运行 promote-cases、不得调用下游、不得写测试脚本;校验失败须修正重跑,不得绕过;中文 JSON 若出现 U+FFFD 需用 safe-write-json --from-stdin 重写;三模型审查不可用时用剩余模型完成并标注缺失。具体命令语法与字段规范见对应 references 文档,本资料未展开。