Communityコーディング&開発github.com

steipete/create-cli

CLI UX/設計仕様:引数、フラグ、ヘルプ、出力、エラー、設定、ドライラン。

create-cli とは?

このスキルは、人間にとって使いやすく、かつスクリプトからも扱いやすいCLI(コマンドラインインターフェース)の設計を支援します。コマンド名や引数、フラグ、出力形式、エラーハンドリング、設定の優先順位など、CLIの表面領域(シンタックスと動作)を定義するための包括的なガイドラインとテンプレートを提供します。 主な特徴として、まずユーザーとの迅速な質問応答でインターフェースを確定し、その後、コマンドツリー、引数/フラグ表、サブコマンドのセマンティクス、出力ルール、終了コードマップ、安全ルール(ドライラン、確認、強制実行など)、設定/環境変数の優先順位、シェル補完、そして具体的な使用例を含むコンパクトな仕様書を生成します。 このスキルは言語に依存せず、`clig.dev` のガイドラインをデフォルトの基準として適用します。プラットフォーム(macOS/Linux/Windows)や実行環境(単一バイナリ、ランタイム)に関する制約も考慮します。設計パラメータの要求があれば、実装の詳細には踏み込まずに設計に集中します。

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

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

CLIを作成する

CLIの表面領域(シンタックス+動作)を、人間ファーストかつスクリプトフレンドリーに設計します。

最初に行うこと

  • agent-scripts/skills/create-cli/references/cli-guidelines.md を読み、デフォルトの評価基準として適用します。
  • 上流/完全版ガイドライン:https://clig.dev/ (変更提案:https://github.com/cli-guidelines/cli-guidelines)
  • インターフェースを確定するために必要な最小限の質問のみを行います。

明確化(迅速に)

質問し、ユーザーが不明な場合は最善の推測でデフォルトを設定して進めます:

  • コマンド名+1文の目的。
  • 主なユーザー:人間、スクリプト、またはその両方。
  • 入力ソース:引数 vs 標準入力;ファイル vs URL;シークレット(フラグ経由は不可)。
  • 出力契約:人間向けテキスト、--json、--plain、終了コード。
  • 対話性:プロンプトは許可? --no-input が必要? 破壊的操作には確認?
  • 設定モデル:フラグ/環境/設定ファイル;優先順位;XDG vs リポジトリローカル。
  • プラットフォーム/ランタイム制約:macOS/Linux/Windows;単一バイナリ vs ランタイム。

成果物(出力すべきもの)

CLIを設計する際、ユーザーが実装可能なコンパクトな仕様を作成します:

  • コマンドツリー+USAGE概要。
  • 引数/フラグ表(型、デフォルト値、必須/オプション、例)。
  • サブコマンドのセマンティクス(各サブコマンドの動作;冪等性;状態変更)。
  • 出力ルール:標準出力 vs 標準エラー出力;TTY検出;--json/--plain;--quiet/--verbose。
  • エラー+終了コードマップ(主要な障害モード)。
  • 安全ルール:--dry-run、確認、--force、--no-input。
  • 設定/環境変数ルール+優先順位(フラグ > 環境変数 > プロジェクト設定 > ユーザー設定 > システム)。
  • シェル補完に関する説明(該当する場合):インストール/発見可能性;生成コマンドまたはバンドルスクリプト。
  • 5~10個の使用例(一般的なフロー;パイプ/標準入力の例を含む)。

デフォルトの慣例(ユーザーが別途指定しない限り)

  • -h/--help は常にヘルプを表示し、他の引数を無視します。
  • --version はバージョンを標準出力に出力します。
  • 主要データは標準出力へ;診断/エラーは標準エラー出力へ。
  • 機械出力には --json を追加し、安定した行ベースのテキストには --plain を検討します。
  • プロンプトは標準入力がTTYの場合のみ;--no-input はプロンプトを無効化します。
  • 破壊的操作:対話的な確認+非対話的には --force または明示的な --confirm=... が必要。
  • NO_COLOR、TERM=dumb を尊重;--no-color を提供します。
  • Ctrl-C の処理:迅速に終了;限定的なクリーンアップ;可能な限りクラッシュオンリー型に。

テンプレート(回答にコピーして使用)

CLI仕様の骨格

以下のセクションを埋め、関連のないものは削除します:

  1. 名前: mycmd
  2. 1行説明: ...
  3. USAGE:
    • mycmd [グローバルフラグ] <サブコマンド> [引数]
  4. サブコマンド:
    • mycmd init ...
    • mycmd run ...
  5. グローバルフラグ:
    • -h, --help
    • --version
    • -q, --quiet / -v, --verbose(正確に定義)
    • --json / --plain(該当する場合)
  6. 入出力契約:
    • 標準出力:
    • 標準エラー出力:
  7. 終了コード:
    • 0 成功
    • 1 一般的な失敗
    • 2 不正な使用法(パース/検証)
    • (実際に有用な場合のみコマンド固有のコードを追加)
  8. 環境変数/設定:
    • 環境変数:
    • 設定ファイルのパス+優先順位:
  9. 例:
    • …

注意事項

  • パースライブラリ(言語固有)の推奨は、尋ねられた場合のみ行います。それ以外はこのスキルを言語に依存しない形に保ちます。
  • リクエストが「設計パラメータ」である場合、実装に踏み込まないでください。

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.

関連スキル