用途:处理“逃逸”——智能体自检通过、但人类 QA 之后发现的缺陷。每个逃逸产出三样东西:复现证据、应优先编写的回归测试、以及记录的逃逸类别,用于后续同区域工单的检查。目标是同一类别最多逃逸一次,之后检查方式必须改变。
主要能力:读取 QA 报告(步骤、预期、实际、环境、截图或日志)与相关 issue 及其 PR,读取 PR 中的 agentic-qa、risk-review 标记评论和 /tdd-loop 摘要作为智能体的声明;在隔离 worktree 中按 QA 测试的版本复现;分类并追溯“为什么智能体的检查通过了”,最多五步,终点必须是一个可修改的检查;指定最低可暴露该缺陷的回归测试层;统计同类同区域逃逸数量,达到三个时提出持久防护。
使用方式:在隔离 worktree(<project-repo>/.worktrees/qa-escape-<issue>,detached 到 QA 测试的版本)中复现,首次命令前需按工作区 AGENTS.md 报告检出记录;用 git merge-base --is-ancestor <pr-merge-sha> <tested-sha> 确认修复是否在测试版本中;用 gh issue list --label qa-escape --state all --json number,title,body,comments 统计类别;评论末尾写入固定标记行,并添加 qa-escape 标签。任何远程写入前需一次批准;由 /factory run 加载时,运行开始即批准发评论与加标签。
限制:从不编辑代码或测试,输出仅为简报、测试规格与 issue 评论,测试与修复由 /tdd-loop 编写;无法复现的记录为 reproduced=no、class=none,不计入晋升;类别来自 references/escape-classes.md 固定列表;晋升需三个同类同区域且需用户批准;离开会话前必须脱敏;输出零署名;必须使用 Project Matrix 中的完整 PROJECT-CODE。