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,144 @@
+---
+name: quality-validator
+description: Validação de componentes contra os standards Descomplicar® — frontmatter, checklists e quality gates antes de activação ou release.
+allowed-tools: Read, Glob, Grep
+layer: wiki
+---
+
+# Quality Validator
+
+Skill para validar componentes e garantir qualidade mínima antes de activação.
+
+## Triggers
+
+Esta skill deve ser activada quando:
+- Novo componente é criado
+- Comando `/descomplicar:validate` é invocado
+- Antes de release (`/descomplicar:release`)
+- Após edição de componente existente
+- Durante sync para bloquear componentes inválidos
+
+## Capabilities
+
+### 1. Validar Skill
+
+**Checklist Obrigatório:**
+
+| Campo | Obrigatório | Peso |
+|-------|-------------|------|
+| `name:` | Sim | 15 |
+| `description:` | Sim | 20 |
+| `author:` | Sim | 5 |
+| `version:` | Sim | 5 |
+| `desk_task:` | Não | 5 |
+| `allowed-tools:` | Sim | 10 |
+| Triggers section | Sim | 10 |
+| Capabilities section | Sim | 10 |
+| Workflow | Não | 5 |
+| Exemplo de Uso | Não | 10 |
+| Limites section | Não | 5 |
+
+**Validações de Qualidade:**
+- `description:` contém triggers (keywords) → +5 pontos
+- `description:` tem 5+ keywords → +5 pontos
+- Tamanho < 500 linhas → +5 pontos
+- Sem erros de sintaxe YAML → obrigatório
+
+### 2. Validar Agent
+
+**Checklist Obrigatório:**
+
+| Campo | Obrigatório | Peso |
+|-------|-------------|------|
+| `name:` | Sim | 15 |
+| `description:` | Sim | 20 |
+| `model:` | Sim | 10 |
+| `tools:` | Sim | 10 |
+| `allowed-mcps:` | Sim | 15 |
+| `category:` | Sim | 10 |
+| `author:` | Sim | 5 |
+| `version:` | Sim | 5 |
+| Quando Usar section | Não | 5 |
+| Workflow section | Não | 5 |
+
+**Validações de Qualidade:**
+- MCPs mapeados existem em `cr_mcps` → +5 pontos
+- Categoria válida (dev|business|marketing|infra) → obrigatório
+- Model válido (sonnet|opus|haiku) → obrigatório
+
+### 3. Validar Command
+
+**Checklist Obrigatório:**
+
+| Campo | Obrigatório | Peso |
+|-------|-------------|------|
+| `name:` | Sim | 20 |
+| `description:` | Sim | 30 |
+| `argument-hint:` | Não | 10 |
+| Objectivo section | Sim | 15 |
+| Sintaxe section | Sim | 15 |
+| Output section | Não | 10 |
+
+### 4. Calcular Score
+
+**Fórmula:**
+```
+score = (campos_obrigatorios * peso_obrigatorio) + (campos_opcionais * peso_opcional) + bonus_qualidade
+```
+
+**Interpretação:**
+| Score | Status | Acção |
+|-------|--------|-------|
+| >= 90 | Production | Pronto para uso |
+| 70-89 | Beta | Pode activar com aviso |
+| 50-69 | Draft | Requer melhorias |
+| < 50 | Invalid | **BLOQUEAR** activação |
+
+### 5. Gerar Relatório
+
+**Output:**
+```
+╔══════════════════════════════════════════════════════════════════════╗
+║  QUALITY VALIDATION: <component-name>                                ║
+║  Type: Skill | Path: skills/<name>/SKILL.md                         ║
+╠══════════════════════════════════════════════════════════════════════╣
+║  FRONTMATTER                                                         ║
+║  ├── name:          ✓ Present                                        ║
+║  ├── description:   ✓ Present (5 keywords detected)                  ║
+║  ├── author:        ✓ Present                                        ║
+║  ├── version:       ✓ Present (1.0.0)                                ║
+║  ├── desk_task:     ✗ Missing (optional)                             ║
+║  └── allowed-tools: ✓ Present (Read, Glob, Grep)                     ║
+╠══════════════════════════════════════════════════════════════════════╣
+║  CONTENT SECTIONS                                                    ║
+║  ├── Triggers:      ✓ Present                                        ║
+║  ├── Capabilities:  ✓ Present (3 capabilities)                       ║
+║  ├── Workflow:      ✓ Present                                        ║
+║  ├── Exemplo:       ✗ Missing (recommended)                          ║
+║  └── Limites:       ✗ Missing (recommended)                          ║
+╠══════════════════════════════════════════════════════════════════════╣
+║  QUALITY CHECKS                                                      ║
+║  ├── Lines:         234 (< 500 ✓)                                    ║
+║  ├── YAML syntax:   Valid ✓                                          ║
+║  └── Keywords:      5 detected ✓                                     ║
+╠══════════════════════════════════════════════════════════════════════╣
+║  SCORE: 78/100  ████████████████░░░░  BETA                           ║
+╠══════════════════════════════════════════════════════════════════════╣
+║  SUGGESTIONS                                                         ║
+║  1. Adicionar secção "Exemplo de Uso" (+10 pontos)                   ║
+║  2. Adicionar secção "Limites" (+5 pontos)                           ║
+║  3. Adicionar desk_task no frontmatter (+5 pontos)                   ║
+╚══════════════════════════════════════════════════════════════════════╝
+```
+
+## Quality Gates
+
+### Gate 1: Criação
+- Score >= 50 para criar componente
+- Se < 50: BLOQUEAR e mostrar erros
+
+### Gate 2: Activação
+- Score >= 70 para activar componente
+- Se < 70: AVISO + sugestões
+
+### Gate 3: Re