journey-test-assistant

[UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from project description.

Repository: AsiaOstrich/universal-dev-standards
Last source activity: May 28, 2026 at 01:35
Detected SKILL.md language: Chinese
Stars: 70
Forks: 13

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

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-assistant

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

orchestrate

[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, 编排, 执行计划, 并行.

2026-07-20

plan

[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.

2026-07-20

push

[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, 推送, 保护分支, 质量门禁.

2026-07-20

View all from this repository

輸入：專案描述 / 現有 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）

/journey-test "電商平台，需要 buyer/seller/admin 三個角色"

/journey-test --analyze

/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-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

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 failed: login should return 200").toBe(200)
    const data = await res.json()
    expect(data.token, "T-001 failed: token should be present").toBeTruthy()
    authToken = data.token  // ← 傳遞給後續步驟
  })

  it("T-010: 執行主要操作（depends on T-001）", async () => {
    // 如果 T-001 失敗，authToken 為 undefined，此步驟的錯誤訊息會清楚說明
    expect(authToken, "T-010 precondition failed: authToken from T-001 is missing").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 failed: expected 201, got ${res.status}`).toBe(201)
    const data = await res.json()
    resourceId = data.id  // ← 傳遞給後續步驟
  })
})

name	journey-test-assistant
scope	partial
description	[UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from project description.
allowed-tools	Read, Write, Grep, Glob
argument-hint	[project description \| --analyze \| --archetype A1\|A2\|A3]
status	stable

維度	/e2e	/journey-test
組織單位	單一 XSPEC/AC	跨 Story 的使用者旅程
測試結構	隔離、獨立	連貫、狀態共享
產物	`*.spec.ts` 骨架	`TESTPLAN.md` + `*.journey.spec.ts`
觸發時機

name	journey-test-assistant
scope	partial
description	[UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from project description.
allowed-tools	Read, Write, Grep, Glob
argument-hint	[project description \| --analyze \| --archetype A1\|A2\|A3]
status	stable

維度	/e2e	/journey-test
組織單位	單一 XSPEC/AC	跨 Story 的使用者旅程
測試結構	隔離、獨立	連貫、狀態共享
產物	`*.spec.ts` 骨架	`TESTPLAN.md` + `*.journey.spec.ts`
觸發時機

journey-test-assistant

Install options

Review the source files