cli-design-expert
Professionelle Befehlszeilenschnittstellen gestalten
Intuitive CLI-Tools zu erstellen ist ohne klare Designmuster eine Herausforderung. Diese Skill bietet fachkundige Anleitung zur Erstellung von Befehlen, die wie erwartet funktionieren, mit progressiver Offenlegung und hilfreichen Fehlermeldungen.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "cli-design-expert". Entwirf einen CLI-Befehl zum Erstellen von Feature-Branches mit einem Hilfesystem und Fehlerbehandlung
النتيجة المتوقعة:
- Befehl: branch create <name> [--base <branch>] [--no-PR]
- Exit-Codes: 0=Erfolg, 1=Fehler, 2=ungültige Verwendung, 66=keine Eingabe
- Hilfe zeigt: Verwendung, Optionen, Beispiele und häufige Probleme
- Fehler bei fehlendem Branch-Namen zeigt Vorschlag: 'Mit --base develop ausführen'
- Gefährliche Aktionen wie erzwungenes Löschen erfordern --force-Flag oder Bestätigungsaufforderung
استخدام "cli-design-expert". Wie sollte ich Exit-Codes für mein CLI-Tool gestalten
النتيجة المتوقعة:
- Verwende Standard-Exit-Codes: 0 für Erfolg, 1 für allgemeine Fehler
- Verwende 2 für ungültige Verwendung oder Argumente
- Verwende 66, wenn Eingabedatei nicht gefunden wurde
- Verwende 78 für Konfigurationsfehler
- Dokumentiere alle Exit-Codes in der --help-Ausgabe
استخدام "cli-design-expert". Erstelle ein Fehlermeldungsmuster für fehlende Konfiguration
النتيجة المتوقعة:
- Zeige, welche Datei gesucht wurde und wo gesucht wurde
- Biete einen konkreten Fix-Befehl
- Verlinke auf Dokumentation für weitere Hilfe
- Verwende Farbe, um den Fehler und die Lösung hervorzuheben
التدقيق الأمني
آمنPure documentation skill containing only CLI design guidance. No executable code, scripts, network operations, or file system access. All 126 static findings are false positives caused by the scanner misclassifying documentation examples as executable code. Safe for publication.
عوامل الخطر
🌐 الوصول إلى الشبكة (3)
📁 الوصول إلى نظام الملفات (1)
⚙️ الأوامر الخارجية (53)
درجة الجودة
ماذا يمكنك بناءه
Benutzerfreundliche CLI-Tools entwickeln
Befehle erstellen, die etablierten Mustern wie git und npm folgen, mit klarer Hilfe und Fehlerbehandlung.
Akzeptanz interner Tools verbessern
CLIs gestalten, die Entwickler tatsächlich nutzen möchten, mit progressiver Offenlegung und exzellenter Dokumentation.
Projekt-Befehlsschnittstellen optimieren
Professionellen Feinschliff zu Projekt-Tools hinzufügen mit semantischen Farben, Tabellen und hilfreichen Fehlervorschlägen.
جرّب هذه الموجهات
Entwirf eine CLI-Befehlsstruktur für [dein Tool]. Es soll [beschreibe, was es tut]. Folge CLI-Best-Practices.
Erstelle ein dreistufiges Hilfesystem für einen Befehl namens [Name] mit Unterbefehlen [liste sie auf]. Füge Beispiele auf jeder Ebene hinzu.
Gestalte Fehlerbehandlung für eine CLI, die [Eingabetyp] validiert. Zeige Fehlercodes, Meldungen und Benutzervorschläge für häufige Fehler.
Erstelle einen interaktiven Assistenten-Ablauf für [Aufgabe] mit Bestätigungen für gefährliche Aktionen. Zeige Code-Muster für inquirer.js-Integration.
أفضل الممارسات
- Folge dem Substantiv-Verb-Muster (git commit, npm install) für intuitive Befehlsstrukturen
- Biete sowohl kurze (-h) als auch lange (--help) Optionen für alle gängigen Flags
- Gestalte Fehlermeldungen so, dass sie erklären, was schiefgelaufen ist UND wie es zu beheben ist
تجنب
- Verwendung kryptischer Fehlercodes ohne Erklärungen oder Vorschläge
- Benutzer zwingen, externe Dokumentation für grundlegende Verwendung zu lesen
- Destruktive Aktionen ohne Bestätigung oder Force-Flags durchführen
الأسئلة المتكررة
Funktioniert diese Skill mit allen Programmiersprachen?
Welche Exit-Codes sollte meine CLI verwenden?
Wie unterstütze ich Shell-Completion?
Sind meine Daten mit dieser Skill sicher?
Warum werden meine Fehlermeldungen von Benutzern ignoriert?
Wie unterscheidet sich dies von der direkten Verwendung von commander.js oder oclif?
تفاصيل المطور
المؤلف
DammianMillerالترخيص
MIT
المستودع
https://github.com/DammianMiller/universal-agent-memory/tree/main/.factory/skills/cli-design-expertمرجع
main
بنية الملفات
📄 SKILL.md