User Story · 使用者故事

---
doc_type: "user-story"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["prd", "persona"]
  optional: ["jtbd", "story-naming-conventions"]
---

# User Stories: <epic-or-batch-name>

**Status:** Draft v0.X · **Owner:** <PO name> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 5 段（編號 1, 2, 3, 10, 12），全部必填——刻意沿用完整版章節編號讓兩版可對照。每個 story 必含 **persona + action + benefit 三段**；無動機 story（「As a user, I want a button」）= 直接 reject。每個 story 必通過 INVEST 6 項自檢，fail 項標 reason。Story point 用 Fibonacci，> 8 點必須建議拆分。每結論 `（依據：PRD §X / persona §Y / JTBD-NNN）`；缺資料寫 `_TODO: 需要 XXX_` 不編造。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行：本批 story 數、總點數、是否進得了當前 sprint、最高風險的 INVEST fail -->

<3-5 行說明>

> **TL;DR:** <一句話：本批多少 story、總多少點、能否一個 sprint 吃完>

---

## 2. Stories

<!-- ai-rule: 每個 story 含 statement (persona / action / benefit) + INVEST checklist + AC refs + 點數 + 依賴 -->

### US-1 · **3 pts** · **[H]**

> **As a** <persona>,
> **I want to** <action>,
> **so that** <benefit>.

- **INVEST:** Independent YES · Negotiable YES · Valuable YES · Estimable YES · Small YES · Testable YES
- **Acceptance criteria refs:** AC-001, AC-002 (Given/When/Then 詳見 acceptance-criteria 卡)
- **Dependencies:** blocked_by: — · blocks: US-2 · external: —
- **Source:** PRD §FR-1 + persona §primary

### US-2 · **5 pts** · **[M]**

> **As a** <persona>,
> **I want to** <action>,
> **so that** <benefit>.

- **INVEST:** Independent YES · Negotiable YES · Valuable YES · Estimable YES · Small [CAUTION] (近上限，5 pts) · Testable YES
- **Fail reasons:** —
- **AC refs:** AC-003, AC-004, AC-005
- **Dependencies:** blocked_by: US-1 · blocks: — · external: <auth-svc API>
- **Source:** PRD §FR-2

### US-3 · **8 pts** · **[L]** · [CAUTION] Consider split

> **As a** <persona>,
> **I want to** <action>,
> **so that** <benefit>.

- **INVEST:** Small NO — 8 pts 建議拆分為 US-3a (5 pts UI 流程) + US-3b (3 pts API 整合)
- **AC refs:** AC-006, AC-007
- **Dependencies:** ...
- **Source:** PRD §FR-3

---

## 3. Story Size & Capacity Fit

| Metric | Value |
|---|---|
| Total stories | 3 |
| Total points | 16 |
| Team velocity baseline (last 3 sprint avg) | 38 pts |
| Capacity fit | YES fits comfortably (< 50% capacity) |
| Suggested split | US-3 split before commit |

---

## 10. Decision Log（key 1-2 條）

<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected option + 拒絕原因 -->

| Date | Decision | Options | Chosen | Rejected why |
|---|---|---|---|---|
| YYYY-MM-DD | <例：US-A 拆兩 story 還是一個> | split / merge | split | merge (8 pts 估點不準、demo 點不清) |

---

## 12. Confidence & Sources & TODO

- **最低 confidence 項：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1，例：team velocity 38 pts 持平>
- **Highest-value next input:** <persona 訪談 / 過去 sprint velocity / UI mockup 三選一>

### TODO（缺資料）

- _TODO: 需要 UX mockup 校準 US-3 估點_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 5 段 H2 章節齊全（編號 1, 2, 3, 10, 12，刻意不連號）
> - [ ] 每個 story 含 persona / action / benefit 三段（無 "I want a button" 這類無動機句）
> - [ ] 每個 story 含 INVEST 6 項標記
> - [ ] 點數用 Fibonacci 1/2/3/5/8/13；> 8 必標 [CAUTION] 建議拆分
> - [ ] 每個 story 含 AC refs + dependencies + source
> - [ ] Total points 對齊 team velocity baseline
> - [ ] Decision Log ≥ 1 條，每條有 rejected reason
> - [ ] 無 YAML / JSON schema 輸出（story 是給人讀的 markdown）