# 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 |
