SkillProgramaçãoCriação
Templates de Runbook de Incidente
Escreve runbooks de incidente por alerta ou modo de falha, cobrindo detecção, diagnóstico, mitigação, verificação e escalação. Use ao criar runbooks para o on-call — todo alerta deve apontar para um, senão vira ruído.
Ações
PerfilDev
ProfundidadeBaixa
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Produzir runbooks de on-call no formato canônico para cada alerta ou modo de falha recorrente, de modo que todo alerta tenha um runbook associado e a equipe saiba exatamente como detectar, diagnosticar, mitigar, verificar e escalar a falha.
Aplicação
Quando
faz sentido.
Usar
- Um novo alerta está sendo criado — o runbook deve existir antes de o alerta ser ativado
- Auditoria de alertas existentes em busca de órfãos (sem runbook) ou runbooks desatualizados
- Onboarding de um novo engenheiro de on-call que precisa do formato canônico
- Action item de postmortem: "criar runbook para o modo de falha X"
Não usar
- Documentação operacional geral — use uma wiki, não o template de runbook
- Resposta a incidente pontual — runbooks são para modos de falha recorrentes
- Desenhar o próprio alerta (thresholds, query) — use prometheus-configuration
Prompt
Instruções
para a IA.
### Pré-requisitos
Antes de escrever, confirme que o alerta existe e tem um modo de falha claro, que há um time dono que assumiu o runbook e que os links de dashboards e queries estão disponíveis para embutir.
### Preencha o template
Siga a estrutura canônica: o que o alerta significa em português claro; severidade (P0–P3) e o porquê; ações de primeiro toque em 5 minutos (reconhecer o alerta, abrir os dashboards, fazer perguntas rápidas de triagem); um fluxograma de diagnóstico (se A, cheque Z; se desconhecido, escale); opções de mitigação em tabela com gatilho e risco de cada uma; passos de verificação para confirmar a resolução; cadeia de escalação (dono, secundário, especialista); e link para o template de postmortem, além de data e dono da última atualização.
### Aplique as regras de qualidade
Teste o runbook simulando o alerta (ou em um exercício de chaos). "Veja o dashboard" sem link é inútil — sempre embuta os links. As opções de mitigação devem incluir risco e reversibilidade.
### Evite os anti-padrões
Não deixe alertas sem runbook (viram ruído), runbooks só com diagnóstico e sem mitigação, ou runbooks obsoletos com links quebrados e donos que já saíram. Faça uma revisão trimestral podando alertas e runbooks. A saída inclui um mapa alerta-para-runbook 1:1 sem órfãos.
Antes de escrever, confirme que o alerta existe e tem um modo de falha claro, que há um time dono que assumiu o runbook e que os links de dashboards e queries estão disponíveis para embutir.
### Preencha o template
Siga a estrutura canônica: o que o alerta significa em português claro; severidade (P0–P3) e o porquê; ações de primeiro toque em 5 minutos (reconhecer o alerta, abrir os dashboards, fazer perguntas rápidas de triagem); um fluxograma de diagnóstico (se A, cheque Z; se desconhecido, escale); opções de mitigação em tabela com gatilho e risco de cada uma; passos de verificação para confirmar a resolução; cadeia de escalação (dono, secundário, especialista); e link para o template de postmortem, além de data e dono da última atualização.
### Aplique as regras de qualidade
Teste o runbook simulando o alerta (ou em um exercício de chaos). "Veja o dashboard" sem link é inútil — sempre embuta os links. As opções de mitigação devem incluir risco e reversibilidade.
### Evite os anti-padrões
Não deixe alertas sem runbook (viram ruído), runbooks só com diagnóstico e sem mitigação, ou runbooks obsoletos com links quebrados e donos que já saíram. Faça uma revisão trimestral podando alertas e runbooks. A saída inclui um mapa alerta-para-runbook 1:1 sem órfãos.
Constelação
Onde
ela vive.
Workflows que usam
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).