| name | loom-qa |
| description | QA 验收流水线编排器：从需求变更分析到功能测试、回归测试、集成测试， 维护持久化测试用例库，输出 qa-report.md。 Use when: 测试人员对新功能或 release 进行验收测试，需要完整的功能测试覆盖。
|
| when_to_use | Run QA acceptance for a feature or release, including functional, regression, and integration coverage. |
| argument-hint | <feature, release, or target spec> |
| user-invocable | true |
QA 验收流水线
定位
这是测试人员使用的流水线，与开发流水线完全独立。运行于功能开发完成后，目标是：
- 验证新功能符合 spec 描述
- 确认改动未破坏现有功能（回归）
- 验证模块间集成正确
- 维护持久化测试用例库（
.loom/qa-suite/），功能变更时同步更新用例
流水线阶段
QA 流水线（pipeline_type: qa）有 6 个阶段，每个阶段对应本 skill 的不同职责：
| 阶段 | 职责 | 使用子 prompt |
|---|
qa-analysis | 分析变更范围，确定测试矩阵 | qa-analyst-prompt.md |
qa-design | 生成/更新用例，旧用例转 deprecated | qa-designer-prompt.md |
qa-approved | human-approval gate（自动） | — |
qa-execution | 跑自动化测试，生成手动 checklist | qa-executor-prompt.md |
qa-signoff | human-approval gate，测试人员签字 | — |
qa-report | 汇总 → qa-report.md | qa-reporter-prompt.md |
执行规则
- 进入每个阶段前，读取对应子 prompt 文件（路径见下方）
- qa 战役目录：
qa/<date+target>/（不复用 specs/）
- 用例库：
.loom/qa-suite/，进版本控制，随功能迭代更新
- verdict 三态：
PASS（全绿）/ PARTIAL（自动绿但手动有遗留）/ FAIL（有测试失败）
- CI 门禁：
loom run --spec-dir qa/<target> --verdict，exit 0=PASS，1=FAIL，2=PARTIAL
- 每个非 gate 阶段完成后写入
qa/<date+target>/handoffs/<stage>.json，摘要说明阶段结论、关键产物、未决风险和下一阶段注意事项；不要把完整测试日志写进 handoff。
触发方式
loom run --type qa --spec-dir qa/$(date +%Y-%m-%d)+<target>
loom run --spec-dir qa/<target> --advance --compression-confirmed
loom run --spec-dir qa/<target> --approve
loom run --spec-dir qa/<target> --verdict
子 prompt 路径
references/qa-analyst-prompt.mdreferences/qa-designer-prompt.mdreferences/qa-executor-prompt.mdreferences/qa-reporter-prompt.md
完成条件
QA 阶段产物和对应 handoffs/<stage>.json 均完成后，先压缩旧阶段原始测试过程和长日志，再带压缩确认推进状态机；qa-report 作为终止阶段也必须写入 qa-report.md 与 handoffs/qa-report.json。
