先決定你現在是要學,還是要在專案裡做
網站負責解釋與分發工作包;真正的 Repository 掃描、缺口判斷與文件產出交給 Coding Agent。
SDLC 實作課 · 交付物練習
先理解這份文件替你消除什麼不確定
用使用者語言確認『這真的是我們要的』
QA 驗的是「功能對不對」,UAT 驗的是「業務拿到能不能用」。兩者證據不可互相替代,否則上線後才發現流程斷裂。
誰負責、交給誰
主責: QA + PO 協調,業務單位執行
協作: UX 提供 journey、Dev 修缺陷
下游收件: Go/No-Go、release notes 中的已知限制
何時值得做
必要時機: 對外產品、合約交付、跨部門流程
不需要時: 內部技術重構、不影響使用者行為的優化
常見誤用: UAT 變成第二輪 QA;情境腳本沒對齊真實業務
- 01讀大綱
- 02比範本
- 03填素材
- 04貼提示詞
- 05對照驗收
Anatomy · 文件解剖
輕量版先回答 6 個核心章節
章節名稱可以因團隊調整,但每一段要求的判斷不能被省略。先讀問題,再看格式。
- 01
Executive Summary
範本必要章節
3-5 行,業務主管 30 秒讀完。寫「驗收 N 個 scenario、預估 X 天、最大 risk」
- 02
Scenarios
範本必要章節
3-5 個 P0 scenario 為宜。每個含 persona / precondition / steps(≤ 7)/ expected / priority
- 03
Data Setup
範本必要章節
三件齊全(test_accounts / seed_data / environment)
- 05
Defect Severity Matrix
範本必要章節
至少 3 級(S1 / S2 / S3);S1 必含核心流程無法完成的定義
- 07
Sign-off Authority
範本必要章節
primary + signature_method 必填
- 10
Decision Log(key 1-2 條)
範本必要章節
每條必含 chosen + 至少 1 個 rejected option + 拒絕原因
Study · 對照學習
同一份交付物,先練核心,再看完整深度
輕量範本適合第一次練習與 MVP;完整範本保留跨職能交棒需要的細節。兩者都要求未知事項保持可見。
這張卡目前提供已審定的輕量與完整範本;不以 AI 臨時生成的內容冒充實際案例。
30 分鐘內先完成核心章節。
---
doc_type: "uat"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
required: ["prd", "user-journey"]
optional: ["business-rules"]
---
# UAT Plan: <feature-name>
**Status:** Draft v0.X · **Owner:** <QA + PO> · **Last updated:** YYYY-MM-DD
> [!IMPORTANT]
> **AI 填寫規則:** 本範本 6 段(編號 1, 2, 3, 5, 7, 10),全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `(依據:prd §XXX / journey §YYY)`;每量化欄位加 `[H]/[M]/[L]` confidence badge;scenario 步驟必須用業務語言(不出現 API / endpoint / payload 等技術詞);每個 P0 acceptance criterion 都要有對應 scenario。
---
## 1. Executive Summary
<!-- ai-fill: 3-5 行,業務主管 30 秒讀完。寫「驗收 N 個 scenario、預估 X 天、最大 risk」 -->
<3-5 行說明>
> **TL;DR:** <一句話:驗收什麼 + 誰簽 + 何時完成>
---
## 2. Scenarios
<!-- ai-rule: 3-5 個 P0 scenario 為宜。每個含 persona / precondition / steps(≤ 7)/ expected / priority -->
### UAT-001: <業務情境一句話>
- **Persona:** <對應 journey persona>
- **Priority:** **P0** · **Confidence:** **[H]**
- **Precondition:**
- <state 1>
- <state 2>
- **Steps(用業務語言):**
1. <step 1>
2. <step 2>
3. <step 3>
- **Expected:** <業務可判斷的結果>
- **Sign-off:** [ ] Pass / [ ] Fail — Tester: ___ Date: ___
- **Source:** prd §FR-1 + journey §stage-2
### UAT-002 / UAT-003
<同格式>
---
## 3. Data Setup
<!-- ai-rule: 三件齊全(test_accounts / seed_data / environment) -->
| Item | Spec |
|---|---|
| Test accounts | <role + permission level> |
| Seed data | <dataset + 來源> |
| Environment | UAT URL: <URL> |
| Reset strategy | <how to reset between runs> |
---
## 5. Defect Severity Matrix
<!-- ai-rule: 至少 3 級(S1 / S2 / S3);S1 必含核心流程無法完成的定義 -->
| Severity | Definition | SLA hours | Escalation |
|---|---|---|---|
| S1 (blocker) | 核心流程無法完成 | 4h | → Dev Lead → PO |
| S2 (major) | workaround 存在但成本高 | 24h | → Dev Lead |
| S3 (minor) | UI / 文案 / 邊緣情境 | 72h | → Dev |
---
## 7. Sign-off Authority
<!-- ai-rule: primary + signature_method 必填 -->
- **Primary signer:** <role + name>
- **Quorum:** 1(或 N,視情境)
- **Signature method:** e-sign / 會議紀錄 / Slack thread emoji
---
## 10. Decision Log(key 1-2 條)
<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected option + 拒絕原因 -->
| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | scenario 粒度 | 端到端 vs 模組化 | 端到端 | 模組化 (與 QA test 重疊、不驗業務流程) | **[H]** |
---
> [!CAUTION]
> **輸出前 AI 自檢:**
> - [ ] 6 段 H2 章節齊全(編號 1, 2, 3, 5, 7, 10)
> - [ ] 每個 scenario 含 persona / precondition / steps(≤7)/ expected / sign-off
> - [ ] Scenario 步驟全用業務語言(無 API / endpoint / payload)
> - [ ] 每個 P0 acceptance criterion 有對應 scenario
> - [ ] Defect matrix 至少 S1 / S2 / S3 三級 + SLA + escalation
> - [ ] Sign-off authority 含 signer + signature_method
> - [ ] 無 YAML / JSON schema 輸出Practice · 換你試做
先用自己的話交代素材,不需要先學會工程術語
確定的就寫,不確定的留白。下一步要做的是請 Agent 找缺口,不是讓它替你猜一套合理答案。
可以先留白;複製提示詞後再到 Coding Agent 裡補充。
AI Practice · 手動三步
先問、再寫、最後審,不把整條流程鎖死
每一步都是獨立工作包。你可以停下補資料、修改限制或重做某一步,不需要服從固定的 Agent 接力流程。
只找阻擋文件成立的未知
先補會改變範圍、判斷或驗收結果的資訊,不急著寫文件。
我要製作「UAT · 使用者驗收測試」。先不要產出文件。
請根據我的素材,找出會影響這份文件正確性或可執行性的未知事項,一次最多問 5 題。
每題請包含:
1. 問題
2. 為什麼現在必須知道
3. 它會影響哪個章節或決定
已經回答的事不要重問;可以延後的事標成「待決策」;不要替我猜答案。
本文件的核心章節:Executive Summary、Scenarios、Data Setup、Defect Severity Matrix、Sign-off Authority、Decision Log(key 1-2 條)複製後,請在標示位置貼上自己的素材。
Review · 自己驗收
文件存在,不代表下一個角色真的能使用
逐條檢查 Agent 的輸出。人類負責需求、限制與驗收,也必須能說明重要結論從哪裡來。
帶著這份文件,繼續到「Go/No-Go Checklist · 上線檢查表」
下一張卡會接住新的決策問題;不用一次把整條 SDLC 全做完。
