| name | journey-test-assistant |
| source | ../../../../skills/journey-test-assistant/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-07-09T00:00:00.000Z" |
| source_hash | 9230eb251afd |
| status | current |
| scope | partial |
| description | [UDS] 从项目描述生成连贯的用户旅程测试计划（TESTPLAN）与 E2E 骨架。
|
| allowed-tools | Read, Write, Grep, Glob |
| argument-hint | [项目描述 | --analyze | --archetype A1|A2|A3] |
Journey Test Assistant | 旅程测试助手
从项目描述生成连贯的用户旅程测试计划（TESTPLAN-NNN.md）与对应的 E2E 骨架，让每个新项目从第一天起就拥有完整的测试旅程。
与 /e2e 的区别
| 维度 | /e2e | /journey-test |
|---|
| 组织单位 | 单一 XSPEC/AC | 跨 Story 的用户旅程 |
| 测试结构 | 隔离、独立 | 连贯、状态共享 |
| 产物 | *.spec.ts 骨架 | TESTPLAN.md + *.journey.spec.ts |
| 触发时机 | 功能完成后 | 项目创建时（Journey-First） |
| 检测目标 | 单一 AC 是否正确 | 跨步骤状态传递是否连贯 |
工作流程
输入：项目描述 / 现有 TESTPLAN / --analyze
↓
Phase 1：定义 Persona
分析项目描述 → 识别所有用户角色 → 定义 Actor/Role/Key Permissions
↓
Phase 2：设计旅程地图
列出主要业务目标 → 拆解为 T-NNN 分组 → 声明依赖链
↓
Phase 3：生成 TESTPLAN
按格式输出 test-plans/TESTPLAN-001.md（含 Personas、步骤、依赖图）
↓
Phase 4：生成 E2E 骨架
从 TESTPLAN T-NNN 生成 *.journey.spec.ts（含 skipIf + 共享 state）
模式
1. 生成模式（默认）
从项目描述生成完整的 TESTPLAN + E2E 骨架。
/journey-test "电商平台，需要 buyer/seller/admin 三个角色"
产物：
test-plans/TESTPLAN-001.md：含 Personas、T-000 环境重置、T-001~T-NNN 步骤分组、执行顺序依赖图src/e2e/journey/main-flow.journey.spec.ts：含 describe.skipIf + 共享 state + T-NNN 对应的完整骨架
2. 分析模式（--analyze）
扫描现有测试，找出旅程覆盖缺口。
/journey-test --analyze
执行步骤：
- 读取
test-plans/TESTPLAN-NNN.md（若存在）
- 扫描
src/e2e/ 下所有 *.journey.spec.ts 和 *.journey.e2e.test.ts
- 比对 TESTPLAN T-NNN 与自动化测试中的 T-NNN 引用
- 输出 Coverage gap 报告：列出 TESTPLAN 中缺乏自动化对应的 T-NNN 步骤
3. Archetype 模式（--archetype）
使用预设旅程模板，适合已知类型的项目快速启动。
/journey-test --archetype A1 # Spec-driven 旅程
/journey-test --archetype A2 # UI-driven 旅程
/journey-test --archetype A3 # Brownfield 旅程
| Archetype | 模板 | 适用场景 |
|---|
| A1 | Spec-driven | 需求 → Spec → Code → Test，适合 API/Backend 项目 |
|
