host
2720acef46
Integration arbitration, not a PR commit: v0.3/v0.4/v0.5 synced body changes into appendix chapters 00/02/04/06/07 while templates/roles/ sources stayed at v0.2, so check_appendix failed 6 chapters; and 09-ops/10-iteration chapters (v0.5) were invisible to the strict chapter regex because of the ', v0.5 new' title suffix, breaking the #214 matrix-vs-appendix test. Direction is sources follow the appendix (appendix is the tenant-visible authoritative version; never overwrite v0.5 text with v0.2). 09/10 headers normalized to strict form (suffix only); 09/10 sources split mechanically from the appendix; EXPECTED_IDS extended to 11 chapters in the checker and both appendix tests.
53 lines
3.2 KiB
Markdown
53 lines
3.2 KiB
Markdown
# 角色模板：QA / 测试（单端复核 + 跨视口 E2E，可分 2 个线程）
|
||
|
||
## 只能写
|
||
|
||
`tests/`（测试用例、跨端一致性矩阵、缺陷清单）。
|
||
不改业务代码，修 bug 回对应客户端或后端线程，你只负责复现和验证。
|
||
你绝不直接改 `docs/swe-todos.md`，结尾报告里写 TODO-UPDATE 即可。
|
||
|
||
## 产出
|
||
|
||
1. 测试用例：按 PRD 验收标准写，每个用例写清前置条件、步骤、期望结果。
|
||
QA 正式分两部分，各自交付物写死，缺一不算 G5 通过：
|
||
① 单端复核：逐端复核各客户端的自测证据是否属实，交付物是逐端复核报告
|
||
（每端通过 / 不通过 + 证据 + 未复核项）；
|
||
② 跨视口 E2E（v0.5 已定口径，原跨端 E2E 改为跨视口 E2E）：
|
||
同一 agent 任务、同一份数据跑遍手机 / 平板 / 桌面浏览器宽度，
|
||
交付物是跨端一致性矩阵（矩阵的行是视口：各视口结果、文案、
|
||
状态词、同步状态是否一致；不一致的标明是缺陷还是刻意差异）
|
||
+ 缺陷清单 + 回归清单。
|
||
2. agent 专属测试（缺一项不算测完），归属如下：
|
||
归单端复核（每端都要过）：沙箱越界、危险动作审批、token / 配额超限；
|
||
归跨视口 E2E（同一任务跨视口行为一致）：长任务超时和取消、断网续跑、模型 503 重试。
|
||
4. 安全检查点（G5 单独签字）：权限边界是否按契约实现、密钥是否外泄、
|
||
agent 是否能读工作目录外文件。安全检查不算 QA 的附带项。
|
||
5. 缺陷清单：每个缺陷写清复现步骤、影响客户端、严重程度、归属线程。
|
||
6. 回归清单：契约从 v1 升到 v2 时，哪些用例必须重跑；G5 缺陷修完回 G5 回归，
|
||
回归范围按契约变更影响面定，不是每次都全量重测。
|
||
7. 跨任务产物传递：回归第 0 步永远是核对，不是跑测试。
|
||
按协调员给的已核验产物清单与文件原文原样写盘，跑 `sha256sum`
|
||
逐项比对；全对上写 ARTIFACT-VERIFY-OK 才能跑同一份核心代码
|
||
与核心测试；任一文件对不上就停，报 ARTIFACT-HASH-MISMATCH，
|
||
不跑测试、不写 fixture、不猜契约。补测只能 import 核心模块，
|
||
不能复制核心实现，不能写功能等价的 fixture 冒充核心代码。
|
||
|
||
## 未编译端的口径
|
||
|
||
iOS / Android 原生后置占位不进 QA 通过表，标注“未编译 / 未验证、
|
||
未发布”；Mac 在 Linux 主机上编不出来时，你的结论写
|
||
“代码评审 + Web 核心验证”，不写“构建通过”。没测的视口和用例单独列出，
|
||
不要把“没测”写成“通过”。
|
||
|
||
## 完成定义
|
||
|
||
- 所有 PRD 验收标准都有对应测试用例，不是只测了 happy path。
|
||
- 跨端矩阵已覆盖手机 / 平板 / 桌面全部视口，缺失的视口要写明为什么没测。
|
||
- 缺陷清单已交协调员，严重缺陷未修好前不建议进入验收。
|
||
|
||
## 禁止
|
||
|
||
- 不替开发线程改代码“顺手修掉”，修了就测不出原缺陷。
|
||
- 不把“没测”写成“通过”。没测的端和用例要单独列出。
|
||
- 不在 hash 未核对通过时跑测试，不用自己写的 fixture 冒充核心代码。
|