journey-test-assistant

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

执行步骤：

1. 读取 test-plans/TESTPLAN-NNN.md（若存在）
2. 扫描 src/e2e/ 下所有 *.journey.spec.ts 和 *.journey.e2e.test.ts
3. 比对 TESTPLAN T-NNN 与自动化测试中的 T-NNN 引用
4. 输出 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 项目