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>
226 lines
6.5 KiB
Markdown
226 lines
6.5 KiB
Markdown
---
|
|
name: crm-admin
|
|
description: Administração e manutenção do Desk CRM. Gestão de utilizadores, permissões, campos personalizados, configuração de sistema e módulos Perfex.
|
|
disable-model-invocation: true
|
|
---
|
|
|
|
# CRM Admin Specialist
|
|
|
|
Skill para gestão e desenvolvimento Perfex CRM seguindo padrões Descomplicar®.
|
|
|
|
## Quando Usar
|
|
|
|
- Consultas de dados CRM (clientes, projectos, tarefas)
|
|
- Relatórios e analytics de facturação
|
|
- Desenvolvimento de módulos Perfex
|
|
- Automação de processos CRM
|
|
- Integração com sistemas externos
|
|
|
|
## Protocolo Obrigatório
|
|
|
|
### 1. MCP First (SEMPRE)
|
|
Antes de qualquer operação, usar MCPs:
|
|
```
|
|
mcp__desk-crm-v3__get_customers - verificar dados existentes
|
|
mcp__memory-supabase__search_memories "[contexto crm]"
|
|
mcp__wikijs__search_pages "perfex crm [funcionalidade]"
|
|
```
|
|
|
|
### 2. Dados Reais Obrigatórios
|
|
- NUNCA simular dados quando MCPs disponíveis
|
|
- Usar mcp__desk-crm-v3__* para TODAS operações CRM
|
|
- Validar IDs de clientes/projectos antes de modificar
|
|
|
|
### 3. Segurança de Dados
|
|
- NUNCA expor dados sensíveis de clientes em logs
|
|
- Confirmar antes de operações destrutivas (delete)
|
|
- Backup mental do estado antes de modificações bulk
|
|
|
|
## MCPs Disponíveis - DeskCRM v3
|
|
|
|
### Clientes
|
|
```
|
|
mcp__desk-crm-v3__get_customers # Listar (filtros: search, active, country)
|
|
mcp__desk-crm-v3__get_customer # Detalhes (client_id)
|
|
mcp__desk-crm-v3__create_customer # Criar (company obrigatório)
|
|
mcp__desk-crm-v3__update_customer # Actualizar (client_id)
|
|
mcp__desk-crm-v3__customer_analytics # Analytics (client_id, period)
|
|
mcp__desk-crm-v3__search_customers # Pesquisa multi-campo (query, fields)
|
|
```
|
|
|
|
### Projectos
|
|
```
|
|
mcp__desk-crm-v3__get_projects # Listar (status, client_id, billing_type)
|
|
mcp__desk-crm-v3__get_project # Detalhes (project_id)
|
|
mcp__desk-crm-v3__create_project # Criar (name, client_id, billing_type)
|
|
mcp__desk-crm-v3__update_project # Actualizar (project_id)
|
|
mcp__desk-crm-v3__project_analytics # Analytics (period, status)
|
|
```
|
|
|
|
### Tarefas
|
|
```
|
|
mcp__desk-crm-v3__get_tasks # Listar (status, assigned_to, rel_type)
|
|
mcp__desk-crm-v3__get_task # Detalhes (task_id)
|
|
mcp__desk-crm-v3__create_task # Criar (name obrigatório)
|
|
mcp__desk-crm-v3__update_task # Actualizar (task_id)
|
|
mcp__desk-crm-v3__task_analytics # Analytics (period, staff_id)
|
|
```
|
|
|
|
### Leads
|
|
```
|
|
mcp__desk-crm-v3__get_leads # Listar (status, source, assigned)
|
|
mcp__desk-crm-v3__create_lead # Criar (name obrigatório)
|
|
mcp__desk-crm-v3__update_lead # Actualizar (lead_id)
|
|
mcp__desk-crm-v3__convert_lead_to_customer # Converter (lead_id)
|
|
mcp__desk-crm-v3__lead_analytics # Funil e conversões (report_type)
|
|
```
|
|
|
|
### Financeiro
|
|
```
|
|
mcp__desk-crm-v3__get_payments # Pagamentos
|
|
mcp__desk-crm-v3__get_estimates # Orçamentos
|
|
mcp__desk-crm-v3__financial_kpi_dashboard # KPIs (period)
|
|
mcp__desk-crm-v3__profit_loss_statement # DRE (date_from, date_to)
|
|
mcp__desk-crm-v3__cash_flow_statement # Fluxo caixa
|
|
mcp__desk-crm-v3__accounts_receivable_aging # Contas a receber
|
|
```
|
|
|
|
### Tickets/Suporte
|
|
```
|
|
mcp__desk-crm-v3__get_tickets # Listar (status, priority, assigned)
|
|
mcp__desk-crm-v3__create_ticket # Criar (subject, message)
|
|
mcp__desk-crm-v3__reply_ticket # Responder (ticket_id, message)
|
|
mcp__desk-crm-v3__ticket_analytics # Analytics (period, department_id)
|
|
```
|
|
|
|
## Assinatura para Módulos
|
|
|
|
```php
|
|
<?php
|
|
/**
|
|
* [Nome do Módulo/Ficheiro]
|
|
*
|
|
* @author Descomplicar® Crescimento Digital
|
|
* @link https://descomplicar.pt
|
|
* @copyright 2025 Descomplicar®
|
|
*/
|
|
```
|
|
|
|
## Padrões de Relatórios
|
|
|
|
Ao gerar relatórios, incluir:
|
|
1. **Período**: Data início/fim claramente indicada
|
|
2. **Totais**: Agregações relevantes
|
|
3. **Top N**: Rankings quando aplicável
|
|
4. **Comparação**: Com período anterior se relevante
|
|
|
|
## Checklist Consultas
|
|
|
|
- [ ] Usar MCPs para dados reais
|
|
- [ ] Validar IDs antes de operações
|
|
- [ ] Não expor dados sensíveis
|
|
- [ ] Confirmar operações destrutivas
|
|
- [ ] Apresentar dados formatados PT-PT
|
|
|
|
---
|
|
|
|
## Datasets Dify (Consulta Obrigatória)
|
|
|
|
Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:
|
|
|
|
| Dataset | ID | Prioridade |
|
|
|---------|----|-----------:|
|
|
| **PerfexCRM** | `43354eb6-f0b2-40cc-aa53-44e375ab347c` | 1 |
|
|
| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | 2 |
|
|
| **Gestão** | `22799925-8dc5-4a1f-92b9-233468a5048b` | 2 |
|
|
| **Gestão de Processos** | `cae2a27e-f5bc-4d75-8a7a-9f83064f2512` | 3 |
|
|
|
|
### Como Consultar
|
|
|
|
```javascript
|
|
// Pesquisar funcionalidades Perfex
|
|
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
|
|
dataset_id: "43354eb6-f0b2-40cc-aa53-44e375ab347c",
|
|
query: "modulo facturas automaticas"
|
|
})
|
|
|
|
// Pesquisar técnicas de vendas
|
|
mcp__dify-kb__dify_kb_retrieve_segments({
|
|
dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
|
|
query: "pipeline vendas conversao"
|
|
})
|
|
```
|
|
|
|
### Quando Consultar
|
|
|
|
- Desenvolver módulos Perfex CRM
|
|
- Configurar automações de vendas
|
|
- Optimizar processos de facturação
|
|
- Implementar workflows de gestão de clientes
|
|
|
|
---
|
|
**Versão**: 1.0.0 | **Autor**: Descomplicar®
|
|
|
|
---
|
|
|
|
## Instrumentação Automática
|
|
|
|
Esta skill grava métricas automaticamente para análise PDCA.
|
|
|
|
### 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', '/$SKILL_NAME', {DURACAO_MS}, '{STATUS}', 25,
|
|
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
|
);
|
|
```
|
|
|
|
---
|
|
|
|
**Instrumentação**: Activa | **Data**: 2026-02-03
|
|
|
|
---
|
|
|
|
|
|
## Quando NÃO Usar
|
|
|
|
- Para tarefas fora do domínio de especialização desta skill
|
|
- Quando outra skill mais específica está disponível
|
|
- Para operações que requerem aprovação manual obrigatória
|
|
- Quando os requisitos não estão claramente definidos
|
|
|
|
|
|
## Exemplos de Uso
|
|
|
|
### Exemplo 1: Caso Básico
|
|
```
|
|
User: [requisição simples relacionada com crm-admin]
|
|
Skill: [execução directa com validação]
|
|
Output: [resultado conciso e accionável]
|
|
```
|
|
|
|
### Exemplo 2: Caso Complexo
|
|
```
|
|
User: [requisição multi-passo ou complexa]
|
|
Skill:
|
|
1. Análise dos requisitos
|
|
2. Planeamento da abordagem
|
|
3. Execução faseada
|
|
4. Validação contínua
|
|
Output: [resultado detalhado com próximos passos]
|
|
```
|
|
|
|
### Exemplo 3: Caso com Dependências
|
|
```
|
|
User: [requisição que depende de outros sistemas]
|
|
Skill:
|
|
1. Verificar dependências disponíveis
|
|
2. Coordenar com skills/MCPs necessários
|
|
3. Executar workflow integrado
|
|
Output: [resultado completo com referências]
|
|
```
|