feat: adiciona 12 plugins Descomplicar ao marketplace
Plugins: automacao, crm-ops, design-media, dev-tools, gestao, infraestrutura, marketing, negocio, perfex-dev, project-manager, wordpress + hello-plugin (existente). Totais: 83 skills, 44 agents, 12 datasets.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
226
gestao/skills/report/SKILL.md
Normal file
226
gestao/skills/report/SKILL.md
Normal file
@@ -0,0 +1,226 @@
|
||||
---
|
||||
name: report
|
||||
description: >
|
||||
Relatórios agregados v1.0 - Semanal, mensal, projecto. Compila dados de múltiplas skills.
|
||||
Use when "report", "relatório", "semanal", "mensal", "resumo período".
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.0.0
|
||||
quality_score: 75
|
||||
user_invocable: true
|
||||
category: business
|
||||
tags: [report, relatório, semanal, mensal, analytics, desk, crm]
|
||||
desk_project: 65
|
||||
allowed-tools: Read, mcp__desk-crm-v3, mcp__mcp-time
|
||||
mcps: desk-crm-v3, mcp-time
|
||||
---
|
||||
|
||||
# /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®*
|
||||
Reference in New Issue
Block a user