v0.8.0 to v0.8.1

---

name: qa

slug: qa

displayName: QA 测试流水线

---

# QA 编排入口（qa）

把"帮我测试这个需求"翻译成一条**可断点续跑的流水线**。本 skill 是薄编排：**不含任何测试方法与框架知识**（全部在阶段 skill 与 `core/`），不替用户做裁决。

## When to Use

- "帮我测试这个需求 / 功能"、"把这个功能完整过一遍"、"从需求到报告走一遍完整测试"

- 之前的流水线中断了，需要从落盘产物续跑

## When NOT to Use

- 只要单阶段产出 → 对应阶段 skill：需求建模 `requirement-analysis`、测试策略 `test-strategy`、写用例 `test-case-writing`、审查已有用例 `test-case-review`、E2E 执行 `automated-e2e-testing`、API 执行 `api-testing`、探索会话 `exploratory-testing`、Bug 根因 `bug-analysis`、回归范围 `regression-testing`

- 编写/修改某个阶段 skill 自身的方法论 → 不经过本 skill

## 编排会话模型（阶段间上下文隔离）

- **每个阶段运行在独立上下文中**（宿主支持子会话/子代理时）：只加载当前阶段 skill 的 SKILL.md + 按需 references + 上一阶段的落盘产物文件；任一时刻活跃指令 ≤ 1–2 个 skill（当前阶段 + 本编排）

- **主会话只持有流水线状态**：阶段清单、各产物文件路径、检查点状态——不加载任何阶段 skill 的领域知识

- **降级路径**：宿主不支持子会话、或用户在单会话内手动走流水线时，退化为**顺序会话 + 落盘文件衔接**——正确性不受影响（状态全在文件里），损失的只是上下文卫生

- **反模式**：单会话内顺序累加加载全部 SKILL.md（9 个 × 数百行指令同时在场）

- **注入式形态的例外**：预注入部署（评测或宿主一次性注入全部指令）下本节隔离机制不存在——此时**靠阶段顺序防串扰**：任一时刻只执行当前阶段的指令，其余在场文件视为未加载；"文件即流水线状态"的原则两形态通用（双形态声明见 `../core/evidence.md` 第 6 节）

## 流水线与落盘产物（文件即流水线状态）

| # | 阶段 | skill | 落盘产物 | 人工检查点 |

|---|------|-------|---------|-----------|

| 0 | （旁路，可选）探索先行 | `exploratory-testing` | `{项目}/探索笔记_{主题}.md` | — |

| 1 | 需求理解 | `requirement-analysis` | `{项目}/需求模型.md`（含澄清记录） | ⏸ 澄清检查点：模糊/矛盾项等用户裁决 |

| 2 | 测试策略 | `test-strategy` | `{项目}/测试策略.md`（Risk Map + 两域 scope 含 type_scope）+ `专项移交_{轴}_{日期}.yaml`（有 handoff/blocked/外部执行器轴时） | ⏸ 预算裁决：full 预算裁剪触及 Critical 轴时呈现排序提案等用户裁决 |

| 3 | 用例编写 | `test-case-writing` | `{项目}/测试用例_markmap.md` + `测试用例.schema.yaml` | — |

| 4 | 用例审查 | `test-case-review` | 修订后用例文件 + 审查记录（重新抽取 Schema） | — |

| 5 | 执行 | `automated-e2e-testing` / `api-testing` / 手动 | 自动路径：执行代码或脚本（`playwright/` 或 API 测试脚本）+ **执行分报告** `测试报告_{来源}_{日期}.md`（命名见 `../core/report-template.md` 头注；至少 §2 执行统计 + §3 Bug 清单条目，字段按 report-template）；手动路径 `手动执行记录_{日期}.md` | ⏸ 执行策略裁决：确认 automation_plan 提案（手动/e2e/api）；手动路径执行后 ⏸ 结果回收（TC × 结果） |

| 6 | Bug 分析 | `bug-analysis`（有已确认 Bug 时） | 中间产物 `{项目}/Bug条目_{日期}.md`（条目结构与根因分析等五个扩展字段按 report-template §3）——此阶段**禁止新建或改写**最终测试报告 | ⏸ Bug 定性检查点：预期 vs 缺陷 |

| 7 | 回归验证 | `regression-testing`（有代码变更/Bug 修复时） | `{项目}/回归清单_{日期}.md` | — |

| 8 | 收尾报告 | 本 skill（按 `../core/report-template.md`） | `{项目}/测试报告_{日期}.md` | — |

> 旁路触发条件：文档缺失 / 系统陌生时，阶段 0 在阶段 1 之前先行，探索产出（系统理解 + 风险清单）作为需求建模输入。

>

> 手动执行路径无 skill 与自动产物——执行后按 ⏸ 结果回收检查点向用户索取结果，落盘 `手动执行记录_{日期}.md`（TC 编号 × 结果〔通过/失败/阻塞〕，失败附 Bug 编号或现象）：作为阶段 8 报告 §2 执行统计与 §3 Bug 清单的数据来源，防"未执行"列成为永久状态。

>

> 阶段 6 的 `Bug条目_{日期}.md` 是**中转中间产物**：最终报告在阶段 8 才生成，此期间 Bug 条目无处追加——先落中转文件，阶段 8 拼装进报告 §3 后以报告为准，该文件归档留痕，不形成双数据源。阶段 2 生成的 `专项移交_{轴}_{日期}.yaml` 同样进入主会话的状态跟踪：后续任一阶段产出或用户反馈使移交轴状态变化时同步更新 yaml 内 `execution_status`，防移交包生成即失联。

>

> **跨会话知识**：阶段产出命中值得跨会话沉淀的 QA 知识（环境怪癖 / flaky 判定 / 缺陷模式等）时，按 `qa-memory` 判定写入项目 `.qa/` 知识库；会话内状态仍以落盘产物为准，两者不可互替。

## 工作流

### 1. 启动：意图识别与路由

- 用户意图是**端到端流水线** → 继续本 skill

- 用户意图是**单阶段产出** → 移交对应阶段 skill，本 skill 退出

- **开工先收输入**（用户提供或指路，产物对应位置留 TODO 指明"找谁拿什么"）：需求材料、代码仓库与**对比基线**（base 分支/tag/commit——阶段 7 回归范围凭它划界，落盘进需求模型文件头，防续跑时凭据缺失）、测试环境与账号

### 2. 断点检查（续跑）

续跑先读 `{项目}/流水线状态.md`：**未决区存在用户已回填的裁决时，先按裁决增量修订受影响阶段的产物**（更新需求模型假设、在 `budget_review` 补 `approved_by: 用户` 等——不重跑阶段），再按下述判据续跑；未回填的未决项维持保守分支并保持未决标记，不得当作已裁决。然后检查 `{项目}/` 下已有哪些落盘产物，从**最后一个完整阶段之后**继续，不重做已完成阶段。**阶段完成判据**（阶段 3/4 产物同名，凭判据区分，不凭文件存在性猜测）：

- 阶段 1：`需求模型.md` 存在

- 阶段 2：`测试策略.md` 存在且 `validate_schema.py` V1–V5 通过（type_scope 含 handoff/blocked 轴或外部执行器时，对应 `专项移交_{轴}_{日期}.yaml` 应已生成）

- 阶段 3：用例双轨落盘且 `validate_schema.py {用例文件}`（用例 Schema 单文件校验）通过

- 阶段 4：用例文件末尾含 **test-case-review 落款**的审查记录节「## 审查记录（test-case-review …）」且 Schema 已重新抽取校验——阶段 3 写时自审的同名「审查记录」节不算数（那是阶段 3 的完成标志，区分两者防续跑时静默跳过独立审查）

- 阶段 5：`测试报告_{来源}_{日期}.md`（自动路径）或 `手动执行记录_{日期}.md`（手动路径）落盘

- 阶段 6：`Bug条目_{日期}.md` 中转文件落盘；无 Bug 则在 `{项目}/流水线状态.md` 追加一行「阶段 6：无已确认 Bug，跳过」（跳过/未决等流水线状态统一记此文件——硬规则 3"状态全在文件"的续跑凭据，缺该行视为阶段未到）

- 阶段 7：`回归清单_{日期}.md` 落盘；无代码变更则在 `{项目}/流水线状态.md` 追加一行「阶段 7：无变更，跳过」

产物缺失/损坏则从该阶段重跑。

### 3. 按流水线顺序调度阶段 skill

- 每个阶段：在独立上下文中调用对应 skill（或降级为顺序调用），输入 = 上一阶段的**落盘产物文件路径**（不是会话记忆）

- **检查点暂停**：遇到 ⏸ 环节，向用户呈现该阶段 skill 汇总的问题/提案，**等待用户答复后**再进入下一阶段；用户在澄清环节的明确答复具有最终裁决力（见 `../core/evidence.md` 裁决规则），后续阶段不得推翻

- **headless / 非交互运行**（CI 流水线等无对话场景）：⏸ 检查点不等待、不代答，按 `../core/pipeline-integration.md`（此时加载）约定一降级为未决项落盘——有保守默认值的取保守分支并记录依据，其余记未决项；未决项与跳过标记统一落 `{项目}/流水线状态.md` 未决区，人工回流回填裁决后由断点检查（§2）增量消费；带留痕要求的裁决产物（如 `budget_review`）按约定一第 4 条如实记 headless 未决，不得写成用户已批准

- 阶段产出落盘失败（文件未生成）→ 该阶段重跑，不进入下一阶段

### 4. 收尾：生成测试报告

全部阶段完成后（或用户要求提前收尾），按 `../core/report-template.md`（此时加载）汇总生成 `{项目}/测试报告_{日期}.md`：范围、执行统计（自动运行结果与手动执行记录合并）、Bug 清单（拼装阶段 6 的 `Bug条目_{日期}.md` 并逐条同步状态——有回归结果的按结果更新为已验证关闭/已修复待验证，未回归的保持新建）、风险残留、回归摘要、类型域专项结果按 report-template §7 逐轴归一化回收（handoff / 外部执行 / blocked / exclude）、未闭环事项（含移交 yaml 各轴当前状态与去向）、各阶段产物路径索引、机读摘要片段（按 report-template「机读摘要片段」节生成，供报告聚合系统消费）。

### 5. 交付

向用户报告：最终报告路径 + 各阶段产物清单 + 未闭环事项（TODO 归属）。

## 硬规则

1. **不做裁决**：澄清、执行策略、Bug 定性、预算裁决一律呈现问题与建议后等用户，不代替用户决定

2. **不含领域知识**：测试方法、框架知识全部在阶段 skill 与 `core/`；本 skill 失败的唯一合理原因是编排错误，不是测试判断错误

3. **状态全在文件**：任何会话中断后，凭 `{项目}/` 落盘产物即可续跑

4. **阶段产物消费走文件**：跨阶段传递的是产物路径，不是会话内转述

## Common Mistakes

| 错误 | 后果 | 正确做法 |

|------|------|---------|

| 把所有阶段 skill 的 SKILL.md 都加载进同一会话 | 指令冲突、上下文爆炸 | 阶段间上下文隔离，主会话只持状态 |

| 单阶段意图也启动流水线 | 过度执行、浪费 | 意图识别后移交对应阶段 skill |

| 检查点自答（替用户裁决） | 裁决失效，后续阶段基于错误假设 | ⏸ 环节必须等用户答复 |

| 凭会话记忆续跑（不读落盘文件） | 中断后状态丢失/不一致 | 断点检查只认文件 |

| 编排层塞入测试方法论 | 破坏薄编排、难以维护 | 方法论全部下沉阶段 skill 与 `core/` |

| 阶段 6 提前新建/改写最终测试报告 | 与阶段 8 收尾同名双写、双数据源 | Bug 条目先落 `Bug条目_{日期}.md` 中转文件，收尾统一拼装 |

| 跨会话知识与流水线产物混写 | 知识不沉淀 / 流水线状态被污染 | 会话内状态看落盘产物，跨会话知识看 `.qa/`（`qa-memory`） |