Test Design(T1 测试设计 · 内容 + 落地)
定位
T1 唯一 skill:追溯 → 用例 → Confluence 全文 → 审核 →(👤 口令后)XMind/JIRA;并行 Apifox + 自动化规划。
不用于 T2/T3——T2 见 multica-test-t2-coverage;T3 见 -t3 + multica-test-orchestration。
| 层 | Skill | 职责 |
|---|---|---|
| 编排 | multica-test-orchestration |
跨阶段路由;自动化入仓见 references/automation-assets-lifecycle.md |
| T1 | 本 skill | 内容 + Confluence + 口令后 XMind/JIRA |
| 平台 | multica-platform-* |
读上游;Apifox 写场景 |
| 审核 | multica-review-test |
审 Confluence;只审不 import |
三阶段交付:阶段 A 仅 Confluence(不生成 XMind);👤 口令后阶段 C 才 XMind + JIRA。详见
references/generation-workflow.md。
Platform 协作
| Platform skill | 本 skill 用途 |
|---|---|
multica-platform-jira |
fetch_all → get_issue.py;口令后 import_to_tracker.py(团队自备,见 references/import-contract.md) |
multica-platform-confluence |
采集 fetch_page;发布 t1-cases.md(见 § Confluence 落地) |
multica-platform-figma |
fetch_all → fetch_file.py |
multica-platform-apifox |
T1 并行写接口场景 |
| 团队知识库(可选) | Step 0.5 术语/入口(用法二分;本仓库未随附,按所用平台接入) |
凭据:JIRA_USERNAME / JIRA_PASSWORD 优先 → 见 platform skill + data-sources.md。
references/ 索引
| 文件 | 用途 |
|---|---|
generation-workflow.md |
两阶段、口令、测试管理平台 命名/校验、步骤/优先级、去重/合并 |
executability-and-permissions.md |
权限识别顺序、双目标、模块命名、生成后自检 |
output-format.md |
JSON 1:1、generated_summary、覆盖自查表、Output Delivery |
multimodal-content.md |
HTML/图片 Read 与融合理解 |
agent-instructions.md |
可复制 Agent 指令 |
design-trace.md |
AC ↔ 设计追溯 |
test-case-template.md |
功能用例字段 |
coverage-dimensions.md |
维度选择、规模缩放、覆盖矩阵、XMind |
coverage-checklist.md |
生成前自检清单 |
web-ui-checkpoints.md |
Figma → UI 测试点 |
api-testing-guide.md |
接口场景模式 |
data-sources.md |
采集编排与凭据 |
T1 流程
Step 0 — 读 MULTICA.md(自动化路径)
Issue 仓库矩阵 → 每个 repo Read 根目录 MULTICA.md §2(分仓各一份;同仓一份须完整)。缺则 BLOCKED。
Step 0.5 — 知识库(Step 0.5)
团队知识库问答脚本(可选接入)→ --health + 问答。用法二分:操作桶进步骤,规则桶不当 AC。见 generation-workflow.md。
Step 1 — 设计追溯
design-trace.md → 追溯表写入覆盖报告。
Step 2 — 采集
python scripts/fetch_all.py --jira-url "http://jira.../browse/PROJ-123" -o ./data
多模态:multimodal-content.md。
Step 3–4 — 用例 + 自检
按 test-case-template.md + generation-workflow.md + output-format.md → 本地 JSON(工作文件);coverage-checklist.md 自检。不写 XMind。
Step 5 — 阶段 A:Confluence + Apifox 并行
- 将 完整用例正文 写入
docs/test/<ISSUE-KEY>/t1-cases.md(模板见 platform-confluencetest-t1-template.md) - Confluence 落地(见下 §)→ 回传链接
- API 契约就绪 →
multica-platform-apifox按契约补场景(AI 分支;写 manifest 规划节) - →
multica-review-test(审 Confluence) - 交付语:
状态:待人工审核(Confluence 已更新,未 XMind/未导入 JIRA)
Step 6 — 阶段 C:XMind + JIRA(👤 明确口令后)
generate_xmind.py← 最新 JSON(与 Confluence 一致)import_to_tracker.py(团队自备,接口见references/import-contract.md)- republish Confluence 状态「已导入 JIRA」+ 用例集链接
Confluence 落地(T1 · 主副本)
父页面:JIRA Issue Hub(PRD 需求页)子页面。
本地草稿:docs/test/<ISSUE-KEY>/t1-cases.md
基线:multica-platform-confluence/scripts/templates/test-t1-template.md
须含 每条 CASE 步骤/预期正文、Apifox 节、UI e2e 规划(路径写 MULTICA.md §2,非硬编码)。T1/T2 不生成 XMind。
发布:
python multica-platform-confluence/scripts/publish_design.py \
<ISSUE-KEY> docs/test/<ISSUE-KEY>/t1-cases.md \
--append-jira --json
JIRA 块:h3. T1 测试用例 (Test Cases T1)。
Apifox(T1 并行)
契约发布后:读 API 契约 → multica-platform-apifox 补场景(AI 分支)→ Confluence 记录 branch/scenario → manifest 路径见 MULTICA.md §2。
Files
multica-test-t1-design/
├── SKILL.md
├── config.local.env.example
├── references/
└── scripts/
为什么有效
T1 内容与脚本合一;generation-workflow + output-format 保留原版 generator 硬规则;platform 统一采集 REST。