在测试 sidebar 落用例

如果你是 QA，测试 sidebar 是你的主战场。2 件文档 + L1-L4 分层，把 PD 的 ACC 落成可执行测试。

你要起草的 2 件文档

文档	写什么	不要写
`test-cases.md`	怎么测（步骤 / 预期）	验收标准重述 / 实测结果
`test-evidence.md`	实际跑了什么、结果如何（§5 才回填）	用例步骤重述 / 改写标准

test-cases 怎么写

每条 TC 必须引用至少一条 PD ACC：

- id: TC-007
  title: 单张满减券生效
  satisfies: [ACC-012, ACC-013]
  type: api          # api / browser
  layer: L2          # L1 / L2 / L3
  steps:
    - 创建购物车,总价 200
    - 用户领取"满 100 减 20"券
    - 调 POST /api/cart/apply-coupon
  expected:
    - HTTP 200
    - response.total = 180
    - response.discounts[0].coupon_id 已记录

trace Validator 守门：TC 引用的 ACC 必须存在。

起草技巧：让 AI 替你推

PD 的 acceptance 写完后，调 /aiko-pd-to-test：

> /aiko-pd-to-test add-coupon-discount

读取 add-coupon-discount-pd/acceptance.md
✓ test-cases.md  (18 条 TC-* 覆盖全部 ACC-*)
  ├─ L1 单测项: 5 条 (走 dev §2 TDD)
  ├─ L2 API E2E: 10 条
  └─ L2 Browser E2E: 3 条

每条 ACC 至少拆出 1 条 TC，你 review 后调整。

L1-L4 是什么、你什么时候管

层	防什么	你什么时候关心
L1 单测	单 API / 单规则	开发本地 §2 阶段，开发自己跑
L2 本 change E2E	ACC 链路	你最关心的层 —— feature 合 develop 前必须全过
L3 集成回归	多 feature 合完后	develop / release CI，你看报告
L4 正式发布证据	release 签收	你回填 evidence，正式签字

E2E 怎么落地：§3 / §4 自动跑

你不用手写 E2E 脚本。开发包跑 aiko.pipeline 到 e2e_gen / e2e_run 时：

[§3 e2e_gen]
  Aiko Chat 读你的 test-cases.md TC-007
    ↓
  自动生成 tests/e2e/coupon_basic.spec.ts
  (Playwright / pytest / 团队约定的 E2E 框架)

[§4 e2e_run]
  跑 npm run test:e2e -- --grep "TC-007|TC-008"
    ↓
  L2 gate: 本 group 全部 TC 必须 pass
    ↓
  fail → pipeline-gate ERROR,开发不能 advance 到 evidence

你的职责是：test-cases 写得足够清晰，AI 才能照着生成。

你能控制 AI 生成的 E2E 脚本风格

在 test-cases.md 里加 hint：

- id: TC-007
  title: 单张满减券生效
  satisfies: [ACC-012]
  framework: playwright    # 强制用 playwright
  fixtures:
    - login_as_consumer
    - seed_coupon: "满 100 减 20"
  steps: [...]

§5 回填 evidence

开发跑通 §4 后，由 Aiko Chat 帮你（或你手动）回填 test-evidence.md：

- id: EV-007
  for: TC-007
  status: pass             # pass / fail / blocked
  layer: L2
  ran_at: 2026-05-22T14:30:00Z
  ci_link: https://gitlab.example.com/jobs/123456
  artifacts:
    - screenshot: ./reports/tc-007-step3.png
    - report: ./reports/tc-007.json
  notes: 首次跑过,无 flaky

不同分支阶段要求不同：

分支阶段	evidence 要求
feature	可以 draft（PoC 验过即可）
release → main	必须 measured + status=pass（L4 正式签收）

写完之后

./scripts/aiko-validate.sh

test 包跑通后，开发可以拉 feature 分支了。

关联

PD sidebar — 上游 acceptance
开发 sidebar — §3 / §4 阶段开发那边跑
推进开发任务到 ready — L1-L4 详细
校验报错了怎么办

在测试 sidebar 落用例

On this page