Habilidades de Agente para Runbooks SRE
Habilidades de Agente portáteis para criar, revisar e executar com segurança runbooks de SRE em produção.
Crie runbooks. Revise-os com um contexto limpo. Execute-os com segurança, um passo de cada vez.
Este repositório publica habilidades de agente reutilizáveis para documentação operacional e fluxos de resposta a incidentes. As habilidades são projetadas para SREs, engenheiros de plataforma, engenheiros DevOps, comandantes de incidentes e engenheiros de plantão que desejam runbooks assistidos por IA que sejam claros, seguros e executáveis.
As práticas nestas habilidades são inspiradas nas práticas do Google SRE e alinhadas com as melhores práticas comuns de SRE: alertas acionáveis, resposta a emergências, mitigação segura, verificação, critérios de rollback, escalonamento e propriedade clara.
Habilidades Inclusas
| Habilidade | Propósito |
|---|---|
sre-runbook-author | Criar runbooks focados em execução para alertas, incidentes, mitigações, rollbacks, diagnósticos e escalonamento. |
sre-runbook-reviewer | Revisar runbooks de uma perspectiva de contexto limpo e identificar lacunas, ações inseguras, suposições ocultas e verificação ausente. |
sre-runbook-executor | Percorrer um runbook existente um passo de cada vez com captura de evidências, paradas por ambiguidade e portões de aprovação para ações arriscadas. |
Exemplos de Uso
- "Crie um runbook para este alerta de alta taxa de 5xx."
- "Revise este runbook como se não tivesse contexto prévio."
- "Execute este runbook com segurança e pare antes de ações arriscadas."
- "Encontre suposições ocultas ou etapas ausentes neste procedimento de rollback."
- "Transforme este processo de resposta a incidentes em um runbook claro e executável por agente."
Instalação
Ferramentas compatíveis geralmente descobrem habilidades como diretórios contendo SKILL.md.
Instalação local no projeto:
mkdir -p .agents/skills
cp -r skills/sre-runbook-* .agents/skills/
Instalação no nível do usuário:
mkdir -p ~/.agents/skills
cp -r skills/sre-runbook-* ~/.agents/skills/
Algumas ferramentas usam seus próprios caminhos de habilidades ou plugins, como .gemini/skills/, ~/.gemini/skills/, ou diretórios de extensão específicos do produto. Verifique a documentação atual da sua ferramenta antes de instalar.
Modelo de Segurança
As habilidades são construídas em torno de uma resposta conservadora a incidentes:
- Comece com a entrada do incidente e o runbook aplicável.
- Separe diagnósticos somente leitura de ações de baixo risco e arriscadas.
- Pare quando as etapas forem ambíguas, o acesso necessário estiver ausente ou o estado observado divergir do runbook.
- Solicite aprovação explícita antes de ações arriscadas, como deploys, rollbacks, reinicializações, operações de escala, failovers, alterações de configuração, alterações de dados, alterações de permissão, supressão de alertas ou exclusão de recursos.
- Preserve evidências e compare os resultados reais com os resultados esperados.
Exemplos de Prompts
Crie um runbook SRE de produção para o alerta <NOME_DO_ALERTA>. Use espaços reservados para painéis, limites, proprietários e comandos ausentes.
Revise este runbook de uma perspectiva de contexto limpo. Sinalize qualquer coisa que confundiria um engenheiro de plantão às 3 da manhã.
Execute este runbook um passo de cada vez. Comece com diagnósticos somente leitura e pare antes de qualquer ação arriscada.
Exemplos
- Runbook genérico de alta taxa de erros HTTP 5xx
- Runbook de lag de consumidor Kafka
- Runbook de rollback de implantação Kubernetes
Licença
Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE.