ealmeida/claude-plugins
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: sync all plugins, skills, agents updates

Browse Source 
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>
This commit is contained in:
Emanuel Almeida
2026-03-05 17:16:15 +00:00
parent f2b5171ea2
commit 9404af7ac9
184 changed files with 20865 additions and 1993 deletions
Download Patch File Download Diff File Expand all files Collapse all files

121
core-tools/skills/_core/SKILL.md Normal file
View File

@@ -0,0 +1,121 @@
---
name: core-descomplicar
description: Padrões fundamentais Descomplicar® - Sacred Rules, Excellence Standards, MCP Protocol. Skill base para todos os agentes.
quality_score: 40
---
# Core Standards Descomplicar®
Padrões obrigatórios para todos os agentes do sistema.
---
## 🔟 REGRAS SAGRADAS
### 1. É permitido falhar
Reportar erros com transparência. Falhar rápido, aprender mais rápido.
### 2. Transparência e honestidade
Comunicar claramente. Não omitir informações.
### 3. Más notícias primeiro
Escalar problemas imediatamente.
### 4. Foco na resolução
Todo problema deve incluir soluções propostas.
### 5. Nunca prejudicar
Princípio "do no harm". Proteger dados e sistemas.
### 6. Passar a bola certa
Delegar para o especialista quando necessário.
### 7. 3x antes de escalar
Três tentativas documentadas antes de escalação.
### 8. Feedback protocol
Crítica privada, elogio público.
### 9. Perguntar sempre
Pedir esclarecimento quando incerto.
### 10. Crescimento contínuo
Mentalidade de aprendizagem constante.
---
## 🎯 PADRÕES DE EXCELÊNCIA
### Qualidade Mínima: 100/100
- **Precisão**: 100% informação verificada
- **Completude**: Especificações cumpridas
- **Consistência**: Alinhamento com padrões
- **Usabilidade**: Solução funcional
- **Manutenibilidade**: Sustentável longo prazo
### Dados Reais Obrigatórios
**NUNCA simular quando dados reais existem.**
Hierarquia:
1. MCPs especializados (desk-crm, dify-kb, wikijs)
2. Sistemas internos (Gitea, Drive)
3. Documentação oficial (Context7)
4. Simulação APENAS se dados não existem
---
## ⚡ PROTOCOLO MCP (3 PASSOS)
### PASSO 1: Recuperação de Contexto
```
SEMPRE EXECUTAR PRIMEIRO:
1. mcp__memory-supabase__search_memories → Experiência histórica
2. mcp__wikijs__search_pages → Documentação interna
3. mcp__dify-kb__dify_kb_retrieve_segments → Knowledge base temática
```
### PASSO 2: Hierarquia de Fontes
```
🥇 1ª: MCPs especializados (memory-supabase, dify-kb, desk-crm-v3)
🥈 2ª: MCPs de sistema (wikijs, filesystem, google-workspace)
🥉 3ª: MCPs complementares (context7, puppeteer)
🔧 ÚLTIMO: Ferramentas nativas Claude
```
### PASSO 3: Captura de Aprendizagem
```
SEMPRE GUARDAR ao final:
mcp__memory-supabase__save_memory {
"content": "[Resumo do trabalho e decisões]",
"tags": ["[área]", "[projecto]", "[tipo]"]
}
```
---
## ✅ CHECKLIST PRE-ENTREGA
- [ ] Dados verificados com fontes reais
- [ ] Qualidade técnica validada (100/100)
- [ ] Padrões Descomplicar® seguidos
- [ ] Documentação clara
- [ ] Testes executados (quando aplicável)
- [ ] Aprendizagens capturadas
---
## 📝 OUTPUT
- **Assinatura**: `/** @author Descomplicar® | @link descomplicar.pt | @copyright 2026 */`
- **Markdown**: Obsidian-ready (frontmatter, wikilinks, callouts)
- **Língua**: Português Europeu (PT-PT)
- **Monetário**: 95€ (não 95,00€)
---
*Core Standards v1.0 | 2026-01-27*

283
core-tools/skills/_core/datasets-mapping.json Normal file
View File

@@ -0,0 +1,283 @@
{
"mapping": {
"analytics-insights-agent": {
"model": "haiku",
"tools": ["Read", "Glob", "Grep"],
"datasets": ["Marketing Digital", "Gestão de Marketing", "SEO (Search Engine Optimization)", "Gestão de Tráfego"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"},
{"id": "4c595973-ba10-420a-a3bf-e4389e424ad3", "title": "Marketing Digital PT"}
]
},
"automation-lead": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["n8n", "Ferramentas de Automação e IA", "Dify", "Flowise"],
"notebooks": [
{"id": "f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1", "title": "n8n"},
{"id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8", "title": "Transformacao Digital e IA"},
{"id": "929ef67b-c131-4f01-abd0-8b078491a6b7", "title": "AI Automation Stack"}
]
},
"backup-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Bash", "Glob", "Grep"],
"datasets": ["TI (Tecnologia da Informação)", "Linux", "CWP Centos Web Panel", "AWS (Amazon Web Services)"],
"notebooks": [
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"},
{"id": "0ded7bd6-69b3-4c76-b327-452396bf7ea7", "title": "CWP"}
]
},
"content-manager": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Marketing de Conteúdo", "Copywriting", "Blogging", "Marketing Digital"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"},
{"id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323", "title": "Copywriting e Persuasao"}
]
},
"copywriter": {
"model": "sonnet",
"tools": ["Read", "Write", "Glob", "Grep"],
"datasets": ["Copywriting", "Marketing de Conteúdo", "Escrever PT-PT", "Branding"],
"notebooks": [
{"id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323", "title": "Copywriting e Persuasao"},
{"id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "title": "Social Media e Branding"}
]
},
"crm-admin-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["PerfexCRM", "Gestão", "Gestão de Processos"],
"notebooks": [
{"id": "df4688bb-c2c0-4aba-98c1-38c3b50a353c", "title": "Perfex CRM: Gestao de Clientes e Projetos"},
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "f9dc59c2-718b-4b12-bd06-095d4bfa3e34", "title": "Gestao de Operacoes"}
]
},
"cwp-server-manager": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["CWP Centos Web Panel", "Linux", "TI (Tecnologia da Informação)"],
"notebooks": [
{"id": "0ded7bd6-69b3-4c76-b327-452396bf7ea7", "title": "CWP"},
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"database-design-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["TI (Tecnologia da Informação)", "Desenvolvimento de Software", "AWS (Amazon Web Services)"],
"notebooks": [
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"}
]
},
"dev-helper": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["Desenvolvimento de Software", "TI (Tecnologia da Informação)", "Claude Code"],
"notebooks": [
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"},
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"},
{"id": "2876d1fe-5cea-4d98-8140-b0e1a81c6bc4", "title": "Claude Code"}
]
},
"development-lead": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["Desenvolvimento de Software", "Gestão de Projetos", "Estratégia"],
"notebooks": [
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"},
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"}
]
},
"easypanel-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["TI (Tecnologia da Informação)", "Linux", "AWS (Amazon Web Services)"],
"notebooks": [
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"finance-manager": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Gestão", "Estratégia", "Estratégia Descomplicar"],
"notebooks": [
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"},
{"id": "f29c8457-f16d-4fb3-979d-6e5901de1b20", "title": "Descomplicar: Marketing Digital"}
]
},
"javascript-fullstack-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["Desenvolvimento de Software", "TI (Tecnologia da Informação)"],
"notebooks": [
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"},
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"lead-qualifier": {
"model": "haiku",
"tools": ["Read", "Glob", "Grep"],
"datasets": ["Vendas", "Marketing Digital", "PerfexCRM"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"},
{"id": "df4688bb-c2c0-4aba-98c1-38c3b50a353c", "title": "Perfex CRM: Gestao de Clientes e Projetos"}
]
},
"marketing-planning-expert": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Marketing Digital", "Gestão de Marketing", "Estratégia", "Marketing Redes Sociais"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"},
{"id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "title": "Social Media e Branding"}
]
},
"master-orchestrator": {
"model": "opus",
"tools": ["Task", "Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["Gestão de Projetos", "Gestão", "Estratégia", "Estratégia Descomplicar"],
"notebooks": [
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"},
{"id": "f29c8457-f16d-4fb3-979d-6e5901de1b20", "title": "Descomplicar: Marketing Digital"}
]
},
"mcp-protocol-developer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["MCP Servers", "Claude Code", "Desenvolvimento de Software"],
"notebooks": [
{"id": "73102308-70ef-403e-9be9-eae0cfc62d55", "title": "Desenvolvimento de MCPs"},
{"id": "2876d1fe-5cea-4d98-8140-b0e1a81c6bc4", "title": "Claude Code"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"}
]
},
"n8n-automation-expert": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["n8n", "Ferramentas de Automação e IA", "Dify"],
"notebooks": [
{"id": "f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1", "title": "n8n"},
{"id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8", "title": "Transformacao Digital e IA"},
{"id": "929ef67b-c131-4f01-abd0-8b078491a6b7", "title": "AI Automation Stack"}
]
},
"perfex-crm-module-developer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["PerfexCRM", "Desenvolvimento de Software"],
"notebooks": [
{"id": "df4688bb-c2c0-4aba-98c1-38c3b50a353c", "title": "Perfex CRM: Gestao de Clientes e Projetos"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"}
]
},
"performance-optimization-engineer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["TI (Tecnologia da Informação)", "Desenvolvimento de Software", "AWS (Amazon Web Services)"],
"notebooks": [
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"}
]
},
"php-fullstack-engineer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["Desenvolvimento de Software", "WordPress", "TI (Tecnologia da Informação)"],
"notebooks": [
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"},
{"id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "title": "WordPress e Elementor"},
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"project-manager": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Gestão de Projetos", "Gestão", "Estratégia"],
"notebooks": [
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"}
]
},
"sales-manager": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Vendas", "Marketing Digital", "PerfexCRM"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"},
{"id": "df4688bb-c2c0-4aba-98c1-38c3b50a353c", "title": "Perfex CRM: Gestao de Clientes e Projetos"}
]
},
"security-compliance-specialist": {
"model": "opus",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["TI (Tecnologia da Informação)", "Linux", "AWS (Amazon Web Services)"],
"notebooks": [
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"seo-specialist": {
"model": "haiku",
"tools": ["Read", "Glob", "Grep"],
"datasets": ["SEO (Search Engine Optimization)", "Marketing Digital", "Marketing de Conteúdo"],
"notebooks": [
{"id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "title": "Marketing Digital Avancado"}
]
},
"software-project-planner": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Gestão de Projetos", "Desenvolvimento de Software", "Estratégia"],
"notebooks": [
{"id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "title": "Gestao de Projectos e Agile"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"},
{"id": "79d43410-0e29-4be1-881d-84db6bdc239a", "title": "Estrategia e Empreendedorismo"}
]
},
"ui-designer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["UX e Usabilidade", "Desenvolvimento de WebSites", "Canva"],
"notebooks": [
{"id": "081ca512-8279-4850-b2b9-dff090267482", "title": "UI/UX Design"},
{"id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "title": "WordPress e Elementor"},
{"id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "title": "Social Media e Branding"}
]
},
"web-designer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Glob", "Grep"],
"datasets": ["Desenvolvimento de WebSites", "WordPress", "Elementor", "UX e Usabilidade"],
"notebooks": [
{"id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "title": "WordPress e Elementor"},
{"id": "081ca512-8279-4850-b2b9-dff090267482", "title": "UI/UX Design"}
]
},
"wordpress-performance-specialist": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["WordPress", "Elementor", "Crocoblock", "TI (Tecnologia da Informação)"],
"notebooks": [
{"id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "title": "WordPress e Elementor"},
{"id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "title": "Cloud e Infraestrutura TI"}
]
},
"wordpress-plugin-developer": {
"model": "sonnet",
"tools": ["Read", "Write", "Edit", "Bash", "Glob", "Grep"],
"datasets": ["WordPress", "Crocoblock", "Elementor", "Desenvolvimento de Software"],
"notebooks": [
{"id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "title": "WordPress e Elementor"},
{"id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "title": "Programacao"}
]
}
}
}

128
core-tools/skills/_core/dify-integration-protocol.md Normal file
View File

@@ -0,0 +1,128 @@
# Protocolo de Knowledge Sources v2.0
**Data:** 2026-02-12
**Propósito:** Consulta inteligente de conhecimento com dual-source (NotebookLM + Dify KB)
---
## Visão Geral
Skills e agents consultam conhecimento via dual-source:
1. **NotebookLM** (primario) - Gemini 2.5 RAG com conhecimento curado
2. **Dify KB** (fallback) - Datasets tematicos quando NotebookLM insuficiente
## Fluxo de Consulta
```
1. Skill/Agent precisa conhecimento
2. Consultar NotebookLM (primario)
→ mcp__notebooklm__notebook_query notebook_id:"<id>" query:"<tema>"
3. Se resultado suficiente → usar
4. Se insuficiente → consultar Dify KB (fallback)
→ mcp__dify-kb__dify_kb_retrieve_segments dataset:"<nome>" query:"<tema>"
5. Agregar resultados
```
## Como Consultar NotebookLM (Primario)
### 1. Identificar Notebook (via notebooklm-mapping.json)
```javascript
// Ler mapeamento
const mapping = require('./notebooklm-mapping.json').mapping;
const notebook = mapping['WordPress'];
// → {notebook_id: "5be0d1a6-...", notebook_title: "WordPress e Elementor"}
```
### 2. Consultar Notebook
```
mcp__notebooklm__notebook_query notebook_id:"5be0d1a6-00f2-4cd9-b835-978cb7721601" query:"elementor custom widgets"
```
### 3. Múltiplos Notebooks
Quando o tema cobre vários notebooks, consultar em paralelo:
```
# Paralelo: WordPress + Dev
mcp__notebooklm__notebook_query notebook_id:"5be0d1a6-..." query:"tema"
mcp__notebooklm__notebook_query notebook_id:"24947ffa-..." query:"tema"
```
## Como Consultar Dify KB (Fallback)
### 1. Identificar Dataset
```javascript
mcp__dify-kb__dify_kb_retrieve_segments({
dataset: "WordPress",
query: "elementor custom widgets",
top_k: 5
});
```
### 2. Consulta Paralela (Múltiplos Datasets)
```javascript
// Lançar consultas em paralelo para datasets prioritarios
const results = await Promise.all([
dify_kb_retrieve(dataset1, query),
dify_kb_retrieve(dataset2, query)
]);
```
## Mapeamento Notebooks
Ficheiro central: `notebooklm-mapping.json` (mesmo directorio)
51 notebooks disponiveis cobrindo:
- Marketing (5 notebooks)
- Desenvolvimento (8 notebooks)
- Infraestrutura (3 notebooks)
- Gestao (3 notebooks)
- Negocio (4 notebooks)
- Automacao (3 notebooks)
- Design (2 notebooks)
## Template para Agents
Secção standard nos agents:
```markdown
## Knowledge Sources (Consultar SEMPRE)
### NotebookLM (Primario - usar PRIMEIRO)
```
mcp__notebooklm__notebook_query notebook_id:"<uuid>" query:"<tema>"
```
### Dify KB (Secundario - se NotebookLM insuficiente)
```
mcp__dify-kb__dify_kb_retrieve_segments dataset:"<nome>" query:"<tema>"
```
```
## Template para Skills
Adicionar no SKILL.md:
```markdown
# PRIMARIO: NotebookLM (Gemini 2.5 RAG)
# mcp__notebooklm__notebook_query notebook_id:"<uuid>"
# FALLBACK: Dify KB
mcp__dify-kb__dify_kb_retrieve_segments dataset:"<nome>" query:"<tema>"
```
## Metricas
Rastrear na instrumentacao:
- `kb_source`: "notebooklm" ou "dify"
- `kb_consulted`: 1 se consultou KB
- `kb_fallback`: 1 se precisou de Dify apos NotebookLM
---
**Protocolo v2.0** | 2026-02-12 | Dual-source (NotebookLM + Dify KB)

157
core-tools/skills/_core/instrumentation-protocol.md Normal file
View File

@@ -0,0 +1,157 @@
# Protocolo de Instrumentação Automática v1.0
**Data:** 2026-02-03
**Propósito:** Auto-registar métricas de execução de skills para análise PDCA
---
## Visão Geral
Toda skill instrumentada deve gravar automaticamente métricas de execução na tabela `tblskill_agent_metrics` do Desk CRM.
## Quando Instrumentar
Skills que:
- Têm baseline definido em `_knowledge-map.json`
- São frequentemente usadas (>5x/semana)
- Estão em processo de optimização
## Estrutura de Instrumentação
### 1. Início de Execução
Ao iniciar a skill, registar:
```javascript
const SKILL_START = Date.now();
const SESSION_ID = crypto.randomUUID(); // ou usar session_id existente
```
### 2. Rastreio de Consultas KB
Se a skill consultar Dify KB:
```javascript
let KB_CONSULTED = false;
let KB_HITS = 0;
let KB_MISS = 0;
// Após cada consulta Dify bem sucedida
KB_CONSULTED = true;
KB_HITS++;
// Se consulta falhou ou sem resultados
KB_MISS++;
```
### 3. Contagem de Tool Calls
```javascript
let TOOL_CALLS = 0;
// Incrementar a cada tool call
TOOL_CALLS++;
```
### 4. Fim de Execução - Gravar Métrica
**Via SQL directo (fallback robusto):**
```sql
INSERT INTO tblskill_agent_metrics (
type, name, duration_ms, status,
session_id, task_id, project_id, staff_id,
kb_consulted, kb_hits, kb_miss, tool_calls,
error_type, error_message, context_tokens, output_tokens,
model_used, created_at
) VALUES (
'skill', '/nome-skill', {DURATION_MS}, '{STATUS}',
'{SESSION_ID}', {TASK_ID}, {PROJECT_ID}, 25,
{KB_CONSULTED}, {KB_HITS}, {KB_MISS}, {TOOL_CALLS},
NULL, NULL, NULL, NULL,
'opus-4.5', NOW()
);
```
**Via MCP tool (quando disponível):**
```javascript
mcp__desk-crm-v3__log_skill_metric({
type: 'skill',
name: '/nome-skill',
duration_ms: Date.now() - SKILL_START,
status: 'success', // ou 'error', 'partial'
session_id: SESSION_ID,
task_id: CURRENT_TASK_ID,
project_id: CURRENT_PROJECT_ID,
staff_id: 25, // AikTop
kb_consulted: KB_CONSULTED,
kb_hits: KB_HITS,
kb_miss: KB_MISS,
tool_calls: TOOL_CALLS
});
```
## Status Possíveis
| Status | Quando Usar |
|--------|-------------|
| `success` | Skill completou com sucesso |
| `error` | Skill falhou com erro |
| `partial` | Skill completou parcialmente |
| `cancelled` | Utilizador cancelou |
## Campos Opcionais
| Campo | Quando Preencher |
|-------|------------------|
| `task_id` | Se executando dentro de tarefa Desk |
| `project_id` | Se contexto de projecto conhecido |
| `error_type` | Se status = 'error' |
| `error_message` | Se status = 'error' |
| `context_tokens` | Se disponível via API |
| `output_tokens` | Se disponível via API |
## Template para Skills
Adicionar esta secção no final de cada SKILL.md instrumentada:
```markdown
---
## Instrumentação Automática
Esta skill grava métricas automaticamente para análise PDCA.
### Ao Executar Esta Skill
1. **Início:** Registar timestamp inicial
2. **Consultas KB:** Rastrear hits/miss do Dify
3. **Fim:** Gravar métrica via SQL ou MCP
### Query para Gravar (executar no final)
\`\`\`sql
INSERT INTO tblskill_agent_metrics (type, name, duration_ms, status, staff_id, kb_consulted, created_at)
VALUES ('skill', '/nome-skill', {DURACAO_MS}, '{STATUS}', 25, {KB_CONSULTADO}, NOW());
\`\`\`
### Ver Métricas
\`\`\`bash
/metrics /nome-skill
\`\`\`
```
## Integração com /reflect
Se degradação detectada (performance >15% pior que baseline):
1. `/metrics` mostra alerta
2. Sugerir `/reflect` para investigação
3. `/reflect` analisa padrões e propõe melhorias
4. Registar ciclo PDCA em `tblskill_agent_pdca_cycles`
---
**Protocolo v1.0** | 2026-02-03

69
core-tools/skills/_core/notebooklm-mapping.json Normal file
View File

@@ -0,0 +1,69 @@
{
"description": "Mapeamento Dify KB datasets -> NotebookLM notebooks. NotebookLM e fonte primaria (Gemini 2.5 RAG). Dify KB e fallback.",
"updated": "2026-02-12",
"query_tool": "mcp__notebooklm__notebook_query",
"fallback_tool": "mcp__dify-kb__dify_kb_retrieve_segments",
"mapping": {
"Marketing Digital": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Marketing": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Gestao de Marketing": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Gestao de Trafego": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Marketing de Conteudo": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Growth Hacking": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Marketing Redes Sociais": {"notebook_id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "notebook_title": "Social Media e Branding"},
"Branding": {"notebook_id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "notebook_title": "Social Media e Branding"},
"Canva": {"notebook_id": "9053d0e8-dd39-460b-b5ea-e67af3e9a675", "notebook_title": "Social Media e Branding"},
"SEO (Search Engine Optimization)": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado", "note": "SEO coberto genericamente no Marketing Avancado"},
"SEO": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado"},
"Copywriting": {"notebook_id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323", "notebook_title": "Copywriting e Persuasao"},
"Youtube Marketing": {"notebook_id": "058a896e-6c9a-4e51-ae7d-9adb2738bc5f", "notebook_title": "Producao de Video e Youtube"},
"Vendas": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado", "note": "Sem notebook dedicado, coberto parcialmente"},
"Email Marketing": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado", "note": "Sem notebook dedicado"},
"Blogging": {"notebook_id": "76647e0f-3ae2-4c00-a0a8-f457aebf5655", "notebook_title": "Marketing Digital Avancado", "note": "Sem notebook dedicado"},
"Mentor: Seth Godin": {"notebook_id": "79d43410-0e29-4be1-881d-84db6bdc239a", "notebook_title": "Estrategia e Empreendedorismo"},
"Mentor: Russel Brunson": {"notebook_id": "79d43410-0e29-4be1-881d-84db6bdc239a", "notebook_title": "Estrategia e Empreendedorismo"},
"Mentor: Gary Vee": {"notebook_id": "7b8fec17-d34f-4e3f-a8c6-8231e51f6323", "notebook_title": "Copywriting e Persuasao"},
"Mentor: Alex Vargas": {"notebook_id": "4c595973-ba10-420a-a3bf-e4389e424ad3", "notebook_title": "Marketing Digital PT"},
"Mentor: Natanael Oliveira": {"notebook_id": "4c595973-ba10-420a-a3bf-e4389e424ad3", "notebook_title": "Marketing Digital PT"},
"Mentor: Ricardo Piovan": {"notebook_id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "notebook_title": "Gestao de Projectos e Agile"},
"Claude Code": {"notebook_id": "2876d1fe-5cea-4d98-8140-b0e1a81c6bc4", "notebook_title": "Claude Code"},
"MCP Servers": {"notebook_id": "73102308-70ef-403e-9be9-eae0cfc62d55", "notebook_title": "Desenvolvimento de MCPs"},
"VS Code": {"notebook_id": "57d9c6c9-48ba-4d83-8f71-cc890f348a53", "notebook_title": "AI Code Editors"},
"Windsurf": {"notebook_id": "57d9c6c9-48ba-4d83-8f71-cc890f348a53", "notebook_title": "AI Code Editors"},
"Claude Computer Use": {"notebook_id": "57d9c6c9-48ba-4d83-8f71-cc890f348a53", "notebook_title": "AI Code Editors"},
"Desenvolvimento de Software": {"notebook_id": "24947ffa-0019-448a-a340-2f4a275d2eb1", "notebook_title": "Programacao"},
"Obsidian + Claude Code": {"notebook_id": "ebee9fe1-78fd-4f85-8938-f19f3ea32131", "notebook_title": "Obsidian + Claude"},
"WordPress": {"notebook_id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "notebook_title": "WordPress e Elementor"},
"Elementor": {"notebook_id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "notebook_title": "WordPress e Elementor"},
"Crocoblock": {"notebook_id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "notebook_title": "WordPress e Elementor"},
"Desenvolvimento de WebSites": {"notebook_id": "5be0d1a6-00f2-4cd9-b835-978cb7721601", "notebook_title": "WordPress e Elementor"},
"CWP Centos Web Panel": {"notebook_id": "0ded7bd6-69b3-4c76-b327-452396bf7ea7", "notebook_title": "CWP"},
"TI (Tecnologia da Informação)": {"notebook_id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "notebook_title": "Cloud e Infraestrutura TI"},
"TI": {"notebook_id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "notebook_title": "Cloud e Infraestrutura TI"},
"Linux": {"notebook_id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "notebook_title": "Cloud e Infraestrutura TI"},
"AWS (Amazon Web Services)": {"notebook_id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "notebook_title": "Cloud e Infraestrutura TI"},
"AWS": {"notebook_id": "f9a79b5a-649f-4443-afaf-7ff562b6c2e7", "notebook_title": "Cloud e Infraestrutura TI"},
"Gestao": {"notebook_id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "notebook_title": "Gestao de Projectos e Agile"},
"Gestao de Projetos": {"notebook_id": "0c9c079c-a426-486c-99eb-1564d42d37ad", "notebook_title": "Gestao de Projectos e Agile"},
"Gestao de Processos": {"notebook_id": "f9dc59c2-718b-4b12-bd06-095d4bfa3e34", "notebook_title": "Gestao de Operacoes"},
"Estrategia": {"notebook_id": "79d43410-0e29-4be1-881d-84db6bdc239a", "notebook_title": "Estrategia e Empreendedorismo"},
"Estratégia": {"notebook_id": "79d43410-0e29-4be1-881d-84db6bdc239a", "notebook_title": "Estrategia e Empreendedorismo"},
"Produtividade": {"notebook_id": "ebee9fe1-78fd-4f85-8938-f19f3ea32131", "notebook_title": "Obsidian + Claude"},
"Escrever PT-PT": {"notebook_id": null, "notebook_title": null, "note": "Sem equivalente NotebookLM - usar apenas Dify"},
"n8n": {"notebook_id": "f2c809b8-1cb5-4dd0-aa7e-be2cfb6704d1", "notebook_title": "n8n"},
"Dify": {"notebook_id": "929ef67b-c131-4f01-abd0-8b078491a6b7", "notebook_title": "AI Automation Stack"},
"Flowise": {"notebook_id": "929ef67b-c131-4f01-abd0-8b078491a6b7", "notebook_title": "AI Automation Stack", "note": "Coberto parcialmente"},
"Open WebUI": {"notebook_id": "be6f72ac-f8ba-4337-912d-abd5dd448519", "notebook_title": "Open WebUI"},
"Ferramentas de Automação e IA": {"notebook_id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8", "notebook_title": "Transformacao Digital e IA"},
"Ferramentas Automacao e IA": {"notebook_id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8", "notebook_title": "Transformacao Digital e IA"},
"PerfexCRM": {"notebook_id": "df4688bb-c2c0-4aba-98c1-38c3b50a353c", "notebook_title": "Perfex CRM: Gestao de Clientes e Projetos"},
"Servicos Descomplicar": {"notebook_id": "f29c8457-f16d-4fb3-979d-6e5901de1b20", "notebook_title": "Descomplicar: Marketing Digital"},
"e-commerce": {"notebook_id": "226e384e-d4bc-48f4-bb82-7927360436cc", "notebook_title": "E-commerce Pratico"},
"Empreendedorismo": {"notebook_id": "79d43410-0e29-4be1-881d-84db6bdc239a", "notebook_title": "Estrategia e Empreendedorismo"},
"Agencia Digital": {"notebook_id": "f9dc59c2-718b-4b12-bd06-095d4bfa3e34", "notebook_title": "Gestao de Operacoes"},
"Estrategia Descomplicar": {"notebook_id": "f29c8457-f16d-4fb3-979d-6e5901de1b20", "notebook_title": "Descomplicar: Marketing Digital"},
"Aceleracao Digital": {"notebook_id": "ab876d0d-12a8-43d9-bc62-59c1c8e9d0f8", "notebook_title": "Transformacao Digital e IA"},
"UX e Usabilidade": {"notebook_id": "081ca512-8279-4850-b2b9-dff090267482", "notebook_title": "UI/UX Design"},
"Criatividade": {"notebook_id": "081ca512-8279-4850-b2b9-dff090267482", "notebook_title": "UI/UX Design", "note": "Sem notebook dedicado"}
}
}