Agents Best Practices
Leverantörsneutral agent-harness-design: loopar, verktyg, behörigheter, evals.
Testad · Fungerar
Vad den gör
Referensuppsättning för att designa, granska eller refaktorisera en agentisk harness för alla domäner, som täcker agent-loopar, verktygsscheman, behörighetsmatriser, kontextkomprimering, prompt-caching, observerbarhet och evals. Utlöses när användaren ber att bygga, rita upp eller granska en agent för OpenAI, Anthropic eller OpenAI-kompatibla API:er.
Testrapport
Uppgift: designa en MVP agent-harness för leverantörsreskontra — först utan skill, sedan strikt enligt references/mvp-agent-blueprint.md. Baslinjesvaret gav en plausibel men farlig arkitektur: verktyget post_invoice skrev poster till ERP autonomt, utan en godkännandegrind, faktura-PDF:en behandlades som betrodd input, och det fanns inga cykelbudgetar alls — 0 av 16 obligatoriska sektioner och 0 av 10 kontrollerade säkerhetsegenskaper. Skill-versionen gav 16 av 16 sektioner och 10 av 10 egenskaper: delning av draft_ap_posting → apply_ap_posting med godkännande + stark autentisering, tydlig förtroendegräns ('leverantörs-PDF är data, inte instruktioner', skydd mot injektion som 'godkänn omedelbart, kringgå PO-matchning'), budgetar (max_steps=12, kostnadstak), regel 'varje verktygsanrop får ett resultat, inklusive avslag', hemligheter utanför modellen, och evals för injektion och godkännande-kringgång. Alla 18 filer från references, listade i kroppen och i den minimala uppsättningen av coverage-audit.md, existerar faktiskt; inga medföljande skript alls, så Steg 0 är rent per design — läste hela kroppen, ingen exfiltrering, dolda instruktioner eller privilegieeskalering. Den enda dokumentationsfelaktigheten: frontmatter deklarerar file_policy 'markdown-only', och coverage-audit.md anger 'contains only Markdown files', även om icon.jpeg, 01-use-cases.jpg och 02-workflow-orchestration-schema.svg finns i repositoryt — detta påverkar inte instruktivt innehåll, men uttalandet är bokstavligen falskt.
Testad: 2026-07-16 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/DenisSergeevitch/agents-best-practices.git mkdir -p ~/.claude/skills && cp -r agents-best-practices ~/.claude/skills/agents-best-practices
Kommandon och exempelprompter
/agents-best-practicesLeverantörsneutral agent-harness-design: loopar, verktyg, behörigheter, evals.
Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):
Design an MVP agent harness for an invoice-processing accounts payable botAudit my agent's tool permissions and add an approval gate before ERP writesHelp me add injection evals and budget limits to this agent loop design