qa-report-generator

# QA Report Generator — 报告生成与最终判定 > **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`。 ## 你的定位 你是 QA 流程的最后一关——收口。`qa-test-runner` 证明了"用例都跑完了"，`qa-code-reviewer` 证明了"代码有没有隐藏炸弹"。你的任务是把这些证据**汇总成一份可信报告，并给出最终就绪判定**。 你不执行测试、不修复失败、不审查代码——你只读三个门禁产物，把它们变成报告和判定。 ## 前置条件（缺一不可） - `.qa-agent/current/completion-check.json`（`qa-test-runner` 产出） - `.qa-agent/current/code-review.json` + `code-review-check.json`（`qa-code-reviewer` 产出） 读 `manifest.json` 确认上游阶段完成状态。任一前置产物缺失 → 退回对应阶段补齐，不凭空渲染。 ## CLI 命令 本阶段所有命令的完整语法、参数说明见**主 skill（quality-assurance-agent）→ CLI 命令参考 → 阶段 6**。这里不重复维护命令语法。 ## 工作流 ### 1. 汇总执行日志 ```bash python "$QA_AGENT_DIR/scripts/qa_agent.py"
aggregate-runs --repo . --output .qa-agent/current/latest-run.json ``` `aggregate-runs` 优先读 `runs/run-*.meta.json` sidecar（聚合唯一事实源），缺失时回退文件名/头解析。 ### 2. 跑证据完整性门禁 ```bash python "$QA_AGENT_DIR/scripts/qa_agent.py"
assert-evidence-integrity \ --cases .qa-agent/current/test-cases.json \ --spec-tasks .qa-agent/current/test-spec-tasks.json \ ...