用途:当一个已分诊的 Agent QA 运行失败、需要修复代码或 YAML 时使用。适用于工件与日志指向测试、hook、被测产品、运行时基础设施或智能体行为缺陷的情形,也可用于按证据自愈或更新过时的 Agent QA 定义。
主要能力与流程:先收集证据,依次调用 agent_qa_get_run、agent_qa_get_run_steps、agent_qa_get_run_artifact、agent_qa_get_run_logs、agent_qa_get_run_execution_logs;再调用 agent_qa_classify_failure,把分类结果当作假设而非结论。据此定位失败面,直接检查相关本地文件,而不是仅凭工件推断补丁。说明证据与改动之间的关联后,只做最小的代码或 YAML 改动;改动用 agent_qa_validate_test、agent_qa_validate_suite、agent_qa_validate_definition 校验,再在获准环境中重跑最窄相关的测试、套件、hook 或单元测试,最后报告根因、改动文件、验证命令或 MCP 动作、结果与剩余风险。MCP 不可用时可用仪表盘 REST API 或本地 .agent-qa 工件,并说明 MCP 证据不可用。
规则与限制:不得编造选择器、界面状态、截图、日志或源文件;工件显示产品或运行时缺陷时,不得只为让测试通过而改写测试;编辑测试、套件、hook 或记忆文件时保留规范 Agent QA ID。重跑前需检查外部副作用,对面向生产、破坏性或不可逆操作获取明确确认,并保持补丁限于已证实故障,保留无关的用户改动,不泄露凭据或敏感数据。需访问运行证据与本地源码;工件本身可能不足以确定根因;一次成功重跑无法保证间歇性的浏览器、设备、网络或提供商故障已修复;不授权生产改动、数据变更、依赖安装或超出批准范围的更大重构;窄范围重跑通过不能替代仓库常规测试套件与人工评审。证据无法区分实质不同修复方案时应停止并报告阻塞。