Agent Skills
› evolution-foundation/evo-nexus
› ops-runbook
ops-runbook
GitHub用于创建和更新运维操作手册，将重复性任务转化为详细的分步指南、故障排除及回滚方案。支持集成 Notion 和 Linear 以自动化文档管理和任务关联，提升运维效率与知识沉淀。
触发场景
需要为重复性运维任务编写标准化操作步骤
将口头或隐性知识转化为结构化文档
现有流程缺乏故障排查或回滚指引
需要建立运维事件升级机制
安装
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.
版本历史
- 7f5dd76 当前 2026-07-25 04:57
