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>
217 lines
4.2 KiB
Markdown
217 lines
4.2 KiB
Markdown
---
|
|
name: report
|
|
description: Relatórios agregados semanal, mensal e por projecto. Compila dados de múltiplas fontes CRM. Usar quando "report", "relatório", "semanal", "mensal", "resumo período".
|
|
context: fork
|
|
---
|
|
|
|
# /report v1.0 - Relatórios Agregados
|
|
|
|
Relatórios de período compilando dados de múltiplas fontes.
|
|
|
|
---
|
|
|
|
## Comandos
|
|
|
|
| Comando | Função |
|
|
|---------|--------|
|
|
| `/report` | Relatório semanal (default) |
|
|
| `/report weekly` | Relatório semanal detalhado |
|
|
| `/report monthly` | Relatório mensal |
|
|
| `/report project <id>` | Relatório de projecto |
|
|
|
|
---
|
|
|
|
## Protocolo
|
|
|
|
### /report weekly (Semanal)
|
|
|
|
```
|
|
1. mcp__mcp-time__current_time → Calcular Seg-Dom da semana
|
|
2. Recolher dados:
|
|
a. Timesheets da semana
|
|
b. Tarefas concluídas
|
|
c. Tickets fechados
|
|
d. Facturas emitidas/pagas
|
|
3. Calcular métricas
|
|
4. Gerar relatório
|
|
```
|
|
|
|
**Output:**
|
|
|
|
```markdown
|
|
## 📊 Relatório Semanal - W06 (03-09 Fev 2026)
|
|
|
|
### ⏱️ Tempo
|
|
| Dia | Horas | Billable |
|
|
|-----|-------|----------|
|
|
| Seg | 6h 30m | 5h |
|
|
| Ter | 7h 15m | 6h |
|
|
| Qua | 4h 45m | 4h |
|
|
| Qui | 8h 00m | 7h |
|
|
| Sex | 5h 30m | 5h |
|
|
| **Total** | **32h** | **27h (84%)** |
|
|
|
|
### ✅ Tarefas Concluídas (12)
|
|
| ID | Tarefa | Projecto |
|
|
|----|--------|----------|
|
|
| #1446 | Documentação | Stack |
|
|
| #1448 | Testes | Stack |
|
|
|
|
### 🎫 Tickets (8)
|
|
- Fechados: 6
|
|
- Em aberto: 2
|
|
- Tempo médio resolução: 4h
|
|
|
|
### 💰 Facturação
|
|
| Métrica | Valor |
|
|
|---------|-------|
|
|
| Emitido | €5.500 |
|
|
| Recebido | €3.200 |
|
|
| Pendente | €7.800 |
|
|
|
|
### 📈 Highlights
|
|
- Projecto SFV-360: 15h (47%)
|
|
- Projecto Stack: 10h (31%)
|
|
- Interno: 7h (22%)
|
|
```
|
|
|
|
---
|
|
|
|
### /report monthly (Mensal)
|
|
|
|
```
|
|
1. Calcular primeiro e último dia do mês
|
|
2. Recolher dados agregados
|
|
3. Comparar com mês anterior
|
|
4. Gerar relatório
|
|
```
|
|
|
|
**Output:**
|
|
|
|
```markdown
|
|
## 📊 Relatório Mensal - Janeiro 2026
|
|
|
|
### Resumo Executivo
|
|
- Horas trabalhadas: 142h
|
|
- Billable: 118h (83%)
|
|
- Facturado: €12.500
|
|
- Recebido: €9.800
|
|
|
|
### Comparação
|
|
| Métrica | Jan | Dez | Δ |
|
|
|---------|-----|-----|---|
|
|
| Horas | 142h | 128h | +11% |
|
|
| Facturado | €12.5k | €10.2k | +23% |
|
|
| Tickets | 32 | 28 | +14% |
|
|
|
|
### Projectos Activos (5)
|
|
| Projecto | Horas | Valor |
|
|
|----------|-------|-------|
|
|
| SFV-360 | 45h | €4.500 |
|
|
| Stack | 38h | Interno |
|
|
|
|
### Clientes
|
|
| Cliente | Facturado | Pago | Saldo |
|
|
|---------|-----------|------|-------|
|
|
| TechCorp | €5.000 | €5.000 | €0 |
|
|
| StartupX | €3.500 | €2.000 | €1.500 |
|
|
```
|
|
|
|
---
|
|
|
|
### /report project <id>
|
|
|
|
```
|
|
1. mcp__desk-crm-v3__get_project({ project_id })
|
|
2. mcp__desk-crm-v3__get_tasks({ project_id })
|
|
3. mcp__desk-crm-v3__get_project_time_tracking({ project_id })
|
|
4. mcp__desk-crm-v3__get_invoices({ project_id })
|
|
5. Gerar relatório
|
|
```
|
|
|
|
**Output:**
|
|
|
|
```markdown
|
|
## 📁 Relatório Projecto: SFV-360 (#80)
|
|
|
|
### Status
|
|
- **Progresso:** 65%
|
|
- **Início:** 2026-01-15
|
|
- **Deadline:** 2026-03-31
|
|
|
|
### Tarefas
|
|
| Status | Qtd |
|
|
|--------|-----|
|
|
| Concluídas | 12 |
|
|
| Em curso | 5 |
|
|
| Pendentes | 8 |
|
|
|
|
### Tempo
|
|
- Total: 45h
|
|
- Estimado: 80h
|
|
- Burn rate: 56%
|
|
|
|
### Financeiro
|
|
| Factura | Valor | Status |
|
|
|---------|-------|--------|
|
|
| INV-045 | €2.500 | Pendente |
|
|
| INV-040 | €2.000 | Pago |
|
|
|
|
### Timeline
|
|
- 15/Jan: Kickoff
|
|
- 25/Jan: Fase 1 concluída
|
|
- 05/Fev: Entrega parcial
|
|
```
|
|
|
|
---
|
|
|
|
## Métricas Calculadas
|
|
|
|
| Métrica | Fórmula |
|
|
|---------|---------|
|
|
| Billable % | Horas billable / Total horas |
|
|
| Burn rate | Horas gastas / Horas estimadas |
|
|
| Ticket SLA | Tickets dentro SLA / Total |
|
|
| DSO | Dias médios para pagamento |
|
|
|
|
---
|
|
|
|
## Integração Skills
|
|
|
|
| Dados | Fonte |
|
|
|-------|-------|
|
|
| Tempo | /time (timesheets) |
|
|
| Tarefas | /crm (tasks) |
|
|
| Tickets | /ticket |
|
|
| Facturas | /invoice |
|
|
|
|
---
|
|
|
|
## Storage
|
|
|
|
Relatórios podem ser guardados em:
|
|
- **Discussão #31** (Logs) - Relatórios semanais
|
|
- **memory-supabase** - Backup para análise histórica
|
|
|
|
---
|
|
|
|
## Anti-Patterns
|
|
|
|
- **NUNCA** gerar relatório sem período definido
|
|
- **NUNCA** incluir dados estimados como factos
|
|
- **NUNCA** mostrar valores financeiros a staff não autorizado
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
### v1.0.0 (2026-02-05)
|
|
- Versão inicial
|
|
- Relatórios weekly, monthly, project
|
|
- Integração com skills Desk
|
|
- Métricas calculadas
|
|
|
|
---
|
|
|
|
*Skill v1.0.0 | 2026-02-05 | Descomplicar®*
|