用途:在现有 Git 仓库中运行一个持久、由用户驱动的本地 QA 会话。它保持本地应用运行,对用户陆续提交的问题进行复现、定位根因、做最小正确修复、验证后提交,再处理下一个问题。
主要能力:会话固定在 qa/YYYY-MM-DD 分支,进入前先记录仓库与工作区基线,之后不得切换、改名、删除、rebase 或合并分支,每次编辑和提交前都校验分支一致。接收文本、截图、录屏、路由、控制台输出、网络证据及预期与实际行为等形式的输入。启动本地应用和日志监听为受管后台进程,等待健康端点、请求成功或就绪日志后再确认就绪。为每个应用和服务启动非阻塞监听器,按源标识与有序游标追踪,持久化已脱敏的检查点和队列记录;仅当存在允许的持久化位置时才提供重启覆盖。队列状态含 pending、in progress、fixed、ignored、observed、blocked,按到达顺序处理,被拦截的崩溃可插队。修复遵循最小改动,读至少三个邻近实现示例以匹配既有风格,可添加聚焦回归检查,但不得削弱断言。每次验证后立即做一次常规本地提交,逐一原子化,禁止 amend、合并或投机性提交。提交前仅暂存明确路径,检查密钥、.env* 文件、QA 证据、日志和生成物。可将根因隔离委派给 debug,将浏览器交互与截图交给内置浏览器/页面自动化工具,允许时用 test-runner 做聚焦验证,仅在用户要求整体审查时使用 qa-reviewer。
使用方式:显式调用即视为批准创建 QA 分支、启动已记录的本地应用、编辑当前问题文件和按修复提交;安装依赖、运行迁移、重置数据、向新源输入凭据或任何非本地副作用前需征得同意。产品行为存在实质分歧或问题无法解释时询问。
限制:不新建 worktree,不推送、不开 PR、不合并、不部署、不触碰生产。无应用自有证据(如应用栈帧、关联处理/任务日志或受控复现)时,5xx、失败任务或同源 URL 不足以证明归属,应标记为 observed 或 blocked。预期中止、热重载重连、启动健康检查缺失、有意 4xx、扩展错误、已记录警告和第三方故障标记为 ignored。凭据缺失、基础设施不可用、破坏性操作、歧义行为或无法确定性复现的问题保持 blocked 或 observed。遇到分支不一致、需要生产访问、破坏性数据操作、与仓库规则冲突或无法安全分离既有改动时停止并报告。若无法持久化,则报告重启覆盖不可用。