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:
445
negocio/skills/ecommerce/SKILL.md
Normal file
445
negocio/skills/ecommerce/SKILL.md
Normal file
@@ -0,0 +1,445 @@
|
||||
---
|
||||
name: ecommerce
|
||||
description: Skill especializada em estratégia e arquitectura de e-commerce, cobrindo
|
||||
desde a escolha de plataforma até optimização de conversão.
|
||||
author: Descomplicar® Crescimento Digital
|
||||
version: 2.0.0
|
||||
quality_score: 55
|
||||
user_invocable: true
|
||||
desk_task: null
|
||||
allowed-tools: Task
|
||||
---
|
||||
|
||||
# Skill /ecommerce - E-commerce Strategy & Architecture
|
||||
|
||||
Skill especializada em estratégia e arquitectura de e-commerce, cobrindo desde a escolha de plataforma até optimização de conversão.
|
||||
|
||||
## Sintaxe
|
||||
|
||||
```
|
||||
/ecommerce [operacao] [contexto]
|
||||
```
|
||||
|
||||
**Operações:**
|
||||
- `analise` - Análise de projecto e-commerce existente ou novo
|
||||
- `plataforma` - Recomendação de plataforma (WooCommerce vs Shopify vs custom)
|
||||
- `funil` - Análise e optimização do funil de conversão
|
||||
- `integracao` - Planeamento de integrações (ERP, pagamentos, logística)
|
||||
- `pricing` - Estratégia de preços e promoções
|
||||
|
||||
## Quando Usar
|
||||
|
||||
- Cliente quer abrir loja online
|
||||
- Optimizar conversão de e-commerce existente
|
||||
- Integração com ERP/facturação/logística
|
||||
- Migração entre plataformas
|
||||
- Estratégia omnichannel
|
||||
|
||||
---
|
||||
|
||||
## Protocolo de Execução
|
||||
|
||||
### 1. Discovery (SEMPRE começar aqui)
|
||||
|
||||
**Questões chave:**
|
||||
```
|
||||
Modelo de negócio:
|
||||
- [ ] B2C, B2B ou D2C?
|
||||
- [ ] Único vendedor ou marketplace?
|
||||
- [ ] Produtos físicos ou digitais?
|
||||
|
||||
Catálogo:
|
||||
- [ ] Quantos SKUs?
|
||||
- [ ] Variações por produto (tamanhos, cores)?
|
||||
- [ ] Stock centralizado ou múltiplos armazéns?
|
||||
|
||||
Volume esperado:
|
||||
- [ ] Ticket médio?
|
||||
- [ ] Pedidos/mês estimados?
|
||||
- [ ] Sazonalidade?
|
||||
|
||||
Integrações:
|
||||
- [ ] ERP existente (PHC, Primavera, SAP)?
|
||||
- [ ] Gateway pagamento preferido?
|
||||
- [ ] Transportadoras (CTT, DPD, GLS)?
|
||||
```
|
||||
|
||||
### 2. Escolha de Plataforma
|
||||
|
||||
**Matriz de Decisão:**
|
||||
|
||||
| Critério | WooCommerce | Shopify | Custom |
|
||||
|----------|-------------|---------|--------|
|
||||
| **Custo inicial** | 1.100€ (eCommerceWP) | ~200€/mês | 5.000€+ |
|
||||
| **Escalabilidade** | Até 5k pedidos/mês | Ilimitado | Ilimitado |
|
||||
| **Customização** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| **Integrações PT** | ⭐⭐⭐⭐ (MB, CTT, Moloni) | ⭐⭐ | ⭐⭐⭐⭐⭐ |
|
||||
| **Manutenção** | Média (WordPress) | Baixa (hosted) | Alta |
|
||||
| **Time to market** | 7-9 semanas | 4-6 semanas | 3-6 meses |
|
||||
|
||||
**Recomendação Descomplicar:**
|
||||
- **< 1.000 SKUs + orçamento < 3k** → eCommerceWP (WooCommerce)
|
||||
- **> 1.000 SKUs + escalabilidade prioritária** → Shopify Plus
|
||||
- **Processos únicos + integração ERP complexa** → Custom Laravel + Vue
|
||||
|
||||
### 3. Arquitectura Técnica
|
||||
|
||||
```
|
||||
┌─────────────┐
|
||||
│ FRONTEND │ CDN (Cloudflare)
|
||||
│ (Site) │ Cache (Varnish/Redis)
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌──────▼──────┐
|
||||
│ API │ REST/GraphQL
|
||||
│ (Backend) │ Rate limiting
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌──────▼──────────────────┐
|
||||
│ INTEGRAÇÕES │
|
||||
├─────────────────────────┤
|
||||
│ Pagamentos (Stripe/MB) │
|
||||
│ Facturação (Moloni) │
|
||||
│ Stock (ERP) │
|
||||
│ Envios (CTT/DPD) │
|
||||
│ Marketing (GA4/Meta) │
|
||||
└─────────────────────────┘
|
||||
```
|
||||
|
||||
### 4. Funil de Conversão
|
||||
|
||||
**Benchmarks e Optimizações:**
|
||||
|
||||
```
|
||||
🔍 VISITANTES (tráfego)
|
||||
│
|
||||
├─ Bounce Rate < 40% (target)
|
||||
│ ► Home clara e rápida (< 2s)
|
||||
│ ► Proposta de valor visível
|
||||
▼
|
||||
📦 PRODUTO (categoria/pesquisa)
|
||||
│
|
||||
├─ Add to Cart Rate > 8%
|
||||
│ ► Fotos profissionais (min 5 por produto)
|
||||
│ ► Descrições completas
|
||||
│ ► Reviews e avaliações
|
||||
│ ► Stock e prazo entrega visíveis
|
||||
▼
|
||||
🛒 CARRINHO
|
||||
│
|
||||
├─ Cart Abandonment < 70%
|
||||
│ ► Recuperação automática (CartRecovery)
|
||||
│ ► Custos envio antecipados
|
||||
│ ► Checkout em 1 página
|
||||
▼
|
||||
💳 CHECKOUT
|
||||
│
|
||||
├─ Completion Rate > 50%
|
||||
│ ► Guest checkout permitido
|
||||
│ ► MB Way + Multibanco + Cartão
|
||||
│ ► Campos mínimos
|
||||
▼
|
||||
✅ COMPRA
|
||||
│
|
||||
├─ Repeat Rate > 20%
|
||||
│ ► Email pós-compra (obrigado)
|
||||
│ ► Programa fidelização
|
||||
│ ► Recomendações personalizadas
|
||||
▼
|
||||
🔁 RECOMPRA
|
||||
```
|
||||
|
||||
**Triggers de Abandono (CartRecovery):**
|
||||
- Email 1h depois: "Esqueceu algo?"
|
||||
- Email 24h depois: "Ainda disponível" + urgência
|
||||
- Email 48h depois: Desconto 5-10%
|
||||
|
||||
---
|
||||
|
||||
## Integrações Essenciais
|
||||
|
||||
### Pagamentos (Portugal)
|
||||
|
||||
| Gateway | Custo | Tempo Integração | Usar Quando |
|
||||
|---------|-------|------------------|-------------|
|
||||
| **MB Way + Multibanco** | Gratuito (IFTHENPAY) | 2h | Obrigatório PT |
|
||||
| **Stripe** | 1.4% + 0.25€ | 4h | Cartões internacionais |
|
||||
| **PayPal** | 3.4% + 0.35€ | 1h | Compradores sem cartão |
|
||||
|
||||
### Facturação
|
||||
|
||||
| Sistema | Custo | Integração | Notas |
|
||||
|---------|-------|-----------|-------|
|
||||
| **Moloni** | 15€/mês | API (MCP disponível) | Recomendado Descomplicar |
|
||||
| **InvoiceXpress** | 20€/mês | API | Mais features |
|
||||
| **Manual** | Grátis | - | Só para < 10 pedidos/mês |
|
||||
|
||||
### Logística
|
||||
|
||||
| Transportadora | API | Tracking | Custo Setup |
|
||||
|----------------|-----|----------|-------------|
|
||||
| **CTT Expresso** | ✅ | ✅ | 0€ (conta empresa) |
|
||||
| **DPD Portugal** | ✅ | ✅ | 0€ |
|
||||
| **GLS** | ✅ | ✅ | 0€ |
|
||||
| **InPost** | ✅ | ✅ (lockers) | 0€ |
|
||||
|
||||
**Recomendação:** Múltiplas opções + cálculo automático no checkout.
|
||||
|
||||
### Marketing & Analytics
|
||||
|
||||
```javascript
|
||||
// Stack completo e-commerce
|
||||
Google Analytics 4 (obrigatório)
|
||||
Meta Pixel (Facebook/Instagram Ads)
|
||||
Google Tag Manager (gestão tags)
|
||||
Hotjar/Microsoft Clarity (heatmaps)
|
||||
Klaviyo/Mailchimp (email marketing)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Métricas Chave (KPIs)
|
||||
|
||||
### Conversão
|
||||
|
||||
| Métrica | Benchmark | Como Medir |
|
||||
|---------|-----------|------------|
|
||||
| **Conversion Rate** | 2-3% | Compras / Visitantes |
|
||||
| **Add to Cart Rate** | 8-12% | Adicionar carrinho / Views produto |
|
||||
| **Cart Abandonment** | 65-70% | Carrinhos abandonados / Total |
|
||||
| **Checkout Completion** | 50-60% | Compras / Início checkout |
|
||||
|
||||
### Receita
|
||||
|
||||
| Métrica | Fórmula | Target |
|
||||
|---------|---------|--------|
|
||||
| **AOV** (Avg Order Value) | Receita / Nº pedidos | Sector-dependent |
|
||||
| **CLV** (Customer Lifetime Value) | AOV × Compras médias × Margem | > 3× CAC |
|
||||
| **CAC** (Customer Acquisition Cost) | Investimento marketing / Novos clientes | < 1/3 CLV |
|
||||
| **Repeat Purchase Rate** | Clientes repetentes / Total clientes | > 20% |
|
||||
|
||||
### Operacional
|
||||
|
||||
```
|
||||
- Stock turnover: Vendas / Stock médio (> 6× ano)
|
||||
- Order fulfillment time: < 24h
|
||||
- Return rate: < 5%
|
||||
- Customer support tickets/order: < 10%
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Checklist Lançamento E-commerce
|
||||
|
||||
**Pré-Lançamento:**
|
||||
```
|
||||
[ ] Catálogo completo (fotos + descrições + preços)
|
||||
[ ] Stock actualizado e sincronizado
|
||||
[ ] Políticas publicadas (devolução, privacidade, T&C)
|
||||
[ ] Gateways pagamento testados (transações reais)
|
||||
[ ] Envios configurados e custos correctos
|
||||
[ ] Emails transaccionais personalizados
|
||||
[ ] SSL activo em todo o site
|
||||
[ ] Mobile responsive verificado
|
||||
```
|
||||
|
||||
**Marketing:**
|
||||
```
|
||||
[ ] Google Analytics 4 instalado e a rastrear
|
||||
[ ] Meta Pixel activo
|
||||
[ ] Google Merchant Center configurado
|
||||
[ ] SEO básico (títulos, meta descriptions, structured data)
|
||||
[ ] Sitemap XML enviado
|
||||
```
|
||||
|
||||
**Operacional:**
|
||||
```
|
||||
[ ] Teste end-to-end (compra completa)
|
||||
[ ] Processo de fulfillment documentado
|
||||
[ ] Equipa treinada (gestão pedidos + suporte)
|
||||
[ ] Plano de contingência (stock out, pagamentos falhados)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Integração com Descomplicar
|
||||
|
||||
### Pacote eCommerceWP
|
||||
|
||||
**Incluído (1.100€ setup + 349€/ano):**
|
||||
- WooCommerce configurado
|
||||
- MB Way + Multibanco (IFTHENPAY)
|
||||
- 3 gateways envio
|
||||
- Integração Moloni (facturação)
|
||||
- 50 produtos configurados
|
||||
- Google Analytics 4
|
||||
- Meta Pixel
|
||||
|
||||
**Add-ons Comuns:**
|
||||
```
|
||||
ShopBuilder: 5€/produto extra (> 50)
|
||||
CartRecovery: 190€ setup + 90€/ano
|
||||
Subscriptions: 150€ (produtos recorrentes)
|
||||
Marketplaces (Amazon/eBay): 300€ integração
|
||||
```
|
||||
|
||||
### Workflow Projecto
|
||||
|
||||
```
|
||||
1. Discovery (2-3h)
|
||||
- Questionário cliente
|
||||
- Análise concorrência
|
||||
- Proposta plataforma
|
||||
|
||||
2. Planeamento (1 semana)
|
||||
- Arquitectura técnica
|
||||
- Mapeamento integrações
|
||||
- Wireframes checkout
|
||||
|
||||
3. Desenvolvimento (4-6 semanas)
|
||||
- Setup plataforma
|
||||
- Design frontend
|
||||
- Configuração produtos
|
||||
- Testes pagamentos
|
||||
|
||||
4. Lançamento (1 semana)
|
||||
- Migração dados (se aplicável)
|
||||
- Testes finais
|
||||
- Formação cliente
|
||||
- Go-live
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Consultar Datasets Dify
|
||||
|
||||
**SEMPRE antes de propor solução:**
|
||||
|
||||
| Dataset | ID | Query Exemplo |
|
||||
|---------|----|--------------:|
|
||||
| **Marketing Digital** | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | "funil conversao ecommerce optimizacao" |
|
||||
| **Vendas** | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | "estrategia pricing loja online" |
|
||||
| **Desenvolvimento WebSites** | `c8489151-de94-42b2-8cee-c0b961cfac6d` | "woocommerce gateways pagamento portugal" |
|
||||
| **Serviços Descomplicar** | `bd65f36e-6004-4584-b478-129b2c21b4d2` | "pacote ecommerce funcionalidades" |
|
||||
|
||||
### Como Consultar
|
||||
|
||||
```javascript
|
||||
// Estratégia de conversão
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
|
||||
query: "optimizar taxa conversao checkout abandono carrinho",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
|
||||
// Pricing e margens
|
||||
mcp__dify-kb__dify_kb_retrieve_segments({
|
||||
dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
|
||||
query: "estrategia precos markup ecommerce",
|
||||
retrieval_mode: "hybrid_search",
|
||||
top_k: 5
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MCPs Utilizados
|
||||
|
||||
```
|
||||
mcp__desk-crm-v3__get_projects # Verificar projectos e-commerce
|
||||
mcp__desk-crm-v3__create_estimate # Orçamento eCommerceWP
|
||||
mcp__dify-kb__dify_kb_retrieve_segments # Conhecimento estratégico
|
||||
mcp__moloni__* # Integração facturação
|
||||
mcp__web-fetch__* # Análise concorrência
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Exemplos de Uso
|
||||
|
||||
### 1. Novo Projecto E-commerce
|
||||
```
|
||||
/ecommerce analise
|
||||
→ Discovery interactivo
|
||||
→ Consulta Dify KB (benchmarks sector)
|
||||
→ Recomendação plataforma
|
||||
→ Proposta Descomplicar (orçamento)
|
||||
```
|
||||
|
||||
### 2. Optimização Conversão
|
||||
```
|
||||
/ecommerce funil
|
||||
→ Análise métricas actuais (GA4)
|
||||
→ Identificação bottlenecks
|
||||
→ Recomendações prioritizadas (quick wins)
|
||||
→ Plano implementação
|
||||
```
|
||||
|
||||
### 3. Integrações
|
||||
```
|
||||
/ecommerce integracao
|
||||
→ Levantamento sistemas existentes
|
||||
→ Mapeamento fluxos dados
|
||||
→ Proposta arquitectura
|
||||
→ Timeline e custos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agentes Recomendados
|
||||
|
||||
Para análises complexas, delegar a agentes:
|
||||
|
||||
```javascript
|
||||
// Estratégia marketing
|
||||
Task({
|
||||
subagent_type: "marketing-planning-expert",
|
||||
model: "sonnet",
|
||||
prompt: "Analisar funil e-commerce [URL]. Propor optimizações conversion rate."
|
||||
});
|
||||
|
||||
// Arquitectura técnica
|
||||
Task({
|
||||
subagent_type: "php-fullstack-engineer",
|
||||
model: "sonnet",
|
||||
prompt: "Integração WooCommerce → Moloni → CTT API. Arquitectura e fluxo."
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instrumentação Automática
|
||||
|
||||
Esta skill grava métricas automaticamente para análise PDCA.
|
||||
|
||||
### Baseline
|
||||
|
||||
| Métrica | Valor |
|
||||
|---------|-------|
|
||||
| Tempo baseline | 40 min |
|
||||
| Tempo target | 20 min |
|
||||
| Melhoria esperada | -50% |
|
||||
|
||||
### 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', '/ecommerce', {DURACAO_MS}, '{STATUS}', 25,
|
||||
{KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
|
||||
);
|
||||
```
|
||||
|
||||
### Ver Métricas
|
||||
|
||||
```bash
|
||||
/metrics /ecommerce
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Versão**: 2.0.0 | **Data**: 2026-02-03 | **Autor**: Descomplicar®
|
||||
**Instrumentação**: Activa
|
||||
Reference in New Issue
Block a user