Agent Tool Contracts

Designa agent/CLI-verktygsscheman, namngivning, fel och idempotens för LLM-anropare.

av charlieviettq · charlieviettq/awesome-agent-skill

Testad · Fungerar ★ 9.2/10

Agent Tool Contracts — Designa agent/CLI-verktygsscheman, namngivning, fel och idempotens för LLM-anropare.

Vad den gör

Ger konkreta regler och en granskningschecklista för att designa verktyg, parameter-scheman och CLI-ytor avsedda att anropas av LLM-agenter: verb-substantiv namngivning, minimala obligatoriska parametrar, explicit sidoeffekt-formulering, begränsad/paginerad utdata, stabila {kod,meddelande} fel, och en idempotens-tabell för läs/skapa/uppdatera/radera. Triggers när användaren definierar verktyg för agenter, SDK:er, MCP-servrar eller AI-inbyggda CLIs.

Testrapport

Att tillämpa dess idempotens-tabell på ett `delete_project`-verktyg förvandlade en bar 'radera och returnera framgång' baslinje till en två-stegs bekräftelse + mjuk-radera design med ett stabilt NOT_FOUND/CONFIRMATION_REQUIRED fel-schema — en konkret, checklista-driven förbättring över standardutdata.

Testad: 2026-07-15 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/charlieviettq/awesome-agent-skill
mkdir -p ~/.claude/skills
cp -r awesome-agent-skill/.claude/skills/agent-tool-contracts ~/.claude/skills/agent-tool-contracts

Kommandon och exempelprompter

/agent-tool-contractsDesigna agent/CLI-verktygsscheman, namngivning, fel och idempotens för LLM-anropare.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

Help me design the parameter schema for a new MCP tool that creates PRs
Review this CLI's argument names and exit codes for AI agent compatibility
What's the best idempotency pattern for an agent-facing delete tool?

Läs hela rapporten →