| name | journey-test-assistant |
| source | ../../../../skills/journey-test-assistant/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-05-28T00:00:00.000Z" |
| scope | partial |
| description | [UDS] 從專案描述生成連貫使用者旅程測試計畫（TESTPLAN）與 E2E 骨架 |
| allowed-tools | Read, Write, Grep, Glob |
| argument-hint | [專案描述 | --analyze | --archetype A1|A2|A3] |
| status | stable |
旅程測試助手
語言: English | 繁體中文
從專案描述生成連貫的使用者旅程測試計畫（TESTPLAN-NNN.md）與對應的 E2E 骨架，讓每個新專案從第一天起就擁有完整測試旅程。
選擇正確的測試 Skill
| 需求 | 使用 |
|---|
| 單元測試 / TDD 紅綠重構 | /tdd-assistant |
| BDD 場景 / Given-When-Then | /bdd-assistant |
| 驗收測試 / ATDD / 使用者故事 | /atdd-assistant |
| E2E / Playwright / 瀏覽器測試 | /e2e-assistant |
| 合約測試 / API consumer-driven | /contract-test-assistant |
| 測試覆蓋率差距分析 | /test-coverage-assistant |
| 使用者旅程測試計畫 | /journey-test-assistant |
| 一般測試策略 / 測試金字塔 | /testing-guide |
與 /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：含 + 共享 state + T-NNN 對應的完整骨架
