# Runbook

> Guide runbook creation, maintenance, and drill exercises. Use when: writing runbooks, planning drills, auditing runbook coverage, post-incident runbook updates. Not for: responding to an incident already in progress — use /incident; the deployment procedure itself — use /deploy. Keywords: runbook, operations, drill, on-call, procedure.

- Skill: `asiaostrich/runbook` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add asiaostrich/runbook`
- Raw SKILL.md: https://api.skillmd.com/api/skills/asiaostrich/runbook/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: AsiaOstrich (https://skillmd.com/u/asiaostrich)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/asiaostrich/runbook

---


# Runbook Assistant | Runbook 助手

> **Language**: English | [繁體中文](../../locales/zh-TW/skills/runbook-assistant/SKILL.md)

Guide runbook writing, maintenance, drill exercises, and coverage reporting.

引導 Runbook 撰寫、維護、演練和覆蓋率報告。

## Capabilities | 功能

| Capability | Description | 說明 |
|------------|-------------|------|
| **Create Runbook** | Generate runbook from standard template (7 sections) | 從標準範本產生 Runbook |
| **Drill Planning** | Schedule and record drill exercises | 規劃和記錄演練 |
| **Coverage Report** | Check runbook coverage for P1-P4 alerts | 檢查告警的 Runbook 覆蓋率 |
| **Quality Review** | Verify runbook quality (6 principles) | 驗證 Runbook 品質 |
| **Staleness Check** | Identify overdue runbook reviews | 識別過期需審查的 Runbook |

## Usage | 使用方式

```bash
/runbook                              # Show runbook guide
/runbook create "api-latency-high"    # Create runbook for alert
/runbook drill                        # Plan drill exercises
/runbook coverage                     # Generate coverage report
```

## Next Steps Guidance | 下一步引導

> **Runbook 引導完成。建議下一步：**
> - 執行 `/observability --alerting` 連結告警到 Runbook ⭐ **推薦**
> - 執行 `/incident --postmortem` 從事故更新 Runbook
> - 執行 `/checkin` 提交變更

## Deploy Runbook — Mandatory Rule

Any deploy runbook that includes a destructive-update pattern (stop → swap → start) **MUST** follow the [Defensive Deployment Ordering](../../core/deployment-standards.md#defensive-deployment-ordering) sequence: extract to staging → verify → only then touch the live install. Skipping the verify step has caused real production outages.

任何包含 destructive-update（stop → swap → start）的部署 runbook **必須**遵循 [Defensive Deployment Ordering](../../core/deployment-standards.md#defensive-deployment-ordering) 順序：解壓到 staging → verify → 通過後才動 live install。跳過 verify 步驟已造成真實生產事故。

## Reference | 參考

- Detailed guide: [guide.md](./guide.md) — runbook creation, organization and validation. Read it when writing runbooks, reviewing operational procedures, planning drills, or assessing coverage.
- Core standard: [runbook-standards.md](../../core/runbook-standards.md)
- Related: [alerting-standards.md](../../core/alerting-standards.md)
- Related: [postmortem-standards.md](../../core/postmortem-standards.md)
- Related: [deployment-standards.md § Defensive Deployment Ordering](../../core/deployment-standards.md#defensive-deployment-ordering) — mandatory ordering for destructive deploys
- Related: [packaging-standards.md § Archive Format Integrity](../../core/packaging-standards.md#archive-format-integrity) — upstream pair to defensive ordering