runbook-generator – skill DevOps & Hạ tầng cho agent AI
Tạo runbook vận hành từ tên dịch vụ: quy trình triển khai, ứng phó sự cố, bảo trì và rollback. Cấu trúc mẫu có thể tùy chỉnh theo từng môi trường. Dùng khi viết tài liệu quy trình trực (on-call) cho dịch vụ mới, chuẩn hóa cách ứng phó sự cố giữa các nhóm, hoặc tạo runbook trước khi ra mắt cho pro
Cài skill runbook-generator bằng một lệnh
Chọn công cụ bạn đang dùng, copy lệnh và dán vào terminal. Skill sẽ nằm trong thư mục skills của công cụ đó và sẵn sàng dùng ở phiên làm việc tiếp theo.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/runbook-generator-80338.tgz | tar xz -C ~/.claude/skills
Gọi trong Claude Code: /runbook-generator – rồi mô tả công việc bạn muốn làm.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/runbook-generator-80338.tgz | tar xz -C ~/.codex/skills
Gọi trong Codex: $runbook-generator – rồi mô tả công việc bạn muốn làm.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/runbook-generator-80338.tgz | tar xz -C ~/.hermes/skills
Gọi trong Hermes Agent: /runbook-generator – rồi mô tả công việc bạn muốn làm.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/runbook-generator-80338.tgz | tar xz -C ~/.deepcode/skills
Gọi trong DeepSeek: /runbook-generator – rồi mô tả công việc bạn muốn làm.
Nội dung SKILL.md
Nội dung SKILL.md gốc bằng tiếng Anh.
Runbook Generator
Tier: POWERFUL
Category: Engineering
Domain: DevOps / Site Reliability Engineering
---
Overview
Generate operational runbooks quickly from a service name, then customize for deployment, incident response, maintenance, and rollback workflows.
Core Capabilities
- Runbook skeleton generation from a CLI
- Standard sections for start/stop/health/rollback
- Structured escalation and incident handling placeholders
- Reference templates for deployment and incident playbooks
---
When to Use
- A service has no runbook and needs a baseline immediately
- Existing runbooks are inconsistent across teams
- On-call onboarding requires standardized operations docs
- You need repeatable runbook scaffolding for new services
---
Quick Start
# Print runbook to stdout
python3 scripts/runbook_generator.py payments-api
# Write runbook file
python3 scripts/runbook_generator.py payments-api --owner platform --output docs/runbooks/payments-api.md---
Recommended Workflow
1. Generate the initial skeleton with scripts/runbook_generator.py.
2. Fill in service-specific commands and URLs.
3. Add verification checks and rollback triggers.
4. Dry-run in staging.
5. Store runbook in version control near service code.
---
Reference Docs
references/runbook-templates.md
---
Common Pitfalls
- Missing rollback triggers or rollback commands
- Steps without expected output checks
- Stale ownership/escalation contacts
- Runbooks never tested outside of incidents
Best Practices
1. Keep every command copy-pasteable.
2. Include health checks after every critical step.
3. Validate runbooks on a fixed review cadence.
4. Update runbook content after incidents and postmortems.
Skill liên quan
- fedora-hyprland-installer – Cài đặt, cấu hình, kiểm tra, sửa lỗi, cập nhật và gỡ cài đặt Hyprland trên Fedora Linux…
- fedramp-compliance – Triển khai yêu cầu FedRAMP cho dịch vụ đám mây liên bang. Cấu hình kiểm soát NIST 800-53…
- firebase-app-platform – Xây dựng và vận hành ứng dụng trên Firebase với Auth, Firestore, Cloud Functions và…
- flutter-expert – Làm chủ phát triển Flutter với Dart 3, widget nâng cao và triển khai đa nền tảng.
- secrets-vault-manager – Dùng khi người dùng yêu cầu thiết lập hạ tầng quản lý bí mật, tích hợp HashiCorp Vault…
- gcp-audit-logs – Cấu hình GCP Cloud Audit Logs để tuân thủ. Thiết lập định tuyến log và phân tích bằng…
- gcp-cloud-functions – Triển khai serverless functions trên Google Cloud Functions. Cấu hình triggers và quản…
- gcp-cloud-run – Skill chuyên biệt để xây dựng ứng dụng serverless sẵn sàng cho production trên GCP. Bao…