feat(gestao): adicionar skill /monday-briefing v1.0
Briefing semanal automatizado com 4 componentes: 1. Trend Researcher — tendências de mercado via WebSearch 2. Analytics Reporter — métricas Desk CRM + Moloni + Calendar 3. Growth Hacker — 1 acção concreta com 3 passos 4. Reality Checker — contra-argumentos e pressupostos Suporta argumentos: terminal (default), inbox, email. Agendável via /schedule segunda 9h. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,255 @@
|
|||||||
|
---
|
||||||
|
name: monday-briefing
|
||||||
|
description: Briefing semanal automatizado com 4 componentes — tendências de mercado, métricas chave, acção da semana e contra-argumentos. Usar quando "monday", "briefing segunda", "resumo semanal", "briefing semana", "monday briefing".
|
||||||
|
context: fork
|
||||||
|
---
|
||||||
|
|
||||||
|
# /monday-briefing v1.0
|
||||||
|
|
||||||
|
Briefing semanal com 4 perspectivas: tendências, métricas, acção e realidade.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Protocolo
|
||||||
|
|
||||||
|
### Passo 1: Recolher data e período
|
||||||
|
|
||||||
|
```
|
||||||
|
mcp__mcp-time__current_time → data actual
|
||||||
|
Calcular:
|
||||||
|
- semana_actual: Segunda a Domingo desta semana
|
||||||
|
- semana_anterior: Segunda a Domingo da semana passada
|
||||||
|
- periodo_atual: "Semana W{N} ({DD Mmm} – {DD Mmm YYYY})"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Passo 2: Recolher dados em paralelo
|
||||||
|
|
||||||
|
> Executar TUDO em paralelo. Registar erros sem bloquear — continuar com dados disponíveis.
|
||||||
|
|
||||||
|
```
|
||||||
|
Em paralelo:
|
||||||
|
|
||||||
|
[A] DESK CRM — Métricas da semana
|
||||||
|
mcp__desk-crm-v3__get_tasks({ date_from: inicio_semana_anterior, date_to: fim_semana_anterior, status: 5 })
|
||||||
|
→ tarefas_concluidas_semana_ant
|
||||||
|
mcp__desk-crm-v3__get_tasks({ date_from: inicio_semana, date_to: fim_semana, status: [1,2,3] })
|
||||||
|
→ tarefas_abertas_semana_atual
|
||||||
|
mcp__desk-crm-v3__get_timesheets({ date_from: inicio_semana_anterior, date_to: fim_semana_anterior })
|
||||||
|
→ horas_semana_ant
|
||||||
|
mcp__desk-crm-v3__get_tickets({ status: [1,2,3] })
|
||||||
|
→ tickets_abertos
|
||||||
|
|
||||||
|
[B] MOLONI — Facturação da semana
|
||||||
|
mcp__moloni-mcp__list_documents({
|
||||||
|
document_type: "invoice",
|
||||||
|
date_from: inicio_semana_anterior,
|
||||||
|
date_to: fim_semana_anterior
|
||||||
|
})
|
||||||
|
→ facturas_semana_ant (valor total + contagem)
|
||||||
|
mcp__moloni-mcp__list_documents({
|
||||||
|
document_type: "invoice",
|
||||||
|
date_from: inicio_semana,
|
||||||
|
date_to: fim_semana
|
||||||
|
})
|
||||||
|
→ facturas_semana_atual (se já existirem)
|
||||||
|
|
||||||
|
[C] DESK CRM — Leads e pipeline
|
||||||
|
mcp__desk-crm-v3__get_leads({ status: [7,14], limit: 20 })
|
||||||
|
→ leads_novos
|
||||||
|
mcp__desk-crm-v3__get_estimates({ status: [3,4], limit: 20 })
|
||||||
|
→ propostas_pipeline
|
||||||
|
|
||||||
|
[D] TENDÊNCIAS — WebSearch
|
||||||
|
WebSearch: "marketing digital tendencias semana {data_atual}"
|
||||||
|
WebSearch: "SEO updates {mes} {ano}"
|
||||||
|
WebSearch: "WordPress news {mes} {ano}"
|
||||||
|
→ 3 tendências relevantes ao negócio Descomplicar
|
||||||
|
|
||||||
|
[E] GOOGLE WORKSPACE — Agenda da semana
|
||||||
|
mcp__google-workspace__calendar_get_events({
|
||||||
|
user_google_email: "emanuelalmeidaa@gmail.com",
|
||||||
|
time_min: "{inicio_semana}T00:00:00Z",
|
||||||
|
time_max: "{fim_semana}T23:59:59Z"
|
||||||
|
})
|
||||||
|
→ eventos_semana
|
||||||
|
```
|
||||||
|
|
||||||
|
### Passo 3: Calcular métricas comparativas
|
||||||
|
|
||||||
|
```
|
||||||
|
Calcular variações:
|
||||||
|
delta_horas = horas_semana_ant vs semana anterior a essa (% variação)
|
||||||
|
delta_facturas = valor_semana_ant vs média das últimas 4 semanas
|
||||||
|
taxa_conclusao = tarefas_concluidas / (tarefas_concluidas + abertas) * 100
|
||||||
|
|
||||||
|
SE dados incompletos: usar "N/D" e indicar fonte em falta
|
||||||
|
```
|
||||||
|
|
||||||
|
### Passo 4: Gerar briefing em 4 secções
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Output
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Monday Briefing — {periodo_atual}
|
||||||
|
*Gerado em {data_hora_atual} | Descomplicar®*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Trend Researcher — O Que Mudou Esta Semana
|
||||||
|
|
||||||
|
> Tendências relevantes para o negócio (marketing digital, SEO, WordPress, automação)
|
||||||
|
|
||||||
|
**[Tendência 1]**
|
||||||
|
_Fonte: [URL]_
|
||||||
|
Impacto potencial: [curto resumo do que muda para a Descomplicar]
|
||||||
|
|
||||||
|
**[Tendência 2]**
|
||||||
|
_Fonte: [URL]_
|
||||||
|
Impacto potencial: [curto resumo]
|
||||||
|
|
||||||
|
**[Tendência 3]**
|
||||||
|
_Fonte: [URL]_
|
||||||
|
Impacto potencial: [curto resumo]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Analytics Reporter — Métricas vs Semana Anterior
|
||||||
|
|
||||||
|
### Produtividade
|
||||||
|
| Métrica | Semana Anterior | Esta Semana | Δ |
|
||||||
|
|---------|----------------|-------------|---|
|
||||||
|
| Horas registadas | X h | Y h | ±Z% |
|
||||||
|
| Tarefas concluídas | X | Y | ±Z |
|
||||||
|
| Tickets abertos | X | Y | ±Z |
|
||||||
|
|
||||||
|
### Pipeline Comercial
|
||||||
|
| Métrica | Valor | Estado |
|
||||||
|
|---------|-------|--------|
|
||||||
|
| Facturação semana ant | {valor} EUR | {vs média} |
|
||||||
|
| Leads novos | X | — |
|
||||||
|
| Propostas pendentes | X | Total: Y EUR |
|
||||||
|
| Propostas aceites | X | Total: Y EUR |
|
||||||
|
|
||||||
|
### Agenda da Semana
|
||||||
|
| Data | Evento |
|
||||||
|
|------|--------|
|
||||||
|
| {DD Mmm} | {evento} |
|
||||||
|
| … | … |
|
||||||
|
|
||||||
|
> Fontes: Desk CRM + Moloni + Google Calendar
|
||||||
|
> Dados Google Analytics / GSC: configurar via /n8n-webhook ou GSC MCP
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Growth Hacker — 1 Acção Para Esta Semana
|
||||||
|
|
||||||
|
**Acção:** [Nome curto e concreto]
|
||||||
|
|
||||||
|
**Porquê agora:** [Justificação baseada nos dados das secções 1 e 2]
|
||||||
|
|
||||||
|
**3 Passos para executar:**
|
||||||
|
|
||||||
|
1. **[Passo 1]** — [Descrição detalhada, quem faz, quando]
|
||||||
|
2. **[Passo 2]** — [Descrição detalhada, ferramentas necessárias]
|
||||||
|
3. **[Passo 3]** — [Métrica de validação: como saber que funcionou]
|
||||||
|
|
||||||
|
**Tempo estimado:** X horas
|
||||||
|
**Impacto esperado:** [Métrica específica]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Reality Checker — Contra-Argumentos
|
||||||
|
|
||||||
|
> Questionar os pressupostos das secções anteriores antes de agir.
|
||||||
|
|
||||||
|
**Sobre as tendências (secção 1):**
|
||||||
|
- [Contra-argumento]: Pode ser que [tendência X] não se aplique porque [razão específica ao contexto Descomplicar]
|
||||||
|
- Pergunta a fazer: Temos capacidade para responder a esta tendência esta semana?
|
||||||
|
|
||||||
|
**Sobre as métricas (secção 2):**
|
||||||
|
- [Contra-argumento]: A variação de [±Z%] pode ser [sazonalidade / evento pontual / dado incompleto]
|
||||||
|
- Atenção: [Métrica Y] está a [subir/descer] — verificar se é tendência real ou ruído
|
||||||
|
|
||||||
|
**Sobre a acção (secção 3):**
|
||||||
|
- [Contra-argumento]: A acção proposta assume que [pressuposto] — validar antes de executar
|
||||||
|
- Risco principal: [O que pode correr mal e como mitigar]
|
||||||
|
- Alternativa mais simples: [Versão reduzida da acção com menor risco]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Próximo briefing: Segunda, {data_prox_segunda} 09:00*
|
||||||
|
*Para agendar: `/schedule "monday-briefing" cron:"0 9 * * 1"`*
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Envio Automático (opcional)
|
||||||
|
|
||||||
|
```
|
||||||
|
SE argumento "email":
|
||||||
|
mcp__google-workspace__gmail_send_email({
|
||||||
|
to: "emanuelalmeidaa@gmail.com",
|
||||||
|
subject: "Monday Briefing — {periodo_atual}",
|
||||||
|
body: {output_markdown_acima},
|
||||||
|
format: "html"
|
||||||
|
})
|
||||||
|
|
||||||
|
SE argumento "inbox" OU sem argumento:
|
||||||
|
Guardar em: /media/ealmeida/Dados/Hub/00-Inbox/monday-briefing-{YYYY-MM-DD}.md
|
||||||
|
Formato: frontmatter YAML + conteúdo markdown
|
||||||
|
|
||||||
|
SE argumento "terminal":
|
||||||
|
Mostrar directamente no terminal (default)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Como Agendar
|
||||||
|
|
||||||
|
Para receber automaticamente todas as segundas às 9h:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Via skill /schedule:
|
||||||
|
/schedule "monday-briefing" cron:"0 9 * * 1"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fontes de Dados
|
||||||
|
|
||||||
|
| Fonte | MCP / Ferramenta | Dados |
|
||||||
|
|-------|-----------------|-------|
|
||||||
|
| Desk CRM | `mcp__desk-crm-v3` | Tarefas, tickets, timesheets, leads, propostas |
|
||||||
|
| Moloni | `mcp__moloni-mcp` | Facturação semanal |
|
||||||
|
| Google Calendar | `mcp__google-workspace` | Agenda da semana |
|
||||||
|
| Tendências | `WebSearch` | Novidades mercado digital |
|
||||||
|
| Google Analytics | n8n BI workflow | Sessions, conversões (a configurar) |
|
||||||
|
| Google Search Console | GSC MCP (quando disponível) | Keywords, cliques orgânicos |
|
||||||
|
|
||||||
|
> GA4 e GSC: quando MCPs dedicados estiverem configurados, adicionar ao Passo 2[A]. Ver `/n8n-webhook` para workflow BI existente.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anti-Patterns
|
||||||
|
|
||||||
|
- NUNCA bloquear o briefing por falta de dados GA4/GSC — usar "N/D" e continuar
|
||||||
|
- NUNCA inventar tendências — apenas WebSearch com fontes verificáveis
|
||||||
|
- NUNCA recomendar mais de 1 acção na secção 3 (Growth Hacker)
|
||||||
|
- SEMPRE usar mcp-time para calcular períodos (nunca assumir datas)
|
||||||
|
- SEMPRE incluir secção Reality Checker — é o que diferencia este briefing
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Healing Log
|
||||||
|
|
||||||
|
```jsonl
|
||||||
|
{"date":"","issue":"","fix":"","source":"user|auto"}
|
||||||
|
```
|
||||||
|
|
||||||
|
*Adicionar nova linha após cada erro corrigido.*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Skill v1.0.0 | 07-04-2026 | Descomplicar®*
|
||||||
Reference in New Issue
Block a user