ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: refactor 30+ skills to Anthropic progressive disclosure pattern

Browse Source 
- All SKILL.md files now <500 lines (avg reduction 69%)
- Detailed content extracted to references/ subdirectories
- Frontmatter standardised: only name + description (Anthropic standard)
- New skills: brand-guidelines, spec-coauthor, report-templates, skill-creator
- Design skills: anti-slop guidelines, premium-proposals reference
- Removed non-standard frontmatter fields (triggers, version, author, category)

Plugins affected: infraestrutura, marketing, dev-tools, crm-ops, gestao,
core-tools, negocio, perfex-dev, wordpress, design-media

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Emanuel Almeida
2026-03-12 15:05:03 +00:00
parent 9404af7ac9
commit 6b3a6f2698
397 changed files with 67154 additions and 17257 deletions
Download Patch File Download Diff File Expand all files Collapse all files

235
gestao/skills/report-templates/references/incident-report.md Normal file
View File

@@ -0,0 +1,235 @@
# Template: Relatorio de Incidente
**Tipo:** Comunicacao formal de incidente ao cliente
**Quando usar:** Qualquer situacao que afectou o servico, dados ou experiencia do cliente
**Tom:** Formal, transparente, orientado para resolucao e prevencao
**Extensao:** 1-2 paginas. Nao minimizar nem exagerar
**Principio cardinal:** Comunicar o incidente antes que o cliente pergunte. Transparencia activa.
---
## Classificacao de Severidade
| Nivel | Codigo | Criterio | Prazo comunicacao |
|-------|--------|----------|------------------|
| Critico | P1 | Servico completamente indisponivel ou perda de dados | 1 hora |
| Alto | P2 | Funcionalidade principal degradada | 4 horas |
| Medio | P3 | Funcionalidade secundaria afectada | 24 horas |
| Baixo | P4 | Problema menor sem impacto operacional | 72 horas |
---
## Estrutura do Template
### HTML (Desk CRM)
```html
<h4>Relatorio de Incidente — {{TITULO_INCIDENTE}}</h4>
<p>
<strong>Referencia:</strong> INC-{{ANO}}-{{NUMERO}} |
<strong>Severidade:</strong> <span style="color:{{COR_SEVERIDADE}}">{{NIVEL_SEVERIDADE}}</span> |
<strong>Estado:</strong> {{ESTADO_INCIDENTE}}
</p>
<h4>Resumo</h4>
<p>{{DESCRICAO_RESUMO}}</p>
<h4>Impacto</h4>
<table>
<tr>
<th>Dimensao</th>
<th>Detalhe</th>
</tr>
<tr>
<td>Inicio</td>
<td>{{DATA_INICIO}} {{HORA_INICIO}}</td>
</tr>
<tr>
<td>Fim / Resolucao</td>
<td>{{DATA_FIM}} {{HORA_FIM}} ({{DURACAO}} de impacto)</td>
</tr>
<tr>
<td>Servicos afectados</td>
<td>{{SERVICOS_AFECTADOS}}</td>
</tr>
<tr>
<td>Utilizadores afectados</td>
<td>{{UTILIZADORES_AFECTADOS}}</td>
</tr>
<tr>
<td>Dados afectados</td>
<td>{{DADOS_AFECTADOS}}</td>
</tr>
</table>
<h4>Cronologia</h4>
<table>
<tr>
<th>Hora</th>
<th>Evento</th>
</tr>
<tr>
<td>{{HORA_1}}</td>
<td>{{EVENTO_1}}</td>
</tr>
<tr>
<td>{{HORA_2}}</td>
<td>{{EVENTO_2}}</td>
</tr>
<tr>
<td>{{HORA_3}}</td>
<td>{{EVENTO_3}}</td>
</tr>
<tr>
<td>{{HORA_RESOLUCAO}}</td>
<td>Incidente resolvido — servico normalizado</td>
</tr>
</table>
<h4>Causa Raiz</h4>
<p>{{CAUSA_RAIZ}}</p>
<p><em>Nota: {{NOTA_CAUSA_RAIZ_SE_INVESTIGACAO_PENDENTE}}</em></p>
<h4>Accoes de Remediacao</h4>
<ul>
<li><strong>Imediata (concluida):</strong> {{ACCAO_IMEDIATA}}</li>
<li><strong>Curto prazo ({{DATA_CURTO_PRAZO}}):</strong> {{ACCAO_CURTO_PRAZO}}</li>
<li><strong>Preventiva ({{DATA_PREVENTIVA}}):</strong> {{ACCAO_PREVENTIVA}}</li>
</ul>
<h4>Compensacao</h4>
<p>{{COMPENSACAO_SE_APLICAVEL}}</p>
<p>Pedimos desculpa pelo inconveniente causado. Estamos comprometidos a prevenir recorrencia.</p>
<p>Para questoes adicionais: <a href="mailto:info@descomplicar.pt">info@descomplicar.pt</a> | 911 510 005</p>
<hr>
<p>
<strong>Descomplicar®</strong> |
<em>Relatorio emitido em {{DATA_EMISSAO}}</em>
</p>
```
### Markdown (Email / Hub)
```markdown
# Relatorio de Incidente — {{TITULO_INCIDENTE}}
**Referencia:** INC-{{ANO}}-{{NUMERO}} | **Severidade:** {{NIVEL_SEVERIDADE}} | **Estado:** {{ESTADO_INCIDENTE}}
---
## Resumo
{{DESCRICAO_RESUMO}}
## Impacto
| Dimensao | Detalhe |
|----------|---------|
| Inicio | {{DATA_INICIO}} {{HORA_INICIO}} |
| Fim / Resolucao | {{DATA_FIM}} {{HORA_FIM}} ({{DURACAO}}) |
| Servicos afectados | {{SERVICOS_AFECTADOS}} |
| Utilizadores afectados | {{UTILIZADORES_AFECTADOS}} |
| Dados afectados | {{DADOS_AFECTADOS}} |
## Cronologia
| Hora | Evento |
|------|--------|
| {{HORA_1}} | {{EVENTO_1}} |
| {{HORA_2}} | {{EVENTO_2}} |
| {{HORA_3}} | {{EVENTO_3}} |
| {{HORA_RESOLUCAO}} | Incidente resolvido — servico normalizado |
## Causa Raiz
{{CAUSA_RAIZ}}
## Accoes de Remediacao
- **Imediata (concluida):** {{ACCAO_IMEDIATA}}
- **Curto prazo ({{DATA_CURTO_PRAZO}}):** {{ACCAO_CURTO_PRAZO}}
- **Preventiva ({{DATA_PREVENTIVA}}):** {{ACCAO_PREVENTIVA}}
## Compensacao
{{COMPENSACAO_SE_APLICAVEL}}
---
Pedimos desculpa pelo inconveniente causado.
Para questoes: info@descomplicar.pt | 911 510 005
*Relatorio emitido em {{DATA_EMISSAO}} | Descomplicar®*
```
---
## Placeholders — Guia de Preenchimento
| Placeholder | Instrucoes de Preenchimento |
|-------------|---------------------------|
| `{{TITULO_INCIDENTE}}` | Descricao curta e factual: "Downtime servidor producao", "Falha autenticacao", "Perda dados formulario" |
| `{{NUMERO}}` | Sequencial do ano: 001, 002... Verificar incidentes anteriores |
| `{{NIVEL_SEVERIDADE}}` | P1 Critico / P2 Alto / P3 Medio / P4 Baixo |
| `{{ESTADO_INCIDENTE}}` | Resolvido / Em investigacao / Monitorizado |
| `{{DESCRICAO_RESUMO}}` | 2-3 frases: o que aconteceu, quando, impacto imediato |
| `{{DURACAO}}` | Ex: "2h 15min", "45min", "4h" |
| `{{CAUSA_RAIZ}}` | Tecnico mas acessivel. Se ainda em investigacao: "A investigacao esta em curso. Actualizacao prevista para DD-MM-YYYY." |
| `{{COMPENSACAO}}` | Se N/A: omitir seccao. Se aplicavel: credito, extensao, horas extra |
### Cores por Severidade (HTML)
| Nivel | Cor |
|-------|-----|
| P1 Critico | `#e53e3e` |
| P2 Alto | `#d69e2e` |
| P3 Medio | `#dd6b20` |
| P4 Baixo | `#38a169` |
---
## Exemplo Preenchido
```
Relatorio de Incidente — Downtime Servidor Producao
Referencia: INC-2026-003 | Severidade: P2 Alto | Estado: Resolvido
Resumo:
No dia 08-03-2026, entre as 14:22 e as 16:37, o servidor de producao
esteve inacessivel durante 2h 15min devido a uma falha de memoria
no servico de cache. Todos os servicos foram restaurados as 16:37.
Impacto:
- Duracao: 2h 15min
- Servicos afectados: Portal web, API integracao
- Utilizadores afectados: todos os utilizadores activos (~45)
- Dados: sem perda de dados confirmada
Causa Raiz:
Fuga de memoria no servico Redis apos actualizacao de versao
aplicada em manutencao preventiva às 13:00. A versao 7.2.1 tem
um bug conhecido com configuracoes de maxmemory-policy = allkeys-lru.
Accoes:
- Imediata: Rollback Redis para versao 7.0.15 (concluido)
- Curto prazo (12-03-2026): Adicionar alertas de memoria no sistema de monitorizacao
- Preventiva (31-03-2026): Procedimento de teste em staging antes de actualizacoes
```
---
## Notas de Uso
- Nunca minimizar o impacto — o cliente ja sabe o que sentiu
- Se a causa raiz nao for conhecida no momento de envio, dizer claramente com data de actualizacao
- Accoes preventivas devem ser reais e com datas — nao compromissos vagos
- Em P1/P2, comunicar primeiro por telefone, depois enviar relatorio formal
- Guardar registo em Desk CRM como comentario na tarefa do cliente (discussao #31)
---
*Template v1.0.0 | 2026-03-10 | Descomplicar®*