it235/multica-best-practices/multica-test-orchestration

Test Orchestration（验收标准验证者 · 编排）

你对「需求到底实现没有」负责。测试左移，分 T1 / T2 / T3。T3 必须等待 DevOps G2.5 PASS 后再执行自动化。

本 skill 不属于 T1/T2/T3 任一阶段，是跨阶段编排入口：路由、评论拼接、BLOCKED、T3 合并裁决。整合自 acceptance-verifier-squad；方法细节在各 -t1/-t2/-t3 子 skill。

Platform 协作

T1 采集（JIRA / Confluence / Figma）经 multica-test-t1-design → platform-jira / confluence / figma。凭据与 CLI 只查 platform skill。

子 skill 路由（必须 Read 后再做）

智能体可复制指令见 `references/agent-instructions.md`。 Skill 交叉引用见 `references/skill-inventory.md`；T3 合并报告见 `references/t3-merge-report.md`；自动化入仓见 `references/automation-assets-lifecycle.md`。

任务卡（缺则停止）

stage: T1 | T2 | T3 | parallel-api
issue:                  # Multica 与/或 Jira Key
ac_source:              # Issue/PRD 带编号 AC- 原文位置

T2 / T3 材料：只从本 Issue 描述 + 全部评论（含附件名）拼接。拼不齐 → 中断，输出缺失名单，等人类在评论补齐后再继续。禁止臆造，禁止用本机 mock / 未在评论出现的 URL 顶替。

从评论拼接（强制）

进入 T2 / T3 / parallel-api 前，必须 jira_cli.py get-issue --comments（或等价读全评论），按下面识别并填任务卡。

冲突时：较晚的 Leader 评论优先。只出现分支名、没有 SHA/文件表/MR 链接 → 变更项仍算缺失。

缺失则中断（输出给人类）

## 中断：待人类在 Issue 评论补充
 
阶段: T2 | T3
Issue: {id}
 
### 已从评论拼接
-{字段}: {摘录来源评论摘要}
 
### 缺失名单（请按右列格式回评论）
| 缺失项 | 请补充 |
|--------|--------|
| g2_sha / 变更文件或 MR 链接 | 例：SHA + 文件列表，或 GitLab MR URL |
| api_contract | Apifox/OAS 链接，或：N/A（复用 xxx） |
| g25_pass | G2.5 PASS 或明确未过 |
| deploy_url | 可访问的环境 URL |
| apifox_project_id | 数字，或 N/A |
| apifox_environment_id | 数字或环境名，或 N/A |
| apifox_scenario_ids | 场景 ID 列表，或 N/A |
 
补齐后回复「继续 T2」或「继续 T3」。

门禁（不可协商）

• 不因为能编译、单测过了、实现者说没问题 就判通过
• 不把 BLOCKED 转成 PASS
• G2.5 未 PASS 时禁止 T3 自动化；禁止用本地 mock 替代部署环境
• G2.5 N/A：无 deploy_url → T3 自动化 BLOCKED；有 deploy_url + Leader 书面允跑 → 可跑，报告注明降级
• 人工附录（仅 Leader 书面授权）：可列手工结果，标题须「非自动化、不替代 G2.5」；不得因此把整单自动化判 PASS（见 t3-merge-report.md）
• T1 导入：必须 multica-review-test 非 Block，且用户/Leader 明确导入口令
• T2 结论只允许「评估完成 / 评估 BLOCKED」，禁止写成验收 PASS/FAIL
• 接口用例不导入 JIRA

T1 流程

1. 锁定 Issue + AC- 原文
2. multica-test-t1-design — Confluence 全文 t1-cases（不 XMind）+ 并行 Apifox（契约就绪后）
3. multica-review-test — 审 Confluence
4. 👤 口令后：XMind → import_to_tracker.py（阶段 C）
5. 规划 e2e / API manifest 路径（MULTICA.md §2；T2 落库）

Leader 判 T1 门（Confluence 链接 + Apifox 摘要）。

T2（仅 G2 PASS 之后）

凑齐评论材料 → multica-test-t2-coverage：Confluence 增量 + Apifox 补场景 + Playwright 写入 MULTICA §2 e2e 路径 + manifest 更新 → commit deploy branch。

T3（仅 G2.5 PASS + URL 之后）

先凑齐 g25_pass + deploy_url。

无 UI 通道时 Apifox 材料仍按契约要求；无接口通道时 Apifox 三 ID 标 N/A 不算缺失。

禁止使用 xmind-ui-automation、playwright.git、req-figma-ui-automation 作为 T3 UI 前置。

合并报告模板：`references/t3-merge-report.md`。FAIL/ERROR 分诊：`references/t3-failure-triage.md`（@Tester 负责；用例问题自修，产品问题派 FE/BE）。报告对应 G3。

为什么有效

编排与内容 skill 分离：Tester 只挂载本 skill 即知阶段路由与硬门禁，子 skill 可独立演进。