feat: refactor 30+ skills to Anthropic progressive disclosure pattern
- 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:
184
dev-tools/skills/skill-creator/references/output-patterns.md
Normal file
184
dev-tools/skills/skill-creator/references/output-patterns.md
Normal file
@@ -0,0 +1,184 @@
|
||||
# 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 |
|
||||
Reference in New Issue
Block a user