Agent Native Design

Valuta una CLI su una rubrica di 14 criteri attraverso sette principi di progettazione nativi per agenti e produce un piano di refactoring prioritizzato P0/P1/P2.

di Agents365-ai · Agents365-ai/agent-native-design

Promosso ★ 9.6/10

Agent Native Design — Valuta una CLI su una rubrica di 14 criteri attraverso sette principi di progettazione nativi per agenti e produce un piano di refactoring prioritizzato P0/P1/P2.

Cosa fa

Revisiona, progetta o refattorizza CLI destinate a servire contemporaneamente umani, agenti AI e orchestratori — controllando contratti stdout/JSON, codici di uscita, auto-descrizione, dry-run, livelli di sicurezza, delega di autenticazione e idempotenza rispetto a una rubrica valutata di 14 criteri mappata a sette principi di progettazione. Si attiva su richieste di valutare se una CLI è nativa per agenti, convertire un API/SDK in una CLI utilizzabile da agenti o refattorizzare i contratti di output/aiuto/errore di una CLI solo per umani.

Rapporto di test

Eseguita una revisione reale di una specifica di una CLI per appunti giocattolo: la rubrica della skill ha segnalato due difetti concreti che una revisione di base generica ha mancato del tutto — un login interattivo solo browser senza percorso token delegabile (Principio 7) e nessuna chiave di idempotenza sul comando add (note duplicate silenziose al retry dell'agente) — e ha restituito un punteggio riproducibile di 3/28 'non ancora nativo per agenti' invece di un'impressione vaga.

Testato il: 2026-07-16 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/Agents365-ai/agent-native-design.git
mkdir -p ~/.claude/skills
cp -r agent-native-design/skills/agent-native-design ~/.claude/skills/agent-native-design

Comandi e prompt di esempio

  • /agent-native-designValuta una CLI su una rubrica di 14 criteri attraverso sette principi di progettazione nativi per agenti e produce un piano di refactoring prioritizzato P0/P1/P2.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Is my CLI actually usable by an AI agent, not just a human typing?
  • Review whether this API's command-line wrapper is agent-native
  • Score my tool's stdout, exit codes, and auth flow for agent friendliness