先決定你現在是要學，還是要在專案裡做
網站負責解釋與分發工作包；真正的 Repository 掃描、缺口判斷與文件產出交給 Coding Agent。
SDLC 實作課 · 交付物練習
先理解這份文件替你消除什麼不確定
用一張表決定『要測什麼、不測什麼、誰簽』
QA 在 release 前最大的成本不是執行測試，是搞清楚「這次到底要不要測它」。Test Plan 是與 PM/Dev 對焦範疇、層級、退場條件的合約。
誰負責、交給誰
主責： QA Lead
協作： PM/PO 確認 acceptance、Dev 提供變更面、SRE 提供風險面
下游收件： Test cases、Release Gate、Go/No-Go
何時值得做
必要時機： Release 含 schema migration、外部介面變更、合規審查
不需要時： flag 控制的小改動、純文案
常見誤用： 抄上一版只改日期；exit criteria 寫「全部通過」
- 01讀大綱
- 02比範本
- 03填素材
- 04貼提示詞
- 05對照驗收
Anatomy · 文件解剖
輕量版先回答 6 個核心章節
章節名稱可以因團隊調整，但每一段要求的判斷不能被省略。先讀問題，再看格式。
- 01
Executive Summary
範本必要章節
3-5 行，PM/Dev/QA 30 秒讀完。內容：scope in/out、五層覆蓋狀況、最高風險區、預估執行時程
- 02
Scope
範本必要章節
in / out 兩列必填，out 必須附 rationale
- 03
Test Levels（at least 3 layers）
範本必要章節
輕量版至少覆蓋 unit + integration + e2e 三層，perf/security 可標 N/A 但要寫 rationale
- 06
Traceability to AC
範本必要章節
每條 AC 必對應 ≥ 1 個 test case；無對應者標 _TODO_ + 原因
- 09
Risks（top 3）
範本必要章節
每條格式：失效模式 + Mitigation + Owner 三件齊
- 12
Confidence & Sources & TODO
範本必要章節
把已確認的內容、判斷依據與仍待補充的資訊清楚分開。
Study · 對照學習
同一份交付物，先練核心，再看完整深度
輕量範本適合第一次練習與 MVP；完整範本保留跨職能交棒需要的細節。兩者都要求未知事項保持可見。
這張卡目前提供已審定的輕量與完整範本；不以 AI 臨時生成的內容冒充實際案例。
30 分鐘內先完成核心章節。
---
doc_type: "test-plan"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
required: ["prd", "change-list"]
optional: ["slo-definition"]
---
# Test Plan: <release-or-feature-name>
**Status:** Draft v0.X · **Owner:** <QA Lead> · **Last updated:** YYYY-MM-DD
> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 6, 9, 12），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：AC-NN / change §X / SLO §Y）`；每量化欄位帶 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；**每條 AC 必須對應 ≥ 1 個 test case**，無對應者標 TODO；exit criteria 禁寫「全部通過」這種空話。
---
## 1. Executive Summary
<!-- ai-fill: 3-5 行，PM/Dev/QA 30 秒讀完。內容：scope in/out、五層覆蓋狀況、最高風險區、預估執行時程 -->
<3-5 行說明>
> **TL;DR:** <一句話：這個 release 要測什麼、不測什麼、誰簽>
---
## 2. Scope
<!-- ai-rule: in / out 兩列必填，out 必須附 rationale -->
### In scope
- <feature / module 1>
- <feature / module 2>
### Out of scope
- [NO] <thing 1> — Rationale: <why out>
- [NO] <thing 2> — Rationale: ...
- [NO] <thing 3> — Rationale: ...
---
## 3. Test Levels（at least 3 layers）
<!-- ai-rule: 輕量版至少覆蓋 unit + integration + e2e 三層，perf/security 可標 N/A 但要寫 rationale -->
| Level | Owner | Coverage target / scope | Confidence |
|---|---|---|---|
| **Unit** | Dev | <line/branch %> | **[H]** |
| **Integration** | QA + Dev | <contracts list> | **[H]** |
| **E2E** | QA | <critical journeys> | **[M]** |
| **Perf** | N/A | <rationale: 無 perf 敏感變更> | **[H]** |
| **Security** | QA + Security | <若 N/A，rationale> | **[M]** |
---
## 6. Traceability to AC
<!-- ai-rule: 每條 AC 必對應 ≥ 1 個 test case；無對應者標 _TODO_ + 原因 -->
| AC ID | Covered by | Level | Confidence |
|---|---|---|---|
| AC-01 | TC-101, TC-102 | integration | **[H]** |
| AC-07 | _TODO: 尚未設計_ | — | **[L]** |
---
## 9. Risks（top 3）
<!-- ai-rule: 每條格式：失效模式 + Mitigation + Owner 三件齊 -->
> **R1:** <風險描述> — **Mitigation:** <如何降低> — **Owner:** <誰負責>
>
> **R2:** ...
>
> **R3:** ...
---
## 12. Confidence & Sources & TODO
- **整份 plan 最低 confidence 項：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
- <假設 1>
- **Highest-value next input:** <下一份最該補的 production traffic profile / 合規條文>
### TODO（缺資料）
- _TODO: 需要 staging 環境是否有 PII mask 確認_
---
> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 6, 9, 12，刻意不連號）
> - [ ] Scope in/out 兩列齊，out 必附 rationale
> - [ ] Test Levels 至少 3 層，N/A 須寫原因
> - [ ] 每條 AC 對應 ≥ 1 個 test case 或標 _TODO_
> - [ ] Risks 每條格式：失效模式 + Mitigation + Owner
> - [ ] 無 YAML / JSON schema 輸出（plan 是給人讀的 markdown）Practice · 換你試做
先用自己的話交代素材，不需要先學會工程術語
確定的就寫，不確定的留白。下一步要做的是請 Agent 找缺口，不是讓它替你猜一套合理答案。
可以先留白；複製提示詞後再到 Coding Agent 裡補充。
AI Practice · 手動三步
先問、再寫、最後審，不把整條流程鎖死
每一步都是獨立工作包。你可以停下補資料、修改限制或重做某一步，不需要服從固定的 Agent 接力流程。
只找阻擋文件成立的未知
先補會改變範圍、判斷或驗收結果的資訊，不急著寫文件。
我要製作「Test Plan · 測試計畫」。先不要產出文件。
請根據我的素材，找出會影響這份文件正確性或可執行性的未知事項，一次最多問 5 題。
每題請包含：
1. 問題
2. 為什麼現在必須知道
3. 它會影響哪個章節或決定
已經回答的事不要重問；可以延後的事標成「待決策」；不要替我猜答案。
本文件的核心章節：Executive Summary、Scope、Test Levels（at least 3 layers）、Traceability to AC、Risks（top 3）、Confidence & Sources & TODO複製後，請在標示位置貼上自己的素材。
Review · 自己驗收
文件存在，不代表下一個角色真的能使用
逐條檢查 Agent 的輸出。人類負責需求、限制與驗收，也必須能說明重要結論從哪裡來。
帶著這份文件，繼續到「Feature Flag · 功能旗標」
下一張卡會接住新的決策問題；不用一次把整條 SDLC 全做完。