From 19f89e0d69330037ebb28605bc6c0d12c2177913 Mon Sep 17 00:00:00 2001 From: Emanuel Almeida Date: Tue, 7 Apr 2026 01:30:00 +0100 Subject: [PATCH] feat(gestao): adicionar skill /monday-briefing v1.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- gestao/skills/monday-briefing/SKILL.md | 255 +++++++++++++++++++++++++ 1 file changed, 255 insertions(+) create mode 100644 gestao/skills/monday-briefing/SKILL.md diff --git a/gestao/skills/monday-briefing/SKILL.md b/gestao/skills/monday-briefing/SKILL.md new file mode 100644 index 0000000..a25c627 --- /dev/null +++ b/gestao/skills/monday-briefing/SKILL.md @@ -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®*