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:
231
crm-ops/skills/crm-admin/SKILL.md
Normal file
231
crm-ops/skills/crm-admin/SKILL.md
Normal file
@@ -0,0 +1,231 @@
|
||||
---
|
||||
name: crm-admin
|
||||
description: Desk CRM administration and maintenance. Manages users, permissions,
|
||||
custom fields, and system configuration. Use when user mentions "crm admin", "desk
|
||||
admin", "crm configuration", "user management", "crm permissions".
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 1.0.0
|
||||
quality_score: 75
|
||||
user_invocable: true
|
||||
desk_task: 1467
|
||||
---
|
||||
|
||||
# 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__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]
|
||||
```
|
||||
Reference in New Issue
Block a user