| 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.md
references/qa-designer-prompt.md
references/qa-executor-prompt.md
references/qa-reporter-prompt.md
完成条件
QA 阶段产物和对应 handoffs/<stage>.json 均完成后,先压缩旧阶段原始测试过程和长日志,再带压缩确认推进状态机;qa-report 作为终止阶段也必须写入 qa-report.md 与 handoffs/qa-report.json。