菜单
用于执行 `/qa-loop` 风格的 QA 循环验证编排技能。适合用户要求“qa-loop”、“循环回归直到通过”、“测试→报错→修复→再测”、“把某个 scope/issue 跑到 100% PASS”时使用。它负责在项目内编排完整的测试、报告、Issue 去重与创建、修复、全量回归和收敛控制；不适用于一次性的小型 QA 检查，也不适用于持续轮询监测（那应使用 `qa-monitor` / `qa-watch`）。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
QA 测试工程师 SubAgent。模拟真实用户通过命令行与 Actant 交互，智能判断输出和产物是否合理，黑盒为主白盒为辅，发现问题自动创建 Issue。触发方式：用户提及 "/qa"、"QA run"、"QA test"、"运行测试场景" 等关键词时激活。
QA 持续监测 SubAgent。监听 git HEAD 变化，每有新 ship（commit）自动触发完整回归测试，无变化时进入可配置间隔的休眠轮询。触发方式：用户提及 "/qa-watch"、"QA 监测"、"continuous QA"、"watch ship" 等关键词时激活。
持续审查项目进度、代码质量与 Roadmap 合理性的只读 SubAgent。不直接修改任何源码或文档，仅通过创建 Issue 和添加 Comment 输出审查意见。触发方式：用户提及 "/review"、"审查项目"、"review progress" 等关键词时自动激活。
GitHub-first Issue 管理 SubAgent。Issue 编号和内容以 GitHub Issues 为准，本地 .trellis/issues/ 为 Obsidian 兼容缓存。触发方式：用户提及 "/issue"、"创建 issue"、"create issue"、"新建问题"、"提 bug" 等关键词时激活。
编辑范围冻结技能。用于把当前任务限制在指定路径、模块或责任边界内，越界时必须停下并报告。触发方式：用户提及 "freeze"、"只改这个模块"、"不要动别的文件"、"锁定范围" 等关键词时激活。
高风险会话护栏技能。用于约束危险操作、提醒 destructive command 风险、限制在无验证或无依据时继续推进。触发方式：用户提及 "guard"、"安全模式"、"高风险修改"、"谨慎处理"、"不要乱改" 等关键词时激活。
| name | qa-loop |
| description | 用于执行 `/qa-loop` 风格的 QA 循环验证编排技能。适合用户要求“qa-loop”、“循环回归直到通过”、“测试→报错→修复→再测”、“把某个 scope/issue 跑到 100% PASS”时使用。它负责在项目内编排完整的测试、报告、Issue 去重与创建、修复、全量回归和收敛控制；不适用于一次性的小型 QA 检查，也不适用于持续轮询监测（那应使用 `qa-monitor` / `qa-watch`）。 |
把 qa-loop 当成一个收敛编排器来用，而不是单次测试器。
它的职责是：
单次测试执行引擎不是本技能本身，仍然以以下真相源为准：
如需看旧 slash-command 的原始语义，读取：
将用户意图收敛到以下参数：
scope
all：全部场景<scenario-name>：单个场景#<issue>：围绕某个 issue 的相关场景environment
realmockmax_rounds
0，表示不限轮数skip_fix
unit_only
如果用户没有明确给出这些参数，按以下默认值工作：
scope=allenvironment=realmax_rounds=0skip_fix=falseunit_only=false按顺序决策：
scenarios/<name>.jsonall读取场景时优先使用：
.agents/skills/qa-engineer/scenarios/*.json不要自己发明第二套场景清单。
如果当前已有活跃 task 目录，则在该 task 下写入 QA 产物。
如果没有，创建一个最小任务目录用于承载日志和报告，例如：
.trellis/tasks/qa-loop-<topic>/
每轮必须落两类文件：
qa-log-roundN.mdqa-report-roundN.md日志要求严格复用 QA engineer 的增量写入规则：
不要在整轮执行完后再回忆补日志。
默认 preflight：
git status --short构建与验证：
pnpm build如果 preflight 就已经 BLOCKED，停止并出报告，不要进入伪循环。
默认顺序：
unit_only，执行场景测试关键约束：
对每个 FAIL / WARN：
默认规则：
bug, priority:P1, label: qaenhancement, priority:P2, label: qa如果问题根因不清晰，不直接修代码，先按 investigate 方式补齐：
只有在以下条件同时成立时才进入修复：
skip_fix=false修复后至少做两层验证：
当存在修复时，进入下一轮完整回归。
每轮都要记录：
停止条件：
max_rounds每次使用该技能，对用户输出必须包含：
scopereal 还是 mockPASS、PARTIAL、FAIL 还是 BLOCKED如果真的进入多轮循环，必须持续汇报进展，不能静默执行到最后才一次性总结。
qa-engineerqa-engineer 负责：
qa-loop 负责：
qa-monitorqa-monitor / /qa-watch 适合：
qa-loop 适合：
qa-loop 退化成“跑一次测试”当用户直接说：
使用以下最小步骤：
scopereal/mock