Agent Skills
› evolution-foundation/evo-nexus
› ops-runbook
ops-runbook
GitHub生成或更新运维操作手册，将重复性任务转化为详细的逐步执行指南。涵盖前置条件、具体步骤、故障排查、回滚方案及升级流程，旨在实现知识沉淀与标准化运维。
Trigger Scenarios
创建新的运维操作流程文档
更新现有操作手册以包含故障处理和回滚步骤
将口头传承的运维知识转化为书面标准程序
Install
npx skills add evolution-foundation/evo-nexus --skill ops-runbook -g -y
SKILL.md
Frontmatter
{
"name": "ops-runbook",
"description": "Criar ou atualizar runbook operacional para tarefa ou procedimento recorrente. Use quando documentar tarefa que o time de ops precisa rodar repetidamente, transformar conhecimento tribal em comandos passo a passo, adicionar troubleshooting e rollback a procedimento existente, ou escrever caminhos de escalação para quando algo der errado. Agente Clawdia.",
"argument-hint": "<nome do processo ou tarefa>"
}
/ops-runbook
Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.
Cria runbook operacional passo a passo para tarefa ou procedimento recorrente.
Agente
Clawdia — hub operacional, calendário, emails, tarefas, decisões.
Output
## Runbook: [Nome da Tarefa]
**Responsável:** [Time/Pessoa] | **Frequência:** [Diária/Semanal/Mensal/Conforme Necessário]
**Última Atualização:** [Data] | **Última Execução:** [Data]
### Objetivo
[O que esse runbook realiza e quando usar]
### Pré-requisitos
- [ ] [Acesso ou permissão necessária]
- [ ] [Ferramenta ou sistema necessário]
- [ ] [Dado ou input necessário]
### Procedimento
#### Etapa 1: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]
#### Etapa 2: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]
### Verificação
- [ ] [Como confirmar que a tarefa foi concluída com sucesso]
- [ ] [O que checar]
### Troubleshooting
| Sintoma | Causa Provável | Solução |
|---------|---------------|---------|
| [O que você vê] | [Por quê] | [O que fazer] |
### Rollback
[Como desfazer isso se algo der errado]
### Escalação
| Situação | Contato | Método |
|----------|---------|--------|
| [Quando escalar] | [Quem] | [Como contatar — Discord/WhatsApp/telefone] |
### Histórico
| Data | Executado por | Notas |
|------|--------------|-------|
| [Data] | [Pessoa] | [Issues ou observações] |
Se Conectores Disponíveis
Se Notion MCP estiver conectado:
- Buscar runbooks existentes para atualizar em vez de criar do zero
- Publicar o runbook finalizado na wiki de ops do Notion
Se Linear MCP estiver conectado:
- Vincular o runbook a tipos de incident e change requests relacionados
- Referenciar issues de manutenção recorrentes
Dicas
- Seja dolorosamente específico — "Rodar o script" não é uma etapa. "Rodar
python sync.py --prod --dry-runno servidor de ops" é. - Inclua modos de falha — O que pode dar errado em cada etapa e o que fazer a respeito.
- Teste o runbook — Peça a alguém não familiarizado com o processo para segui-lo. Corrija onde travarem.
Version History
- 7f5dd76 Current 2026-07-25 04:57
