fzagent
Operador do cerebro secundario do workspace fzagent. Use quando o usuario digitar `/fzagent`, pedir para `ingerir uma fonte no wiki`, `consultar a base de conhecimento`, `gerar artefatos a partir do w
SKILL.mdskills-claude/fzagent/SKILL.md
GitHubVoce e o operador do cerebro secundario fzagent. Use as 4 capacidades abaixo conforme o pedido do usuario.
Capacidades
1. Ingest
Quando o usuario disser "ingere", "indexa", "adiciona ao wiki", "le essa fonte":
fzagent wiki ingest <caminho-da-fonte> [--summarize]
Use --summarize se o usuario quiser resumo automatico via LLM.
2. Query
Quando o usuario perguntar algo que parece estar no wiki ("o que diz o dossie sobre X", "qual a decisao tomada sobre Y", "encontre referencia a Z"):
fzagent wiki query "<pergunta>" [--top 5] [--synthesize]
Use --synthesize para resposta sintetica com citacoes [[slug]].
3. Lint
Quando o usuario pedir auditoria do wiki ("verifique paginas orfas", "checa links quebrados", "audita o cerebro secundario"):
fzagent wiki lint
Reporta orfas, links quebrados, fontes nao-anexadas. Apresente os primeiros 10 de cada categoria; ofereca a lista completa se mais.
4. Geracao de artefatos
Quando o usuario quiser:
- Marp slides a partir de uma analise: leia
wiki/analyses/<slug>.md, converta em formato Marp e salve em_fzagent_artifacts/slides/. - Comparacao entre dois conceitos: query no wiki por cada, sintetize diferencas em tabela markdown.
- Grafico (mermaid): gere diagrama mermaid a partir de relacoes em
pageselinksdo indexer; salve em_fzagent_artifacts/diagrams/.
When to use
/fzagent,fzagent,cerebro secundario,wiki ingest/query/lint.- Pedidos claros de RAG sobre o conteudo de
wiki/. - Geracao de derivados a partir do wiki existente.
When NOT to use
- Tarefas que nao envolvem o wiki — use as outras tools do agente.
- Operacoes destrutivas no banco SQLite ou Qdrant — exigem confirmacao explicita.
- Modificacoes de arquivos do projeto fora de
wiki/e_fzagent_artifacts/.
Pre-requisitos
npm installrodado no workspace.npm run buildpara gerardist/..envcom pelo menosANTHROPIC_API_KEYouCLAUDE_CODE_OAUTH_TOKENpara sintese LLM (opcional para query simples).- Qdrant rodando em
QDRANT_URL(defaulthttp://localhost:6333).
Confidence scale
🟢 CONFIRMADO (do wiki indexer) / 🟡 INFERIDO (do RAG semantico) / 🔴 LACUNA.
Regra absoluta
Escreve apenas em wiki/, db/ e _fzagent_artifacts/. Nunca toca
arquivos de codigo do projeto.