AgentSkillsCN

devops-runbooks

运营手册和程序文档专家。在创建事件响应程序、运营手册或系统维护指南时使用。

SKILL.md
--- frontmatter
name: devops-runbooks
description: Operational runbook and procedure documentation specialist. Use when
  creating incident response procedures, operational playbooks, or system maintenance
  guides.
author: Joseph OBrien
status: unpublished
updated: '2025-12-23'
version: 1.0.1
tag: skill
type: skill

DevOps Runbooks Skill

Creates actionable runbooks for operational procedures, incident response, and system maintenance.

What This Skill Does

  • Creates operational runbooks
  • Documents incident procedures
  • Defines escalation paths
  • Provides troubleshooting guides
  • Documents rollback procedures
  • Captures operational knowledge

When to Use

  • Incident response planning
  • On-call documentation
  • System maintenance procedures
  • Disaster recovery planning
  • Knowledge transfer

Reference Files

  • references/RUNBOOK.template.md - Comprehensive operational runbook format

Runbook Structure

  1. Overview - Purpose and when to use
  2. Prerequisites - Access and tools needed
  3. Quick Reference - Key commands and URLs
  4. Procedure - Step-by-step with verification
  5. Rollback - How to revert changes
  6. Troubleshooting - Common issues
  7. Escalation - When and how to escalate

Best Practices

  • Commands must be copy-pasteable
  • Include expected output for each step
  • Document decision points clearly
  • Define rollback at each step
  • Keep procedures current (test regularly)
  • Include escalation contacts