steipete/create-cli

Conception de l'interface CLI : arguments, drapeaux, aide, sortie, erreurs, configuration, exécution à blanc.

Qu'est-ce que create-cli ?

Cette compétence guide la conception d'interfaces en ligne de commande (CLI) en mettant l'accent sur l'expérience humaine et la compatibilité avec les scripts. Elle fournit un processus structuré pour clarifier les besoins, produire un cahier des charges complet incluant l'arborescence des commandes, les drapeaux, les codes de sortie, les règles de sécurité (dry-run, confirmation, force), et la gestion de la configuration. La compétence s'appuie sur les directives clig.dev et propose des modèles prêts à l'emploi pour les spécifications CLI. Elle est indépendante du langage de programmation et applicable sur toutes les plateformes (macOS, Linux, Windows) pour des outils en binaire unique ou avec environnement d'exécution.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/create-cli

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Créer CLI

Concevoir la surface d'une CLI (syntaxe + comportement), priorité à l'humain, adaptée aux scripts.

À faire en premier

  • Lire agent-scripts/skills/create-cli/references/cli-guidelines.md et l'appliquer comme référentiel par défaut.
  • Références complètes : https://clig.dev/ (proposer des modifications : https://github.com/cli-guidelines/cli-guidelines)
  • Poser uniquement le minimum de questions de clarification nécessaires pour figer l'interface.

Clarifier (rapidement)

Demander, puis utiliser les valeurs par défaut les plus probables si l'utilisateur n'est pas sûr :

  • Nom de la commande + objectif en une phrase.
  • Utilisateur principal : humains, scripts, ou les deux.
  • Sources d'entrée : arguments vs stdin ; fichiers vs URLs ; secrets (jamais via les drapeaux).
  • Contrat de sortie : texte lisible, --json, --plain, codes de sortie.
  • Interactivité : invites autorisées ? besoin de --no-input ? confirmations pour les opérations destructrices ?
  • Modèle de configuration : drapeaux/env/fichier de config ; précédence ; XDG vs local au dépôt.
  • Contraintes de plateforme/environnement d'exécution : macOS/Linux/Windows ; binaire unique vs environnement.

Livrables (quoi produire)

Lors de la conception d'une CLI, produire un cahier des charges compact que l'utilisateur peut implémenter :

  • Arborescence des commandes + synopsis USAGE.
  • Tableau des arguments/drapeaux (types, valeurs par défaut, obligatoires/optionnels, exemples).
  • Sémantique des sous-commandes (ce que chacune fait ; idempotence ; changements d'état).
  • Règles de sortie : stdout vs stderr ; détection TTY ; --json/--plain ; --quiet/--verbose.
  • Carte des erreurs + codes de sortie (principaux modes de défaillance).
  • Règles de sécurité : --dry-run, confirmations, --force, --no-input.
  • Règles de configuration/env + précédence (drapeaux > env > config projet > config utilisateur > système).
  • Histoire de complétion shell (si pertinent) : installation/découvrabilité ; commande de génération ou scripts fournis.
  • 5 à 10 exemples d'invocations (flux courants ; inclure des exemples avec pipe/stdin).

Conventions par défaut (sauf indication contraire de l'utilisateur)

  • -h/--help affiche toujours l'aide et ignore les autres arguments.
  • --version affiche la version sur stdout.
  • Données principales sur stdout ; diagnostics/erreurs sur stderr.
  • Ajouter --json pour la sortie machine ; envisager --plain pour un texte stable basé sur des lignes.
  • Invites uniquement lorsque stdin est un TTY ; --no-input désactive les invites.
  • Opérations destructrices : confirmation interactive + en mode non interactif nécessite --force ou --confirm=... explicite.
  • Respecter NO_COLOR, TERM=dumb ; fournir --no-color.
  • Gérer Ctrl-C : sortie rapide ; nettoyage limité ; être crash-only si possible.

Modèles (copier dans votre réponse)

Squelette de spécification CLI

Remplir ces sections, supprimer ce qui est sans pertinence :

  1. Nom : macommande
  2. Phrase d'accroche : ...
  3. USAGE :
    • macommande [drapeaux globaux] <sous-commande> [args]
  4. Sous-commandes :
    • macommande init ...
    • macommande executer ...
  5. Drapeaux globaux :
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose (définir exactement)
    • --json / --plain (si applicable)
  6. Contrat d'E/S :
    • stdout :
    • stderr :
  7. Codes de sortie :
    • 0 succès
    • 1 échec générique
    • 2 utilisation invalide (analyse/validation)
    • (ajouter des codes spécifiques à la commande uniquement si réellement utiles)
  8. Env/config :
    • variables d'environnement :
    • chemin du fichier de configuration + précédence :
  9. Exemples :
    • …

Notes

  • Privilégier la recommandation d'une bibliothèque d'analyse (spécifique à un langage) uniquement si demandé ; sinon, garder cette compétence indépendante du langage.
  • Si la demande est "paramètres de conception", ne pas dériver vers l'implémentation.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills associés