Emanuel Almeida
692475a315
- Execute all 6 migrations on Desk CRM production database - Create missing tables: cr_lsps, cr_agent_lsps, cr_lsp_usage - Create archive tables: cr_*_usage_archive (4 tables) - Create system tables: cr_migrations, cr_maintenance_log - Make all scripts executable (chmod +x) - Total cr_* tables: 38 Migration files: - 001_initial_schema.sql - 002_add_lsps.sql - 003_add_relationships.sql - 004_add_telemetry.sql - 005_add_archive_tables.sql - 006_add_maintenance_log.sql Scripts: - session-init.sh, session-end.sh - inject-context.sh, inject-agent-context.sh - record-usage.sh, db-backup.sh, sync-to-mysql.sh Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
155 lines
3.8 KiB
Markdown
155 lines
3.8 KiB
Markdown
---
|
|
name: agent-context-injector
|
|
description: >
|
|
Injecção dinâmica de contexto específico para cada agente.
|
|
Use when "contexto agente", "injectar", "SubagentStart",
|
|
"recursos agente", "mcps disponíveis", "skills relevantes".
|
|
author: Descomplicar®
|
|
version: 1.0.0
|
|
desk_task: 1441
|
|
allowed-tools: Read, Glob, Grep, ToolSearch
|
|
---
|
|
|
|
# Agent Context Injector
|
|
|
|
Injecção dinâmica de contexto específico para cada agente.
|
|
|
|
## Triggers
|
|
|
|
Esta skill é activada automaticamente via hook `SubagentStart` quando:
|
|
- Um subagente é iniciado via Task tool
|
|
- Contexto precisa ser enriquecido com recursos do agente
|
|
|
|
## Capabilities
|
|
|
|
### 1. Context Building
|
|
- Consultar mapeamento agente → recursos na BD
|
|
- Gerar lista de MCPs disponíveis para o agente
|
|
- Gerar lista de skills relevantes
|
|
- Incluir datasets Dify para consulta automática
|
|
|
|
### 2. Token Optimization
|
|
- Calcular tokens do contexto gerado
|
|
- Priorizar recursos por relevância
|
|
- Truncar se exceder limite (~800 tokens)
|
|
- Cache de contextos frequentes
|
|
|
|
### 3. Dynamic Injection
|
|
- Adicionar contexto ao prompt do agente
|
|
- Incluir instruções de uso dos recursos
|
|
- Configurar auto-consult para datasets
|
|
|
|
## Template de Contexto
|
|
|
|
```markdown
|
|
## Recursos Disponíveis
|
|
|
|
### MCPs Activos
|
|
$MCP_LIST
|
|
- Usar proactivamente para operações relevantes
|
|
|
|
### Skills Recomendadas
|
|
$SKILLS_LIST
|
|
- Invocar quando tarefa corresponder
|
|
|
|
### Knowledge Base (Dify)
|
|
$DATASETS_LIST
|
|
- AUTO-CONSULT: Consultar ANTES de responder
|
|
- Query template: "$QUERY_TEMPLATE"
|
|
|
|
### Plugins
|
|
$PLUGINS_LIST
|
|
- Comandos disponíveis: $PLUGIN_COMMANDS
|
|
```
|
|
|
|
## Workflow
|
|
|
|
```
|
|
SUBAGENT START → QUERY BD → BUILD CONTEXT → INJECT → EXECUTE
|
|
```
|
|
|
|
1. **Hook SubagentStart** dispara
|
|
2. **Identificar agente** pelo `subagent_type`
|
|
3. **Query MySQL**:
|
|
```sql
|
|
SELECT r.resource_type, r.resource_id, r.priority
|
|
FROM cr_agent_resources r
|
|
JOIN cr_agents a ON r.agent_id = a.id
|
|
WHERE a.slug = '{agent_slug}'
|
|
AND r.auto_inject = TRUE
|
|
ORDER BY r.priority ASC;
|
|
```
|
|
4. **Consultar agent-knowledge-config.json** para datasets
|
|
5. **Gerar contexto** com template
|
|
6. **Calcular tokens** e optimizar se necessário
|
|
7. **Injectar** no prompt do agente
|
|
|
|
## Métricas Target
|
|
|
|
| Métrica | Target |
|
|
|---------|--------|
|
|
| Tempo de injecção | < 2s |
|
|
| Tokens médios | ~772 |
|
|
| Cache hit rate | > 60% |
|
|
| Erro rate | < 1% |
|
|
|
|
## Exemplo de Output
|
|
|
|
Para `wordpress-plugin-developer`:
|
|
|
|
```markdown
|
|
## Recursos Disponíveis
|
|
|
|
### MCPs Activos
|
|
- `cwp` - Gestão servidor CentOS WebPanel
|
|
- `ssh-unified` - Acesso SSH a servidores
|
|
- `filesystem` - Operações de ficheiros
|
|
|
|
### Skills Recomendadas
|
|
- `/wp-dev` - Desenvolvimento WordPress
|
|
- `/wp-performance` - Optimização performance
|
|
- `/elementor` - Desenvolvimento Elementor
|
|
|
|
### Knowledge Base (Dify)
|
|
- `wordpress-development` - Docs WP, hooks, filters
|
|
- `woocommerce-api` - API WooCommerce
|
|
- AUTO-CONSULT: Consultar ANTES de implementar
|
|
|
|
### Plugins
|
|
- `superpowers` - TDD obrigatório
|
|
- `code-review` - Review automático
|
|
```
|
|
|
|
## Configuração
|
|
|
|
Ficheiro `agent-knowledge-config.json`:
|
|
```json
|
|
{
|
|
"wordpress-plugin-developer": {
|
|
"datasets": ["wordpress-development", "woocommerce-api"],
|
|
"auto_consult": true,
|
|
"query_template": "WordPress {topic} best practices 2026",
|
|
"priority_datasets": ["wordpress-development"]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Integração com Scripts Existentes
|
|
|
|
Este skill complementa (não substitui) os scripts Python existentes:
|
|
- `inject-mcp-context.py` - Continua activo
|
|
- `inject-skills-context.py` - Continua activo
|
|
|
|
A skill adiciona:
|
|
- Datasets Dify dinâmicos
|
|
- Plugins activos
|
|
- Contexto mais rico e actualizado
|
|
|
|
## Limites
|
|
|
|
- Máximo ~800 tokens de contexto injectado (para preservar espaço)
|
|
- Não modifica comportamento do agente, apenas enriquece contexto
|
|
- Depende de mapeamentos correctos em `cr_agent_resources`
|
|
- Cache de 5 minutos pode mostrar dados desactualizados
|
|
- Não funciona para agentes não registados na BD
|