On-Call Rotation · 值班輪值

---
doc_type: "on-call-rotation"
variant: "light"
status: "draft"
owner: "<sre-lead-or-devops-manager>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["alert-history-90d", "team-roster"]
  optional: ["slo", "hr-policy"]
---

# On-Call Rotation: <team-or-service-name>

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

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 6, 10, 12），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：alert-history §XXX / roster §YYY）`；每量化欄位 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；**Primary 不可同時是 Secondary**；**每月 on-call 工時 ≤ 法規上限**；**每週至少 1 天 paging-free**。

---

## 1. Rotation Structure

<!-- ai-fill: 1-2 行說明選擇的結構與為何 -->

| Field | Value |
|---|---|
| **Structure** | weekly / daily / follow-the-sun / business-hours-only |
| **Shift length** | <e.g. 168 hours (1 week)> |
| **Pool size** | <人數> |
| **Coverage** | 24x7 / business-hours-only |
| **Rationale** | <為何這個結構適合本團隊> |
| **Confidence** | **[H]** |

---

## 2. Primary / Secondary

<!-- ai-rule: Primary 不可同時是 Secondary；ack SLA 必須對應 SLO 的 MTTA 目標 -->

| Role | Source pool | Ack SLA | Note |
|---|---|---|---|
| **Primary** | <rotation pool A> | <e.g. 5 min> | 第一線接 page |
| **Secondary** | <rotation pool B, 與 Primary 互斥> | <e.g. 15 min> | Primary 無回應後接手 |
| **Tertiary（升級）** | <manager> | <e.g. 30 min> | Primary + Secondary 都無回應後 |

---

## 3. Paging Routing

<!-- ai-rule: 按 SEV 分流；SEV1 必須多人同時 page；SEV3 可降為 slack 非工時 -->

| Severity | Page targets | Note |
|---|---|---|
| **SEV1** | Primary + Secondary + Manager（10 min 後同時） | 業務影響大、需多人協作 |
| **SEV2** | Primary, 15 min 後 Secondary | <說明> |
| **SEV3** | Primary（業務時段）/ Slack notify（非工時） | <說明> |

---

## 6. Fatigue & Fairness

<!-- ai-rule: 必含 alert density per shift + fairness metric + 補休政策三件 -->

| Aspect | Value | Threshold | Source |
|---|---|---|---|
| **Alert density p50 / p95** | <events/week> | target p95 ≤ 2 paging / shift | alert-history §X |
| **Alerts per engineer (30d)** | <e.g. avg 3, max 7> | rebalance trigger ≥ 1.5σ | roster §Y |
| **Off-hours share** | <e.g. avg 30%, max 55%> | rebalance trigger > 40% | alert-history §Z |
| **Comp time per off-hours page** | <e.g. 1.5h> | per HR policy | hr-policy §A |

---

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

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

| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | Rotation 結構 | weekly / daily / follow-the-sun | weekly | daily (handoff 太頻繁、MTTA 變慢)、follow-the-sun (人池不足跨 3 時區) | **[H]** |

---

## 12. Confidence & Sources & TODO

- **整份文件最低 confidence 欄位：** <列出所有 [L] 與 [M]>
- **Fabricated assumptions（推測但 input 未明說）：**
  - <假設 1>
- **Highest-value next input:** <下一份最該補的：90d alert noise 報表 / 團隊意願調查>

### TODO（缺資料）

- _TODO: 需要 90d alert log 校準 alert density target_

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 6, 10, 12，刻意不連號）
> - [ ] **Primary ≠ Secondary**（不能同一人）
> - [ ] Paging routing 按 SEV1/2/3 分流
> - [ ] Fairness 含 alert density + per-engineer + off-hours share 三指標
> - [ ] 補休政策已寫（comp_time 或 paid_overtime）
> - [ ] Decision Log ≥ 1 條，每條有 rejected reason
> - [ ] 無 YAML / JSON schema 輸出（rotation 是給人讀的 markdown）