← ClaudeAtlas

agent-harnesslisted

Princípios de engenharia de harness para sistemas de agentes LLM — context engineering (KV Cache, system prompt, Skills, Agent Status Bar, compressão), memória de usuário e RAG, design de tools e arquitetura event-driven/assíncrona, coding agents e segurança de execução, e avaliação. Use SEMPRE que o trabalho envolver projetar, depurar ou avaliar um agente: TTFT/custo de inferência subindo, agent escolhendo a tool errada, loop infinito ou repetição de tool call, contexto estourando, memória entre sessões, RAG que não recupera o trecho certo, muitos servers MCP inflando o prefixo, interrupção do usuário / evento assíncrono, sandbox, prompt injection, tool description, sub-agents, ou "como sei se essa mudança melhorou?". Vale também quando o usuário não usa nenhum desses termos e descreve só o sintoma ("ficou lento depois que eu coloquei a hora no prompt", "ele repete a mesma busca sem parar", "o eval subiu 3 pontos, deployo?"). NÃO use para prompting one-shot de chat sem tools, dúvidas sobre como usar o Claude
G59-Toneli/agent-harness · ★ 1 · AI & Automation · score 64
Install: claude install-skill G59-Toneli/agent-harness
# Agent Harness Engineering Baseada em *AI Agents in Depth: Design Principles and Engineering Practice* (Bojie Li), caps. 2–6, e no repo oficial `github.com/bojieli/ai-agent-book`. O objetivo desta skill é dar **regras de decisão**, não um resumo. Quando o problema for concreto, vá direto na tabela de roteamento abaixo, abra o reference indicado e aplique a regra. --- ## 1. A espinha: Agent = Model + Harness O modelo é o motor; o **harness** é tudo em volta dele. Cinco funções, com o princípio central de cada uma (cap. 1 §1.2.2): | Função | Princípio central | Onde está aqui | |---|---|---| | **Context** | *Suficiência de informação* — o agent decide com base em informação suficiente em **todo** ponto de decisão | `references/context-engineering.md`, `references/memory-and-rag.md` | | **Tools** | *Interface clara* — nome intuitivo, parâmetro com exemplo, fronteira explicada | `references/tools-and-async.md` | | **Constrain** | *Fail-safe defaults* — capacidade desligada por padrão, habilitada explicitamente | `references/tools-and-async.md`, `references/coding-agent.md` | | **Verify** | *Isolamento de input* — o check de segurança olha só dado estruturado, nunca texto livre gerado pelo modelo | `references/coding-agent.md`, `references/evaluation.md` | | **Correct** | *Não exponha estado intermediário* até a falha ser confirmada irrecuperável | `references/coding-agent.md` | As cinco fecham um ciclo: Context e Tools sustentam a decisão, Constrain evita o erro, Verify d