Menu
[UDS] 從專案描述生成連貫使用者旅程測試計畫（TESTPLAN）與 E2E 骨架
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill journey-test-assistantThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
Showing SKILL.md
| 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 骨架，讓每個新專案從第一天起就擁有完整測試旅程。
| 需求 | 使用 |
|---|---|
| 單元測試 / 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 | /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）
從專案描述生成完整的 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 對應的完整骨架
describe.skipIf掃描現有測試，找出旅程覆蓋缺口。
/journey-test --analyze
執行步驟：
test-plans/TESTPLAN-NNN.md（若存在）src/e2e/ 下所有 *.journey.spec.ts 與 *.journey.e2e.test.ts使用預設旅程模板，適合已知類型的專案快速啟動。
/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 專案 |
| A2 | UI-driven | 設計稿 → UI → 視覺回歸，適合前端 / 全端專案 |
| A3 | Brownfield | 現有程式碼 → 分析 → 重構驗證，適合既有專案補測試 |
以下為完整的 TESTPLAN 範本，展示所有必要區段：
# TESTPLAN-001 <ProjectName> 主線旅程
## Personas
| Actor | Role | Key Permissions |
|----------------|----------------|--------------------------------|
| platform_admin | Platform Admin | 建立 Org、管理使用者、查看所有資源 |
| org_member | Org Member | 讀取專案、執行 Pipeline |
## Environment
- BASE_URL：`http://localhost:3000`（本機） / `$JOURNEY_BASE_URL`（CI）
- 驗證指令：`curl $BASE_URL/health`
- 必要帳號：`ADMIN_EMAIL`、`ADMIN_PASSWORD` 環境變數
## T-000 環境重置（optional）
前置條件：無
depends_on：無
| 步驟 | 操作 | 預期結果 |
|---------|-------------------------------|---------------|
| T-000-1 | [API] GET /health | 回傳 200 OK |
| T-000-2 | [CHECK] 資料庫連線正常 | 無錯誤日誌 |
## T-001 Platform Admin 登入
前置條件：環境正常運行（T-000 通過）
depends_on：T-000
| 步驟 | 操作 | 預期結果 |
|---------|--------------------------------------------|-------------------------|
| T-001-1 | [API] POST /api/auth/login（admin 帳號） | 回傳 200 + authToken |
| T-001-2 | [CHECK] authToken 存入共享 state | let authToken 有值 |
## T-010 主要功能操作
前置條件：authToken 已取得（T-001 通過）
depends_on：T-001
| 步驟 | 操作 | 預期結果 |
|---------|--------------------------------------------|-------------------------|
| T-010-1 | [API] POST /api/resources（帶 authToken） | 回傳 201 + resourceId ★ |
| T-010-2 | [CHECK] resourceId 存入共享 state | let resourceId 有值 |
## 執行順序依賴圖
T-000 → T-001 → T-010
生成的骨架展示三個核心模式：describe.skipIf 環境保護、共享 let 狀態、T-NNN 識別碼對應。
import { describe, it, expect } from "vitest"
// Journey E2E：需要真實後端，不設定 JOURNEY_BASE_URL 則全部 skip
const BASE_URL = process.env.JOURNEY_BASE_URL || ""
describe.skipIf(!BASE_URL)("Platform Admin Journey — T-001 → T-010", () => {
// 共享 state：每個步驟從前一步驟的結果取值
let authToken: string
let resourceId: string
it("T-001: Platform Admin 登入並取得 authToken", async () => {
const res = await fetch(`${BASE_URL}/api/auth/login`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
email: process.env.ADMIN_EMAIL,
password: process.env.ADMIN_PASSWORD,
}),
})
expect(res.status, "T-001 失敗：登入應回傳 200").toBe(200)
const data = await res.json()
expect(data.token, "T-001 失敗：應有 token").toBeTruthy()
authToken = data.token // ← 傳遞給後續步驟
})
it("T-010: 執行主要操作（depends on T-001）", async () => {
// 若 T-001 失敗，authToken 為 undefined，此步驟的錯誤訊息會清楚說明
expect(authToken, "T-010 前置失敗：T-001 的 authToken 不存在").toBeTruthy()
const res = await fetch(`${BASE_URL}/api/resources`, {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${authToken}`,
},
body: JSON.stringify({ name: "journey-test-resource" }),
})
expect(res.status, `T-010 失敗：預期 201，實際 ${res.status}`).toBe(201)
const data = await res.json()
resourceId = data.id // ← 傳遞給後續步驟
})
})
完成後建議：
TESTPLAN 與 Journey E2E 骨架已生成。建議下一步：
- 執行
/e2e生成各功能的 AC 層測試（補充旅程測試的細節覆蓋）- 執行
/atdd定義各 T-NNN 步驟對應的驗收條件- 執行
/journey-test --analyze定期檢查自動化覆蓋缺口
/e2e（AC 層測試）、/atdd（驗收條件定義）Based on SOC occupation classification