Files
claude-plugins/marketing/skills/lead-approach/SKILL.md
Emanuel Almeida 9404af7ac9 feat: sync all plugins, skills, agents updates
New plugins: core-tools
New skills: auto-expense, ticket-triage, design, security-check,
  aiktop-tasks, daily-digest, imap-triage, index-update, mindmap,
  notebooklm, proc-creator, tasks-overview, validate-component,
  perfex-module, report, calendar-manager
New agents: design-critic, design-generator, design-lead,
  design-prompt-architect, design-researcher, compliance-auditor,
  metabase-analyst, gitea-integration-specialist
Updated: all plugin configs, knowledge datasets, existing skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 17:16:32 +00:00

339 lines
8.4 KiB
Markdown

---
name: lead-approach
description: >
Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo (marketing-planning-expert, sales-manager), consulta datasets Dify, cria documento proposta e actualiza CRM. Use when new lead to approach, abandoned lead recovery, or when user mentions "lead", "abordagem", "proposta", "estratégia comercial", "primeiro contacto".
author: Descomplicar® Crescimento Digital
version: 1.1.0
quality_score: 80
user_invocable: true
category: business
tags: [leads, sales, strategy, approach, marketing, crm, agents, parallel-execution]
desk_task: 1475
desk_project: 65
allowed-tools: Read, Write, Bash, mcp__desk-crm-v3, mcp__dify-kb, WebFetch
mcps: desk-crm-v3, dify-kb
agents:
- name: marketing-planning-expert
usage: Strategy, packages, differentiation
- name: sales-manager
usage: Approach, templates, follow-up
datasets:
- id: c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24
name: Marketing Digital
priority: 1
usage: Lead generation strategies, funnel
- id: a7ba6005-517c-41ab-ac5e-da1c1a1c62ef
name: Vendas
priority: 1
usage: Sales techniques, objection handling
- id: bd65f36e-6004-4584-b478-129b2c21b4d2
name: Serviços Descomplicar
priority: 1
usage: Packages, pricing
- id: c8489151-de94-42b2-8cee-c0b961cfac6d
name: Websites
priority: 2
usage: Website features
dependencies:
skills: [orcamento]
mcps: [desk-crm-v3, dify-kb]
agents: [marketing-planning-expert, sales-manager]
triggers:
- "User mentions 'lead', 'abordagem', 'approach'"
- "New lead to process"
- "Abandoned lead recovery"
- "User says 'estratégia comercial', 'proposta'"
parallel_execution:
enabled: true
agents: [marketing-planning-expert, sales-manager]
performance:
baseline_duration_ms: 1500000
target_duration_ms: 720000
last_run_duration_ms: null
success_rate: 0.90
---
# Skill /lead-approach - Abordagem Estratégica de Leads
Skill para analisar leads e criar estratégia de abordagem completa, usando agentes especializados e datasets Dify.
## Quando Usar
- Novo lead para abordar
- Lead de abandono de formulário
- Lead que não respondeu (reactivação)
- Necessidade de estratégia comercial completa
- Preparar proposta de valor
## Quando NÃO Usar
- Para criar orçamento directo (usar /orcamento)
- Para operações CRM simples (usar /crm-ops)
- Para leads já qualificados com proposta pronta
---
## Protocolo
### Sintaxe
```
/lead-approach [lead_id]
/lead-approach [nome_empresa]
```
**Parâmetros:**
- `lead_id` - ID do lead no CRM (opcional)
- `nome_empresa` - Nome para pesquisar (opcional)
Se nenhum parâmetro fornecido, solicita informação ao utilizador.
## Fluxo de Execução
### Fase 1: Identificação do Lead
1. Se `lead_id` fornecido:
```javascript
mcp__desk-crm-v3__get_leads({ search: lead_id })
```
2. Se `nome_empresa` fornecido:
```javascript
mcp__desk-crm-v3__get_leads({ search: nome_empresa })
```
3. Verificar tickets associados:
```javascript
mcp__desk-crm-v3__get_tickets({ search: email_lead })
```
### Fase 2: Recolha de Dados
**Do CRM:**
- Nome, email, telefone
- Empresa, cargo
- Origem (source)
- Descrição/notas existentes
**Do Ticket (se existir):**
- Serviços pedidos
- Objectivo declarado
- Situação técnica (domínio, alojamento)
**Externa:**
- Website da empresa (WebFetch se existir)
- Redes sociais (Facebook, LinkedIn)
- Google My Business
### Fase 3: Análise Estratégica (Agentes)
**Lançar em paralelo:**
```javascript
// Agente 1: Estratégia de proposta
Task({
subagent_type: "marketing-planning-expert",
model: "sonnet",
prompt: `CONTEXTO DO LEAD:
- Empresa: ${empresa}
- Setor: ${setor}
- Localidade: ${localidade}
- Tamanho: ${colaboradores}
- Situação actual: ${situacao}
O QUE PEDIRAM: ${servicosPedidos}
OBJECTIVO: ${objectivo}
PERGUNTAS:
1. Que tipo de site/solução faz sentido?
2. Estratégia de conteúdo para o setor?
3. Como diferenciareçã de concorrentes?
4. Que pacotes propor? Que valores?
5. Quick wins imediatos?`
});
// Agente 2: Abordagem comercial
Task({
subagent_type: "sales-manager",
model: "sonnet",
prompt: `LEAD: ${nome} - ${cargo}
EMPRESA: ${empresa}
ORIGEM: ${origem}
EMAIL: ${email}
TELEFONE: ${telefone}
SERVIÇOS PEDIDOS: ${servicosPedidos}
OBJECTIVO: ${objectivo}
PERGUNTAS:
1. Como abordar? (canal, timing)
2. Que tom usar?
3. Template email primeiro contacto
4. Script telefónico se não responder
5. Perguntas de qualificação
6. Sequência follow-up`
});
```
### Fase 4: Consultar Datasets Dify
```javascript
// Estratégias de marketing do setor
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
query: `${setor} lead generation estratégia`,
retrieval_mode: "hybrid_search",
top_k: 5
});
// Técnicas de venda
mcp__dify-kb__dify_kb_retrieve_segments({
dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
query: "primeiro contacto lead quente abordagem",
retrieval_mode: "hybrid_search",
top_k: 5
});
```
### Fase 5: Compilar Resultados
Criar documento no vault:
```
01-Projectos/Profissional/PRJ-{Empresa}-Proposta.md
```
**Estrutura do documento:**
- Dados do cliente
- Diagnóstico
- Proposta de valor
- Pacotes/Preços
- ROI projectado
- Timeline
- Template email de abordagem
### Fase 6: Actualizar CRM
```javascript
mcp__desk-crm-v3__update_lead({
lead_id: id,
assigned: 1, // Emanuel
description: `[notas completas com dados recolhidos e estratégia]`
});
```
## Datasets Dify
| Dataset | ID | Usar Para |
|---------|----|-----------|
| Marketing Digital | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégias, funil, leads |
| Vendas | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | Técnicas fecho, objecções |
| Serviços Descomplicar | `bd65f36e-6004-4584-b478-129b2c21b4d2` | Pacotes, preços |
| Websites | `c8489151-de94-42b2-8cee-c0b961cfac6d` | Funcionalidades |
## Agentes Utilizados
| Agente | Função |
|--------|--------|
| `marketing-planning-expert` | Estratégia, pacotes, diferenciação |
| `sales-manager` | Abordagem, templates, follow-up |
## Outputs
1. **Documento proposta** em `01-Projectos/Profissional/`
2. **Lead actualizado** no CRM com dados completos
3. **Template email** pronto a enviar
4. **Estratégia follow-up** documentada
## Exemplos de Uso
### Lead de abandono de formulário
```
User: /lead-approach 215
→ Busca lead #215
→ Encontra ticket associado
→ Extrai dados do formulário
→ Lança agentes em paralelo
→ Cria proposta + estratégia abordagem
→ Documento: PRJ-EmpresaX-Proposta.md
→ Lead actualizado no CRM
```
### Exemplo 2: Lead por nome
```
User: /lead-approach "Century 21"
→ Pesquisa leads com "Century 21"
→ Encontra match
→ Executa workflow completo
→ Consulta datasets Dify
→ Gera estratégia completa
```
### Exemplo 3: Interactivo
```
User: /lead-approach
→ Pergunta: "Qual o lead? (ID ou nome empresa)"
→ Utilizador responde: "João Silva - TechStart"
→ Executa workflow
→ Agentes em paralelo (marketing + sales)
→ Resultado: documento + CRM actualizado
```
## Checklist de Execução
- [ ] Lead identificado no CRM
- [ ] Dados completos extraídos
- [ ] Ticket associado verificado
- [ ] Empresa pesquisada (web, redes)
- [ ] Agente marketing lançado
- [ ] Agente sales lançado
- [ ] Datasets Dify consultados
- [ ] Documento proposta criado
- [ ] Lead actualizado no CRM
- [ ] Template email pronto
## Referências
- `03-Recursos/Procedimentos/PROC-CRM-Operacoes.md`
- `/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv`
- Skill `/orcamento` para preços oficiais
---
**Versão:** 1.0.0 | **Data:** 2026-01-28
---
## Instrumentação Automática
Esta skill grava métricas automaticamente para análise PDCA.
### Baseline
| Métrica | Valor |
|---------|-------|
| Tempo baseline | 25 min |
| Tempo target | 12 min |
| Melhoria esperada | -52% |
### Query para Gravar (executar no final)
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status, staff_id,
kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
'skill', '/lead-approach', {DURACAO_MS}, '{STATUS}', 25,
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```
### Ver Métricas
```bash
/metrics /lead-approach
```
---
**Versão**: 1.1.0 | **Data**: 2026-02-03 | **Instrumentação**: Activa