claude-plugins/gestao/skills/report-templates/SKILL.md

---
name: report-templates
description: Templates de comunicacao com clientes — updates mensais, status de projecto, relatorios de incidente e revisoes mensais. Usar quando "relatorio cliente", "report cliente", "update cliente", "status projecto", "incidente", "revisao mensal", "comunicar cliente", "resumo projecto", "enviar report", "preparar relatorio".
---

# /report-templates — Comunicacao com Clientes

Templates profissionais para comunicacao Descomplicar® com clientes. Gera documentos em HTML (Desk CRM) ou Markdown (Hub/email).

---

## Comandos

| Comando | Template | Uso |
|---------|----------|-----|
| `/report-templates update [cliente]` | client-update.md | Update mensal de progresso |
| `/report-templates status [projecto_id]` | project-status.md | Status detalhado de projecto |
| `/report-templates incidente [descricao]` | incident-report.md | Relatorio de incidente |
| `/report-templates mensal [cliente] [mes]` | monthly-review.md | Revisao mensal completa |

---

## Parametros

| Parametro | Descricao | Exemplo |
|-----------|-----------|---------|
| `--format html` | Output HTML para Desk CRM (default) | `--format html` |
| `--format md` | Output Markdown para Hub/email | `--format md` |
| `--lang pt` | Lingua do documento (default: pt) | `--lang pt` |
| `--desk` | Publicar como comentario no Desk CRM | `--desk` |

---

## Workflow de Execucao

```
1. IDENTIFICAR tipo de comunicacao:
   - "update", "progresso", "mensal simples" -> client-update
   - "status", "estado", "projecto" -> project-status
   - "incidente", "problema", "falha", "downtime" -> incident-report
   - "revisao mensal", "mensal completo", "revisao periodo" -> monthly-review

2. RECOLHER dados do Desk CRM:
   a. mcp__desk-crm-v3__get_project({ project_id }) — se aplicavel
   b. mcp__desk-crm-v3__get_tasks({ project_id }) — tarefas do periodo
   c. mcp__desk-crm-v3__get_project_time_tracking({ project_id }) — horas
   d. mcp__desk-crm-v3__get_invoices({ project_id }) — facturacao
   e. mcp__desk-crm-v3__search_customers({ name }) — dados cliente

3. CARREGAR template de references/:
   - client-update.md / project-status.md / incident-report.md / monthly-review.md

4. PREENCHER placeholders com dados reais

5. GERAR output no formato pedido (html ou md)

6. SE --desk: publicar via mcp__desk-crm-v3__add_task_comment
```

---

## Tom de Comunicacao Descomplicar

**Principios:**
- Profissional mas directo — sem jargao desnecessario
- Dados primeiro — factos antes de interpretacao
- Transparente em problemas — nunca esconder dificuldades
- Orientado para accao — cada ponto tem proximo passo claro
- Portugues europeu sempre — sem brasileirismos

**O que evitar:**
- Linguagem vaga ("estamos a trabalhar nisso")
- Promessas sem datas ("em breve")
- Excesso de adjectivos ("excelente progresso fantástico")
- Emojis em documentos formais
- Estimativas sem base nos dados

---

## Formatos de Output

### HTML (Desk CRM)

```html
<h4>Titulo da Seccao</h4>
<ul><li>Item</li></ul>
<table>
  <tr><th>Coluna</th><th>Valor</th></tr>
  <tr><td>Dado</td><td>Valor</td></tr>
</table>
<p><strong>Proximo passo:</strong> accao concreta com data</p>
<hr>
<p><em>Relatorio gerado em DD-MM-YYYY | Descomplicar®</em></p>
```

### Markdown (Hub / Email)

```markdown
## Titulo

| Coluna | Valor |
|--------|-------|
| Dado   | Valor |

**Proximo passo:** accao concreta com data

---
*Relatorio gerado em DD-MM-YYYY | Descomplicar®*
```

---

## Templates Disponiveis

| Ficheiro | Template | Quando usar |
|----------|----------|-------------|
| `references/client-update.md` | Update mensal simples | Comunicacao periodica de progresso |
| `references/project-status.md` | Status de projecto | Revisao de milestone, reuniao de acompanhamento |
| `references/incident-report.md` | Relatorio de incidente | Qualquer problema que afectou o cliente |
| `references/monthly-review.md` | Revisao mensal completa | Fim de mes, revisao estrategica |

---

## Exemplos de Uso

### Update mensal simples

```
/report-templates update "SFV 360"
```
Recolhe dados do projecto SFV-360, preenche template client-update, gera HTML para Desk CRM.

### Status de projecto com markdown

```
/report-templates status 80 --format md
```
Gera relatorio de status do projecto #80 em Markdown para enviar por email.

### Relatorio de incidente

```
/report-templates incidente "Downtime servidor producao 2h"
```
Gera relatorio formal de incidente com timeline, impacto e plano de accao.

### Revisao mensal publicada no Desk

```
/report-templates mensal "CTF BigData" "Fevereiro 2026" --desk
```
Gera revisao mensal completa e publica como comentario na tarefa Desk do cliente.

---

## Integracao com Outras Skills

| Skill | Uso |
|-------|-----|
| `/report` | Dados agregados de periodo (horas, tarefas, facturas) |
| `/time` | Timesheets detalhados para incluir no relatorio |
| `/desk` | Contexto do projecto e cliente |

---

## Anti-Patterns

- **Nunca** gerar relatorio sem dados reais do Desk CRM
- **Nunca** incluir valores financeiros estimados como factos
- **Nunca** enviar relatorio de incidente sem plano de accao definido
- **Nunca** usar tom informal em relatorios de incidente

---

## Changelog

### v1.0.0 (2026-03-10)
- Versao inicial
- 4 templates: client-update, project-status, incident-report, monthly-review
- Suporte HTML e Markdown
- Integracao com Desk CRM

---

*Skill v1.0.0 | 2026-03-10 | Descomplicar®*