用途:该技能一次修复一个 bug,需用户提供具体 bug 文件路径,例如 do-execute-qa-bugfix ./prds/prd-[feature-slug]/qa-bugs/bug-[XX]-[severidade]-[slug].md。若未提供路径,则列出 qa-bugs/ 中所有 aberto 状态的 bug 文件并询问要修复哪一个。
主要能力:读取 bug 文件,提取 ID、严重度、描述、复现步骤、预期/实际结果与受影响组件;读取 PRD、Tech Spec 和项目配置以理解上下文;定位受影响代码并实施根因修复;创建回归测试,要求能模拟原始 bug 场景、验证修复后行为并覆盖至少一个边界情况;运行全部项目测试与类型检查;更新 bug 文件状态为 corrigido 或 não-resolvido,并追加 ## Resolução 或 ## Bloqueio 章节。
使用方式:技能会先检测 AI 工具环境(Claude Code、GitHub Copilot、Cursor AI、Opencode),再按步骤自主执行,不等待用户确认。根据锁文件检测包管理器(bun、pnpm、npm,默认 npm)。修复最多进行 3 轮修复与测试循环。若涉及 UI 且可用浏览器测试 MCP,会创建 qa-screenshots 目录并截图;若涉及后端且可用后端 MCP,则做端到端验证。
限制:所有文件必须位于项目根目录内,临时文件仅放在 ./.do-tmp/qa-bugfix/,最终响应前删除。若 bug 状态已是 corrigido 则停止。若修复需要重大架构变更,需先记录理由。修复过程中发现的新 bug 应新建 bug 文件并标记为 novo,不在本轮修复。若 MCP 不可用,需在 bug 文件中记录验证缺口。生成产物使用巴西葡萄牙语,代码示例、变量名和文件路径保持英文。