agent-qa-result-triage - SKILL

name: agent-qa-result-triage
description: “Triage failed Agent QA runs with MCP evidence, artifacts, logs, fixed failure categories, confidence, and actionable next steps.”
category: testing
risk: safe
source: https://github.com/vostride/agent-qa/tree/main/skills/agent-qa-result-triage
source_repo: vostride/agent-qa
source_type: official
date_added: “2026-08-16”
author: Vostride
tags: [testing, qa, triage, mcp, debugging]
tools: [claude, cursor, gemini, codex]
license: FSL-1.1-ALv2
license_source: https://github.com/vostride/agent-qa/blob/main/LICENSE.md

代理QA结果分流

概览

根据已记录的证据对失败的代理 QA 运行进行分类，而不是猜测。检查运行情况、步骤、产物和日志；选择一个固定类别；并返回置信度、可能的责任归属以及下一步有证据支持的行动。

何时使用

• 调查失败或中断的代理 QA 运行。
• 检查运行产物、步骤结果或执行日志。
• 比较近期相关运行的重复故障模式。
• 决定某个故障是归属于测试、产品、钩子、浏览器/移动运行时，还是基础设施拥有者。

工作流

1. 从agent_qa_get_run开始，以获取运行状态、套件子上下文、步骤和尝试次数。
2. 在做决定之前获取证据：
   • agent_qa_get_run_artifact
   • agent_qa_get_run_steps
   • agent_qa_get_run_logs
   • agent_qa_get_run_execution_logs
3. 调用agent_qa_classify_failure并使用其类别作为默认分类，除非有更强的证据与之相矛盾。
4. 在分类器输出中可用时，比较最近的相关运行。
5. 返回简明的分诊结果：类别、置信度、证据、可能的修复区域和下一步行动。
6. 对于代码更改，分诊完成后切换到agent-qa-debug-fix。

类别

使用references/triage-categories.md中的恰好一个类别：

• 超时
• appium_启动
• 浏览器断开连接
• 未找到元素
• 断言失败
• 钩子失败
• 基础设施
• 未知错误

证据规则

• 引用或总结具体的工件、日志或步骤证据。
• 在它们限制信心时提到缺失的文物部分。
• 不要编造 MCP 没有返回的截图、视频、日志或内存内容。
• 如果 MCP 无法使用，请使用仪表板 REST API 或 Agent QA CLI 输出作为备用，并说明哪个证据不可用。
• 从报告中编辑掉凭证、会话令牌、个人数据以及无关的应用内容。

例子

{"category":"element_not_found","confidence":"high","evidence":["Step 4 could not resolve the described checkout button"],"likely_fix_area":"test definition or changed product UI","next_action":"Inspect the captured UI context, then compare the current checkout screen"}

限制

• 分类的可靠性仅取决于保留的运行工件和日志。
• 故障类别识别最可能的故障面；它并不证明根本原因。
• 缺少截图、DOM/可访问性上下文、设备日志或先前运行记录必须降低信心。
• 此技能不会修改测试或应用程序代码；请使用agent-qa-debug-fix进行授权修复。