Communitygithub.com

metyatech/skill-cli-design

Agent-Fähigkeit zum Entwerfen und Überprüfen von CLI-Werkzeugen

Was ist skill-cli-design?

Diese Fähigkeit befähigt KI-Agenten (wie etwa Claude Code, Cursor oder Codex), CLI-Werkzeuge nach einem einheitlichen, professionellen Standard zu entwerfen und zu überprüfen. Sie deckt sieben kritische Bereiche ab: Hilfe- und Versionsflags, Ein-/Ausgabe-Pipelines (stdin/stdout), Sicherheitsmechanismen (dry-run, force), deterministische Exit-Codes, JSON-Konfiguration mit Schema-Validierung, Umgebungsvariablen für sensible Daten sowie nicht-interaktive Modi für CI/CD. Die Fähigkeit stellt sicher, dass erstellte CLIs immer `--help`, `-h`, `--version` und `-V` anbieten, strukturierte Daten über `--json` ausgeben können und bei zerstörerischen Operationen explizite Bestätigungsmechanismen (`--yes`, `--force`) besitzen. Sie ist plattformunabhängig und funktioniert mit jedem gängigen KI-Coding-Assistenten, der SKILL.md-Anweisungen unterstützt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add metyatech/skill-cli-design

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Checkliste für CLI-Design

Hilfe und Version

  • Ein CLI MUSS --help- und -h-Flags mit klarer Verwendung, Optionen und Beispielen bereitstellen. Beispiele MÜSSEN alle erforderlichen Parameter enthalten.
  • Ein CLI MUSS --version- und -V-Flags bereitstellen. Der Agent MUSS -v für --verbose reservieren.

Eingabe und Ausgabe

  • Ein CLI MUSS stdin/stdout-Piping unterstützen und MUSS Ausgabeumleitung erlauben (z.B. --output zur Dateierstellung).
  • Ein CLI, das strukturierte Daten ausgibt, MUSS eine maschinenlesbare Ausgabe bieten (z.B. --json).

Sicherheit und Kontrolle

  • Ein CLI, das Daten ändert oder löscht, MUSS --dry-run und ein explizites Bestätigungs-Flag (--yes oder --force) bereitstellen.
  • Ein CLI MUSS kontrollierbare Protokollierung bieten (--quiet, --verbose, oder --trace).
  • Ein CLI MUSS deterministische Exit-Codes verwenden: 0 für Erfolg, ungleich 0 für Fehler. Der Agent DARF KEINE stillen Fallbacks einführen.
  • Ein CLI MUSS für CI/CD-Umgebungen streng nicht-interaktive Modi implementieren.

Konfiguration

  • Ein CLI, das JSON-Konfiguration verwendet, MUSS ein JSON-Schema definieren und aktualisieren und MUSS die Konfiguration beim Laden validieren.
  • Ein CLI MUSS die Konfiguration über Umgebungsvariablen für sensible oder umgebungsspezifische Daten unterstützen.

Interaktive Eingabeaufforderungen

  • Eine interaktive Eingabeaufforderung MUSS vor dem Fragen den erforderlichen Kontext bereitstellen. Bei Ja/Nein-Eingabeaufforderungen MUSS Enter „Ja“ bedeuten und „n“ MUSS „Nein“ bedeuten.

Verwandte Skills