Emanuel Almeida
6b3a6f2698
- 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>
185 lines
4.2 KiB
Markdown
185 lines
4.2 KiB
Markdown
# Padrões de Output para Skills
|
|
|
|
Usar estes padrões quando skills precisam de produzir output consistente e de qualidade.
|
|
|
|
## Sumário
|
|
|
|
1. Padrão de Template
|
|
2. Padrão de Exemplos
|
|
3. Templates de Output Específicos Descomplicar
|
|
|
|
---
|
|
|
|
## 1. Padrão de Template
|
|
|
|
Fornecer templates para o formato de output. Calibrar o nível de rigor às necessidades.
|
|
|
|
### Para requisitos estritos (respostas de API, formatos de dados)
|
|
|
|
```markdown
|
|
## Estrutura do relatório
|
|
|
|
SEMPRE usar exactamente esta estrutura:
|
|
|
|
# [Título da Análise]
|
|
|
|
## Sumário executivo
|
|
[Parágrafo único com as principais conclusões]
|
|
|
|
## Principais conclusões
|
|
- Conclusão 1 com dados de suporte
|
|
- Conclusão 2 com dados de suporte
|
|
|
|
## Recomendações
|
|
1. Recomendação específica e accionável
|
|
2. Recomendação específica e accionável
|
|
```
|
|
|
|
### Para orientação flexível (quando a adaptação é útil)
|
|
|
|
```markdown
|
|
## Estrutura do relatório
|
|
|
|
Formato sensato por defeito, adaptar com bom senso:
|
|
|
|
# [Título da Análise]
|
|
|
|
## Sumário executivo
|
|
[Visão geral]
|
|
|
|
## Principais conclusões
|
|
[Adaptar secções com base no que for descoberto]
|
|
|
|
## Recomendações
|
|
[Adaptar ao contexto específico]
|
|
|
|
Ajustar secções conforme necessário para o tipo de análise.
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Padrão de Exemplos
|
|
|
|
Para skills em que a qualidade do output depende de ver exemplos, fornecer pares input/output:
|
|
|
|
```markdown
|
|
## Formato de mensagem de commit
|
|
|
|
Gerar mensagens de commit seguindo estes exemplos:
|
|
|
|
**Exemplo 1:**
|
|
Input: Adicionada autenticação de utilizador com tokens JWT
|
|
Output:
|
|
```
|
|
feat(auth): implementar autenticação JWT
|
|
|
|
Adicionar endpoint de login e middleware de validação de tokens
|
|
```
|
|
|
|
**Exemplo 2:**
|
|
Input: Corrigido erro em que as datas eram apresentadas incorrectamente nos relatórios
|
|
Output:
|
|
```
|
|
fix(reports): corrigir formatação de datas na conversão de timezone
|
|
|
|
Usar timestamps UTC consistentemente em toda a geração de relatórios
|
|
```
|
|
|
|
Seguir este estilo: tipo(âmbito): descrição breve, depois explicação detalhada.
|
|
```
|
|
|
|
Exemplos ajudam o agente a compreender o estilo e nível de detalhe pretendidos melhor do que descrições isoladas.
|
|
|
|
---
|
|
|
|
## 3. Templates de Output Específicos Descomplicar
|
|
|
|
### Template de comentário Desk CRM (HTML)
|
|
|
|
```html
|
|
<h4>Descrição</h4>
|
|
<ul>
|
|
<li>[Alteração realizada]</li>
|
|
</ul>
|
|
<p><strong>Ficheiros:</strong> <code>[path do ficheiro]</code></p>
|
|
<hr>
|
|
<p><strong>Skill:</strong> /nome-da-skill | <strong>Data:</strong> YYYY-MM-DD</p>
|
|
```
|
|
|
|
### Template de relatório de análise técnica
|
|
|
|
```markdown
|
|
# Análise: [Tema]
|
|
|
|
## Contexto
|
|
[Situação actual e motivação]
|
|
|
|
## Conclusões
|
|
- [Conclusão com evidência]
|
|
- [Conclusão com evidência]
|
|
|
|
## Recomendações
|
|
1. [Acção específica] — Prioridade: Alta/Média/Baixa
|
|
2. [Acção específica] — Prioridade: Alta/Média/Baixa
|
|
|
|
## Próximos passos
|
|
- [ ] [Tarefa concreta] — Responsável: [quem]
|
|
- [ ] [Tarefa concreta] — Data limite: DD-MM-YYYY
|
|
|
|
---
|
|
**Gerado por:** /nome-da-skill | **Data:** DD-MM-YYYY
|
|
```
|
|
|
|
### Template de user story (para skill-creator / planeamento)
|
|
|
|
```markdown
|
|
## User Story: [Título]
|
|
|
|
**Como** [tipo de utilizador],
|
|
**Quero** [acção/funcionalidade],
|
|
**Para que** [benefício/valor].
|
|
|
|
### Critérios de aceitação (GIVEN-WHEN-THEN)
|
|
|
|
- **DADO** [contexto inicial]
|
|
**QUANDO** [acção do utilizador]
|
|
**ENTÃO** [resultado esperado]
|
|
|
|
### Estimativa: [story points Fibonacci]
|
|
### Prioridade: Must/Should/Could/Won't
|
|
### Dependências: [lista de dependências]
|
|
```
|
|
|
|
### Template de output de skill para output de código
|
|
|
|
Quando a skill produz código, estruturar o output assim:
|
|
|
|
```
|
|
[Breve explicação do que foi feito]
|
|
|
|
**Ficheiro:** `path/para/ficheiro.ext`
|
|
|
|
```[linguagem]
|
|
[código com assinatura Descomplicar]
|
|
```
|
|
|
|
**Notas de implementação:**
|
|
- [nota importante 1]
|
|
- [nota importante 2]
|
|
|
|
**Próximos passos:**
|
|
- [ ] [verificação ou acção necessária]
|
|
```
|
|
|
|
---
|
|
|
|
## Calibragem de Templates por Risco
|
|
|
|
| Situação | Template | Grau de liberdade |
|
|
|----------|----------|-------------------|
|
|
| Output para API / integração | Estrito, exacto | Baixo |
|
|
| Relatório técnico interno | Flexível com estrutura | Médio |
|
|
| Análise exploratória | Orientação geral | Alto |
|
|
| Código de produção | Estrito com assinatura | Baixo |
|
|
| Documentação interna | Flexível | Alto |
|