| name | test_run |
| description | QA 在沙盒里执行 qa/test_plan.md 所有用例、收集失败、写 defect 的 skill。当 QA 收到 type=task_assign 且 subject 含'测试执行/run tests'的邮件时**一定**加载本 skill。按 test_plan 跑 pytest → 通过标 pass、失败写 qa/defects/defect_{id}.md → 汇总 qa/test_report.md + task_done。如有 defect，顺带发 task_assign 给 RD 修复。所有'QA 真的跑测试'的时刻走此 skill。 |
| type | task |
test_run — 执行测试
⚠️ 执行方式
- 跑 pytest：使用
execute_code 工具执行 Python subprocess 代码
- 写 defect 报告：使用
write_shared(pid, "qa/defects/defect_{id}.md", content)
- 汇总报告：使用
write_shared(pid, "qa/test_report.md", content)
- 发邮件：使用
send_mail 工具
🚨 Critical Rules
- 一条用例一个 defect 文件：便于后续 RD 修复时精确对应。
- test_report.md 是强制交付物：Manager 据此判断交付 or 打回。
- defect 文件必填 reproduce 步骤 + 期望 vs 实际：否则 RD 修不了。
步骤
Step 1 — 读 test_plan
read_shared(pid, "qa/test_plan.md") 拿用例清单
Step 2 — 跑全部测试
使用 execute_code 工具，传入：
import subprocess
pid = "PROJECT_ID_HERE"
code_dir = f"/workspace/shared/projects/{pid}/code"
result = subprocess.run(
["bash", "-c", f"cd {code_dir} && pip install -r requirements.txt -q && python -m pytest -v --tb=short 2>&1 | tail -120"],
capture_output=True, text=True
)
print(result.stdout)
if result.returncode != 0:
print("STDERR:", result.stderr[-2000:])
Step 3 — 按 test_plan 逐条映射
对每个 C-XX：
- pytest 通过 & 场景符合预期 → 标 pass
- 失败 → 写 defect：
write_shared(pid, "qa/defects/defect_{id}.md", defect_md)
Defect 模板：
# Defect {C-XX}
- **用例**: ...
- **优先级**: F/H/M/L
- **Reproduce**: POST /diary {invalid}...
- **期望**: 422 + error_code=invalid_input
- **实际**: 500 + "internal server error"
- **栈**: （pytest 输出最后 30 行）
Step 4 — 汇总 test_report.md
# 测试报告
- 执行时间：...
- 总用例：18
- 通过：16
- 失败：2
## 失败用例
- C-07（defect qa/defects/defect_c07.md）
- C-12（defect qa/defects/defect_c12.md）
## 覆盖率
78%（来自 pytest --cov）
write_shared(pid, "qa/test_report.md", ...)
Step 5 — 发 task_done + 可选转发
send_mail(to="manager", type="task_done", subject="测试执行完成", content={...}, project_id=pid)- 若有 defect：
send_mail(to="rd", type="task_assign", subject="修复缺陷 (第 N 轮)", content={"defects": ["qa/defects/defect_c07.md", ...]}, project_id=pid)
mark_done(pid, <task_assign_msg_id>)
输出
{
"status": "success",
"artifacts": [{"path": "qa/test_report.md"}, {"path": "qa/defects/defect_c07.md"}],
"metrics": {"total": 18, "pass": 16, "fail": 2, "coverage": 0.78},
"self_score": 0.83,
"breakdown": {"completeness": 1.0, "self_review": 0.8, "hard_constraints": 1.0, "clarity": 0.7, "timeliness": 0.8}
}
