feat(core-tools): adiciona plugin core-tools (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:08:27 +00:00
parent de490943e5
commit 83a69e681c
28 changed files with 2708 additions and 0 deletions
@@ -0,0 +1,113 @@
+---
+name: plugin-curator
+description: Curadoria inteligente de plugins para o ecossistema Claude Code — descoberta, recomendações, actualizações e identificação de gaps funcionais.
+allowed-tools: Read, Glob, Grep, WebFetch, WebSearch
+layer: wiki
+---
+
+# Plugin Curator
+
+Curadoria inteligente de plugins para o ecossistema Claude Code.
+
+## Triggers
+
+Esta skill deve ser activada quando:
+- Utilizador pede recomendações de plugins
+- Novo tipo de tarefa sem skill/plugin adequado
+- Actualização disponível para plugins instalados
+- Gap identificado na cobertura funcional
+
+## Capabilities
+
+### 1. Gap Analysis
+- Mapear funcionalidades existentes
+- Identificar áreas sem cobertura
+- Sugerir plugins ou skills a desenvolver
+- Priorizar baseado em uso real
+
+### 2. Discovery
+- Pesquisar marketplaces oficiais e comunitários
+- Avaliar relevância baseada no contexto actual
+- Identificar plugins com funcionalidades sobrepostas
+- Detectar plugins desactualizados ou abandonados
+
+### 3. Evaluation
+- Analisar qualidade do código (se open source)
+- Verificar compatibilidade com sistema actual
+- Avaliar segurança (hooks, permissões)
+- Medir popularidade e manutenção activa
+
+### 4. Installation Management
+- Instalar plugins recomendados
+- Configurar hooks e MCPs do plugin
+- Resolver conflitos com plugins existentes
+- Gerir actualizações e rollbacks
+
+## Marketplaces Conhecidos
+
+| Marketplace | URL | Tipo |
+|-------------|-----|------|
+| anthropics/claude-plugins-official | github.com | Oficial |
+| coreyhaines31/marketingskills | github.com | Marketing |
+| alirezarezvani/claude-skills | github.com | Geral |
+| Chat2AnyLLM/awesome-claude-plugins | github.com | Curadoria |
+| obra/superpowers | github.com | Metodologia |
+
+## Scoring Algorithm
+
+```
+score = 0
+score += keyword_match * 3      # Max 3  (bool: 0|1)
+score += category_align * 2     # Max 2  (bool: 0|1)
+score += popularity             # Max 2  (tiered: 0=<100 stars, 1=100-1k, 2=>1k)
+score += recent_update          # Max 1  (bool: 1 se último commit <30 dias)
+score += no_conflicts * 2       # Max 2  (bool: 0|1)
+# Total max: 3 + 2 + 2 + 1 + 2 = 10
+```
+
+## Workflow
+
+```
+ANALYSE GAPS → SEARCH MARKETPLACES → EVALUATE → RECOMMEND → INSTALL
+```
+
+## Exemplo de Uso
+
+```
+User: Preciso de ajuda com testes automatizados
+Assistant: [Activa plugin-curator]
+- Verifica skills de testing existentes: Nenhuma
+- Pesquisa marketplaces por "testing", "QA", "automation"
+- Encontra: pr-review-toolkit (6 agents QA), superpowers (TDD)
+- Recomenda: "Encontrei 2 plugins relevantes para testing:
+  1. pr-review-toolkit - 6 agents especializados em QA
+  2. superpowers - Metodologia TDD integrada
+  Qual preferes instalar?"
+```
+
+## Limites
+
+- Não instala plugins automaticamente (requer confirmação)
+- Não avalia plugins de fontes privadas/não acessíveis
+- Score máximo 10 - pode não reflectir 100% da qualidade real
+- Depende de metadados disponíveis nos marketplaces
+
+## Anti-Patterns
+
+- NUNCA instalar plugins sem confirmação do utilizador
+- NUNCA instalar plugins de fontes não verificadas
+- Verificar SEMPRE conflitos antes de instalar
+- Manter registo de todos os plugins avaliados
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"2026-04-06","issue":"Capabilities ordenadas por ordem diferente do Workflow (Discovery 1º, Gap Analysis 4º) — incoerência com fluxo ANALYSE GAPS → SEARCH → EVALUATE → RECOMMEND → INSTALL","fix":"Reordenadas Capabilities para seguir ordem do Workflow: 1.Gap Analysis 2.Discovery 3.Evaluation 4.Installation Management","source":"auto"}
+{"date":"2026-04-06","issue":"Scoring algorithm: score += popularity sem multiplicador e sem documentar escala — ambíguo se max é 1 (bool) ou 2 (tiered)","fix":"Adicionados comentários inline a todos os campos: tipo (bool/tiered), escala e critério. Confirmada soma: 3+2+2+1+2=10.","source":"auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*