Release Plan · 上線計畫 · 落地圖鑑

CHOOSE YOUR MODE

先決定你現在是要學，還是要在專案裡做

網站負責解釋與分發工作包；真正的 Repository 掃描、缺口判斷與文件產出交給 Coding Agent。

SDLC 實作課 · 交付物練習

先理解這份文件替你消除什麼不確定

把上線從『按 deploy』變成有對齊、有證據、有退路

Release Plan 是一份「誰在哪時做什麼、出事誰接、何時宣布完成」的協作文件。沒有它，每次上線靠 Slack 即興指揮。

OWNER & HANDOFF

誰負責、交給誰

主責： PO + DevOps

協作： Dev Lead、QA、SRE on-call、Customer Success

下游收件： Go/No-Go、Rollback Plan、Canary Strategy

WHEN TO USE

何時值得做

REQUIRED

必要時機： schema migration、breaking change、市場活動綁定

SKIP

不需要時： flag 控制的小改、純文案

CAUTION

常見誤用：只寫時程不寫退路；通知名單缺 on-call

看懂6 段骨架知道每段要留下哪一種判斷

看會SmartTrip 案例對照真實素材如何形成結論

做出自己的草稿手動貼到 Claude Code、Codex 或其他 Agent

01讀大綱
02看案例
03填素材
04貼提示詞
05對照驗收

Anatomy · 文件解剖

輕量版先回答 6 個核心章節

章節名稱可以因團隊調整，但每一段要求的判斷不能被省略。先讀問題，再看格式。

01
Executive Summary
範本必要章節
3-5 行，跨團隊 30 秒讀完。寫「版本號、上線時間、主要 scope、最大風險、退路」
02
Scope Commits
範本必要章節
列 user-facing commit 為主；type 用 Conventional Commits（feat / fix / perf / BREAKING）
03
Risk Summary
範本必要章節
至少列 high / medium 各 1 條；BREAKING change 必標 high
05
Comms Plan（internal / external / support）
範本必要章節
三層都要有；每層含 channel + audience + timing
07
Cross-links & Post-release Watch
範本必要章節
rollback_link 與 go_no_go_link 必填；post_release_metrics 至少 1 個 SLO + 1 個業務 KPI
10
Decision Log（key 2-3 條）
範本必要章節
每條必含 chosen + 至少 1 個 rejected option + 拒絕原因

Study · 對照學習

同一份交付物，先練核心，再看完整深度

輕量範本適合第一次練習與 MVP；完整範本保留跨職能交棒需要的細節。兩者都要求未知事項保持可見。

LIGHT TEMPLATE

30 分鐘內先完成核心章節。

---
doc_type: "release-plan"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["pr-list", "commit-log"]
  optional: ["dependency-graph"]
---

# Release Plan: <version>

**Status:** Draft v0.X · **Owner:** <PO + DevOps> · **Target:** <ISO 8601 + TZ> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 5, 7, 10），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：pr §XXX / commit §YYY）`；每量化欄位加 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；rollback_link 與 go_no_go_link 必填（即使為 TODO）。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行，跨團隊 30 秒讀完。寫「版本號、上線時間、主要 scope、最大風險、退路」 -->

<3-5 行說明>

> **TL;DR:** <一句話：版本 + scope + 退路>

---

## 2. Scope Commits

<!-- ai-rule: 列 user-facing commit 為主；type 用 Conventional Commits（feat / fix / perf / BREAKING） -->

| Commit | Type | Summary | PR | User-facing | Confidence |
|---|---|---|---|---|---|
| <sha> | feat | <one-line> | <URL> | yes | **[H]** |
| <sha> | fix | ... | <URL> | yes | **[H]** |
| <sha> | BREAKING | ... | <URL> | yes | **[H]** |

---

## 3. Risk Summary

<!-- ai-rule: 至少列 high / medium 各 1 條；BREAKING change 必標 high -->

> **High:** <風險 + 觸發條件 + Mitigation>
>
> **Medium:** <風險>
>
> **Unknowns:** <unknown 1>, <unknown 2>

---

## 5. Comms Plan（internal / external / support）

<!-- ai-rule: 三層都要有；每層含 channel + audience + timing -->

| Layer | Channel | Audience | Timing | Template |
|---|---|---|---|---|
| Internal | Slack #releases | Eng / SRE | T-24h / T-1h / T+0 | <URL> |
| External | status page / email | customers | T-7d / T+0 | <URL or TODO> |
| Support | CS playbook | support agents | T+0 | <URL> |

---

## 7. Cross-links & Post-release Watch

<!-- ai-rule: rollback_link 與 go_no_go_link 必填；post_release_metrics 至少 1 個 SLO + 1 個業務 KPI -->

- **Rollback plan:** <URL to rollback-plan.md or _TODO_>
- **Go/No-Go checklist:** <URL or _TODO_>
- **SLO watch window:** <minutes>
- **Business KPI watch:** <metric + threshold>
- **Abort criteria:** <條件>

---

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

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

| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | 灰度 vs 全量 | 灰度 / 全量 / 分批 | 灰度 | 全量 (BREAKING blast radius 超 budget) | **[H]** |

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 5, 7, 10）
> - [ ] Scope commits 用 Conventional Commits type
> - [ ] BREAKING change 在 Risk Summary 標 high
> - [ ] Comms 三層齊全（internal / external / support）
> - [ ] Rollback link 與 Go/No-Go link 必填（即使 TODO）
> - [ ] Decision Log ≥ 1 條，含 rejected reason
> - [ ] 無 YAML / JSON schema 輸出

Practice · 換你試做

先用自己的話交代素材，不需要先學會工程術語

確定的就寫，不確定的留白。下一步要做的是請 Agent 找缺口，不是讓它替你猜一套合理答案。

01這份文件要處理什麼

02目前已知背景

03可以採信的上游素材

04限制與不能自行改的事

05這份文件要幫誰做決定

可以先留白；複製提示詞後再到 Coding Agent 裡補充。

AI Practice · 手動三步

先問、再寫、最後審，不把整條流程鎖死

每一步都是獨立工作包。你可以停下補資料、修改限制或重做某一步，不需要服從固定的 Agent 接力流程。

STEP 01

只找阻擋文件成立的未知

先補會改變範圍、判斷或驗收結果的資訊，不急著寫文件。

我要製作「Release Plan · 上線計畫」。先不要產出文件。

請根據我的素材，找出會影響這份文件正確性或可執行性的未知事項，一次最多問 5 題。

每題請包含：
1. 問題
2. 為什麼現在必須知道
3. 它會影響哪個章節或決定

已經回答的事不要重問；可以延後的事標成「待決策」；不要替我猜答案。

本文件的核心章節：Executive Summary、Scope Commits、Risk Summary、Comms Plan（internal / external / support）、Cross-links & Post-release Watch、Decision Log（key 2-3 條）

複製後，請在標示位置貼上自己的素材。

Review · 自己驗收

文件存在，不代表下一個角色真的能使用

逐條檢查 Agent 的輸出。人類負責需求、限制與驗收，也必須能說明重要結論從哪裡來。

CHECKED0 / 6

輕量範本要求的章節都存在，沒有用漂亮摘要取代必要內容。每個重要結論都能回到使用者素材、上游文件或已確認回答。資訊不足的地方明確標成 TODO、未知或待決策，沒有讓 AI 自行補完。數字、角色、範圍與條件具體到能被下一位接手者判斷。已做決定與仍可調整的內容分開，限制之間沒有互相矛盾。你能用自己的話說明這份文件最重要的三個判斷與依據。

NEXT HANDOFF

帶著這份文件，繼續到「Rollback Plan · 回滾計畫」

下一張卡會接住新的決策問題；不用一次把整條 SDLC 全做完。

前往下一張卡