| name | mcp-acceptance |
| description | 执行 MCP 驱动的 7 阶段验收流程。当代码修改完成需要验收时触发,或用户请求运行验收。 |
MCP 验收流程
执行流程
- Master Agent 将测试任务写入
.trae/current_task.md
- Master Agent 唤醒 test-agent
- test-agent 执行阶段 1-5
- test-agent 返回结果摘要
- Master Agent 根据结果决定下一步:
- 成功 → 进入阶段 6-7
- 失败 → 输出
[REQ_DEV]
执行者分工
| 阶段 | 执行者 | 说明 |
|---|
| 1-5 | test-agent | CI 自动化 + 无头验收 |
| 6-7 | Master Agent | PR 管理、审查处理、合并决策 |
触发条件
阶段概览
阶段 1-3: CI 自动化(静态检查 → 单元测试 → 集成测试)
阶段 4-5: MCP 无头验收(Dev无头 → User无头)
阶段 6-7: PR 管理(创建PR → 等待审查 → 合并确认)
阶段 1-3:CI 自动化
ruff check . && ruff format --check .
pytest tests/unit/ -m "not real" -v
pytest tests/integration/ -v
阶段 4:Dev 无头验证(不可跳过)
执行者:调用 test-agent
降级执行策略:
rscore --dev --headless
python main.py --dev --headless
禁止跳过:必须执行降级测试,不能因为 rscore 失败就跳过。
页面观察:test-agent 使用 Playwright MCP 观察浏览器页面状态,验证程序运行情况。
环境探测:读取 environment.yml 或 pyproject.toml 确定虚拟环境
通过条件:退出码 0,无严重错误
阶段 5:User 无头验证(不可跳过)
执行者:调用 test-agent
降级执行策略:
rscore --user --headless
python main.py --user --headless
禁止跳过:必须执行降级测试,不能因为 rscore 失败就跳过。
页面观察:test-agent 使用 Playwright MCP 观察浏览器页面状态,验证程序运行情况。
检查诊断报告:logs/diagnosis/latest/
阶段 6-7:PR 管理
阶段 5 通过后,直接进入 PR 流程:
- 提交 Commit
- 推送到远程
- 创建 PR
- 调用
pr-review Skill 执行审查流程
错误处理
测试失败
│
▼
Agent 自诊断(读取 traceback、日志、诊断报告)
│
├─ 可修复 → 修复代码 → 重跑测试
│
└─ 不可修复 → 生成分析报告 → 向用户求助
有头验收(开发者可选)
非标准流程,开发者手动执行观察 UI 行为:
python main.py --dev