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>
4.2 KiB
4.2 KiB
name, description, context
| name | description | context |
|---|---|---|
| report | 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". | 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:
## 📊 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:
## 📊 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
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:
## 📁 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®