189 lines
5.1 KiB
Markdown
189 lines
5.1 KiB
Markdown
---
|
|
name: validate-component
|
|
description: Valida skills e agents para alinhamento com procedimentos Hub. Verifica se componente referencia procedimentos (não duplica) e segue padrão de referenciação. Usar quando "validar skill", "verificar agent", "audit component", antes de deploy.
|
|
layer: wiki
|
|
---
|
|
|
|
# /validate-component - Validador de Componentes
|
|
|
|
Audita skills e agents para garantir alinhamento com padrão de centralização de procedimentos Hub.
|
|
|
|
---
|
|
|
|
## Referências e Documentação
|
|
|
|
**SEMPRE consultar:**
|
|
- **[Hub CLAUDE.md](file:///media/ealmeida/Dados/Hub/CLAUDE.md)** - Secção "Organização de Procedimentos" (padrão referenciação)
|
|
- **[/mcp-dev skill](file:///home/ealmeida/.claude/plugins/marketplaces/descomplicar-plugins/infraestrutura/skills/mcp-dev/SKILL.md)** - Exemplo padrão ouro de referenciação
|
|
|
|
---
|
|
|
|
## O Que Valida
|
|
|
|
### 1. Procedimentos Embeddados (RED FLAG)
|
|
|
|
**Detecta conteúdo que deve estar em PROC-*:**
|
|
- ✗ Checklists extensas (>10 itens)
|
|
- ✗ Regras de validação detalhadas
|
|
- ✗ Troubleshooting guides completos
|
|
- ✗ Standards e convenções
|
|
- ✗ Best practices longas
|
|
- ✗ Workflows complexos passo-a-passo
|
|
|
|
### 2. Referenciação Correcta (GREEN FLAG)
|
|
|
|
**Verifica se componente referencia procedimentos:**
|
|
- ✓ Secção "Referências e Documentação"
|
|
- ✓ Links file:// para PROCs relevantes
|
|
- ✓ Descrição breve do que cada PROC cobre
|
|
- ✓ Instrução "SEMPRE consultar antes de..."
|
|
|
|
### 3. Separação Clara
|
|
|
|
**O que DEVE ficar no componente:**
|
|
- ✓ Comandos e templates
|
|
- ✓ Instruções operacionais curtas
|
|
- ✓ Decisão "quando usar"
|
|
- ✓ Exemplos práticos inline
|
|
|
|
**O que DEVE ir para PROC:**
|
|
- ✗ Regras e standards
|
|
- ✗ Checklists de validação
|
|
- ✗ Troubleshooting detalhado
|
|
- ✗ Melhores práticas extensas
|
|
|
|
---
|
|
|
|
## Protocolo de Validação
|
|
|
|
### Para Skills
|
|
|
|
```
|
|
1. LER skill SKILL.md completo
|
|
|
|
2. VERIFICAR secção "Referências e Documentação":
|
|
- Existe? (GREEN se sim, sugerir criar se não)
|
|
- Tem links file:// para PROCs? (GREEN se sim)
|
|
- Links são relevantes para o domínio da skill?
|
|
|
|
3. DETECTAR procedimentos embeddados:
|
|
- Procurar padrões: "Checklist", "Steps", "Validação", "Troubleshooting"
|
|
- Se >100 linhas de instruções → SUGERIR extrair para PROC
|
|
|
|
4. AVALIAR qualidade referenciação:
|
|
- Links funcionam? (teste paths)
|
|
- Descrição do PROC é clara?
|
|
- Indica quando consultar?
|
|
|
|
5. GERAR relatório (ver formato abaixo)
|
|
```
|
|
|
|
### Para Agents
|
|
|
|
```
|
|
1. LER agent .md completo (frontmatter + system prompt)
|
|
|
|
2. VERIFICAR system prompt tem secção "Referências":
|
|
- Existe? (GREEN se sim)
|
|
- Tem links file:// para PROCs relevantes?
|
|
|
|
3. DETECTAR procedimentos embeddados no system prompt:
|
|
- Padrões similares a skills
|
|
- Workflows >50 linhas no prompt
|
|
|
|
4. AVALIAR se agent conhece procedimentos do seu domínio:
|
|
- wordpress-plugin-developer → deve referenciar PROC-WordPress-*
|
|
- mcp-protocol-developer → deve referenciar PROC-MCP-*
|
|
|
|
5. GERAR relatório
|
|
```
|
|
|
|
---
|
|
|
|
## Formato Relatório
|
|
|
|
```markdown
|
|
# Relatório Validação: [nome-componente]
|
|
|
|
**Tipo:** Skill | Agent
|
|
**Path:** [caminho completo]
|
|
**Data:** YYYY-MM-DD HH:MM
|
|
|
|
---
|
|
|
|
## Status Geral
|
|
|
|
**Score:** X/10
|
|
- ✅ 8-10: Excelente (nada a fazer)
|
|
- ⚠️ 5-7: Atenção (melhorias sugeridas)
|
|
- ❌ 0-4: Crítico (refactoring necessário)
|
|
|
|
---
|
|
|
|
## Checklist Validação
|
|
|
|
### Referenciação (Peso: 40%)
|
|
- [ ] Secção "Referências e Documentação" existe
|
|
- [ ] Links file:// para PROCs relevantes
|
|
- [ ] Descrição clara do que cada PROC cobre
|
|
- [ ] Instrução "SEMPRE consultar antes de..."
|
|
|
|
### Separação Conteúdo (Peso: 40%)
|
|
- [ ] Sem checklists longas (>10 itens) embeddadas
|
|
- [ ] Sem troubleshooting extenso embeddado
|
|
- [ ] Sem standards/conventions detalhadas embeddadas
|
|
- [ ] Sem workflows complexos embeddados
|
|
|
|
### Qualidade (Peso: 20%)
|
|
- [ ] Links file:// funcionam (paths válidos)
|
|
- [ ] Referencia PROCs do departamento correcto
|
|
- [ ] Instruções operacionais concisas (<50 linhas)
|
|
|
|
---
|
|
|
|
## Issues Detectadas
|
|
|
|
### 🔴 Críticas (Bloqueia Deploy)
|
|
|
|
1. **[Tipo Issue]**
|
|
- **Localização:** Linha X-Y
|
|
- **Problema:** Descrição
|
|
- **Impacto:** Duplicação procedimento / Info embeddada
|
|
- **Acção:** Extrair para PROC-[Nome].md em [Departamento]/
|
|
|
|
### ⚠️ Avisos (Recomendado Corrigir)
|
|
|
|
1. **[Tipo Issue]**
|
|
- **Localização:** Secção X
|
|
- **Problema:** Descrição
|
|
- **Sugestão:** Adicionar referência a PROC-[Nome].md
|
|
|
|
### ✅ Boas Práticas Observadas
|
|
|
|
1. Secção "Referências" bem estruturada
|
|
2. Links file:// correctos
|
|
3. Separação clara comando vs regra
|
|
|
|
---
|
|
|
|
## Recomendações
|
|
|
|
### Imediatas (P1)
|
|
1. Extrair checklist linhas X-Y para PROC-[Nome].md
|
|
2. Adicionar link file:// para PROC-[Outro].md
|
|
|
|
### Melhorias (P2)
|
|
1. Expandir descrição PROC na referência
|
|
2. Adicionar exemplo uso combinado skill + PROC
|
|
|
|
### Opcional (P3)
|
|
1. Considerar criar PROC-[NovoTema].md para conteúdo Y
|
|
|
|
---
|
|
|
|
## Procedimentos Relevantes Existentes
|
|
|
|
| PROC | Departamento | Relevância | Status Link |
|
|
|------|--------------|------------|-------------|
|
|
| PROC-MCP-Desenvolvimento.md | D7 | Alta | ✅ Referenciado |
|
|
| PROC-WordPress-Hardening.md | D7 | Média | ❌ Nã |