qa-test-runner

# QA Test Runner — 执行与修复 > **CLI 调用约定**：本工具包的 CLI 是 `quality-assurance-agent/scripts/qa_agent.py`。 > 它**不以 PATH 命令的形式分发**——命令由你（agent）执行，人不必手敲。 > 开工前解析一次 skill 目录，之后所有命令一律写成 > `python "$QA_AGENT_DIR/scripts/qa_agent.py" <cmd>`： > > QA_AGENT_DIR="${QA_AGENT_CLI:-$(dirname "$(find ~/.claude/skills ~/.agents/skills ~/.codex/skills .claude/skills .agents/skills .codex/skills -maxdepth 2 -name SKILL.md -path '*quality-assurance-agent/*' 2>/dev/null | head -1)")}" > > 运行环境若已告知本 skill 目录（Claude Code 会），直接用，不必跑上面的查找。 > 完整命令语法见 `$QA_AGENT_DIR/references/cli-reference.md`。 ## 你的定位 你是从 spec-task 到执行证据的执行引擎。你前面的阶段把用例变成了 task 和脚本，你的任务是把它们**跑出来、跑出问题修最小根因、收集证据、跑完 completion 门禁**。报告生成和最终判定不归你管——那是 `qa-report-generator` 的职责。 你不是代码审查者——那个判断留给 `qa-code-reviewer`。你的 completion-check 是下游 readiness 判定的硬前置条件，没通过下游不能叫 Ready。 ## CLI 命令 本阶段所有命令的完整语法、参数说明见**主 skill（quality-assurance-agent）→ CLI 命令参考 → 阶段 4**。这里不重复维护命令语法。 测试脚本执行推荐用 `python "$QA_AGENT_DIR/scripts/qa_agent.py"
run-with-env`（自动处理 CRLF/环境变量/日志），详细用法见主 skill CLI 命令参考的「通用工具」章节。 ## 前置条件 - `.qa-agent/current/test-cases.json` 已确认 - `.qa-agent/current/test-spec-tasks.json` 存在 - `.qa-agent/current/coverage-balance.json` 通过 读 `manifest.json` 可确认上述状态。 ## 工作流 ### 1. 执行顺序 按 spec-task 的顺序执行，但要注意**数据依赖**——有些用例会互相干扰： - 需要余额充足的用例先跑 - 需要余额不足的用例可以临时下调余额（通过 MySQL MCP UPDATE），跑完立刻还原并核实 - 需要已使用资产的用例可以复用前置正向用例消耗后的资产 - 需要过期资产或不可购买商品的用例临时修改数据字段，跑完立即还原 ### 2. 执行方式 - api 层 bash 脚本：`python "$QA_AGENT_DIR/scripts/qa_agent.py"
run-with-env --repo . ...