agent-qa-debug-fix - SKILL

---

name: agent-qa-debug-fix
description: “Debug, patch, and verify failed Agent QA runs from MCP evidence, artifacts, logs, and local code without hiding product or infrastructure defects.”
category: testing
risk: critical
source: https://github.com/vostride/agent-qa/tree/main/skills/agent-qa-debug-fix
source_repo: vostride/agent-qa
source_type: official
date_added: “2026-08-16”
author: Vostride
tags: [testing, qa, debugging, mcp, self-healing]
tools: [claude, cursor, gemini, codex]
license: FSL-1.1-ALv2
license_source: https://github.com/vostride/agent-qa/blob/main/LICENSE.md

代理 QA 调试修复

概览

根据记录的证据和相关的本地来源修复失败的 Agent QA 运行。将分类器视为假设，做出最小的合理修改，并验证最狭窄的受影响行为，而不是仅仅为了掩盖真实缺陷而重写测试。

何时使用

• 一次失败的代理 QA 运行已经被归类，现在需要修复代码或 YAML。
• 工件和日志指向测试、挂钩、产品、运行时或代理行为缺陷。
• 提出的修复必须通过最狭窄的 Agent QA 或单元测试重新运行进行验证。
• 用户请求根据证据自我修复或更新过时的代理问答定义。

先决条件和审批边界

• 确认用户授权你修改的仓库、工作区、目标环境和文件。
• 在重新运行计划的测试之前，检查其外部副作用；对于面向生产的、破坏性或不可逆的操作，获取明确确认。
• 保留无关的用户更改，并将补丁限制在有证据的故障范围内。
• 不要在工件和日志中泄露凭证或敏感的应用程序数据。

工作流程

1. 从收集证据开始：
   • 代理_问答_获取运行
   • agent_qa_get_run_steps
   • agent_qa_get_run_artifact
   • agent_qa_get_run_logs
   • agent_qa_get_run_execution_logs
2. 调用agent_qa_classify_failure并将其类别视为假设，而不是结论。
3. 识别失败的部分：测试定义、钩子、被测试应用、运行时基础设施或代理行为。
4. 直接检查相关的本地文件。不要仅凭工件推断补丁。
5. 解释证据与变更之间的联系，然后应用最小的代码或 YAML 修改来解释该证据。
6. 在执行之前验证任何更改的代理QA定义。
7. 在批准的环境中重新运行受影响最小的 Agent QA 测试、测试套件、挂钩或单元测试。
8. 报告根本原因、变更的文件、验证命令或MCP操作、结果及剩余风险。

修复规则

• 不要发明选择器、屏幕状态、截屏、日志或源文件。
• 当工件显示产品或运行时缺陷时，不要仅仅为了通过测试而重写测试。
• 在编辑测试、套件、钩子或内存文件时，保留规范的 Agent QA ID。
• 在重新运行编辑过的 YAML 之前，优先使用agent_qa_validate_test、agent_qa_validate_suite和agent_qa_validate_definition。
• 当 MCP 不可用时，请使用仪表板 REST API 或本地.agent-qa工件，并说明 MCP 证据不可用。
• 当证据无法区分实质性不同的修复时，停止并报告阻塞因素。

例子

User: Fix the failed staging checkout run, but do not touch production. Expected handling: collect the failed run evidence, classify it, inspect the implicated local definition and application code, patch only the evidenced cause, validate, rerun the single staging test, and report changed files plus remaining uncertainty.

限制

• 需要访问相关的运行证据和本地来源；仅凭工件可能无法确定根本原因。
• 无法保证在一次成功的重新运行后，间歇性的浏览器、设备、网络或提供商故障已经修复。
• 不授权进行生产更改、数据变更、依赖安装或超出用户批准范围的更广泛重构。
• 一次偶然的窄回放不能替代仓库的常规测试套件或人工审查。