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,66 @@
+---
+name: agent-context-injector
+description: Injeccao dinamica de contexto (MCPs e Skills) nos agentes via script Python + hook SessionStart com deteccao de staleness.
+user-invocable: false
+allowed-tools: Read, Glob, Grep, ToolSearch
+layer: wiki
+---
+
+# Agent Context Injector
+
+Regeneracao automatica das seccoes "Your Available MCPs" e "Your Available Skills" em todos os agentes.
+
+## Como funciona
+
+1. **Hook SessionStart** (`~/.claude/hooks/agent-context-refresh.sh`) calcula hash dos inputs
+2. Se hash mudou → executa `~/.claude/scripts/regenerate-agent-context.py`
+3. Script le frontmatter de cada agente, inventario MCPs, mapeamento domain e skills dos plugins
+4. Gera seccoes entre marcadores `<!-- BEGIN:AUTO-CONTEXT -->` / `<!-- END:AUTO-CONTEXT -->`
+5. Guarda novo hash em `~/.claude/.agent-context-hash`
+
+## Ficheiros
+
+| Ficheiro | Funcao |
+|----------|--------|
+| `~/.claude/scripts/regenerate-agent-context.py` | Script principal de regeneracao |
+| `~/.claude/hooks/agent-context-refresh.sh` | Hook SessionStart com staleness |
+| `~/.claude/_resources/domain-mcp-map.json` | Mapeamento domain -> MCPs recomendados |
+| `~/.claude/_resources/mcps.json` | Inventario de 34+ MCPs |
+| `~/.claude/.agent-context-hash` | Hash MD5 dos inputs (staleness) |
+
+## Dados de entrada
+
+- **Agentes:** `~/.claude/agents/*.md` — frontmatter com `domain`, `skills`
+- **MCPs:** `~/.claude/_resources/mcps.json` — lista com `id`, `name`, `category`
+- **Domain map:** `~/.claude/_resources/domain-mcp-map.json` — primary/recommended por domain
+- **Skills:** `descomplicar-plugins/*/skills/*/SKILL.md` — frontmatter com `name`, `description`
+
+## Performance
+
+| Cenario | Tempo |
+|---------|-------|
+| Sem mudancas (hash match) | ~66ms |
+| Com regeneracao (61 agentes) | ~2-3s |
+
+## Manutencao
+
+- **Adicionar MCP:** actualizar `mcps.json` e `domain-mcp-map.json` → proximo SessionStart regenera
+- **Adicionar skill:** criar SKILL.md no plugin → proximo SessionStart regenera
+- **Adicionar agente:** criar .md com frontmatter `domain:` → proximo SessionStart gera contexto
+- **Mudar domain map:** editar `domain-mcp-map.json` → proximo SessionStart regenera
+
+## Tarefa Desk
+
+#1996 — Sistema injeccao Skills e MCPs nos agentes
+
+---
+
+## Healing Log
+
+Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+
+```jsonl
+{"date":"","issue":"","fix":"","source":"user|auto"}
+```
+
+*Adicionar nova linha após cada erro corrigido.*