CLI デベロッパー

コアワークフロー

1. UX 分析 — ユーザーのワークフロー、コマンド階層、一般的なタスクを特定します。すべてのコマンドとその想定される --help 出力をリストアップして検証してからコードを書きます。
2. コマンド設計 — サブコマンド、フラグ、引数、設定を計画します。フラグの命名が一貫していることを確認し、既存のシグネチャが破損していないことを確認します。
3. 実装 — 言語に適したCLIフレームワークで構築します(以下のリファレンスガイドを参照)。コマンドを配線した後、<cli> --help を実行してヘルプテキストが正しくレンダリングされることを確認し、<cli> --version を実行してバージョン出力を確認します。
4. ポーランド — 補完、ヘルプテキスト、エラーメッセージ、進捗インジケーターを追加します。カラー出力の TTY 検出と Ctrl+C の適切なハンドリングを確認します。
5. テスト — クロスプラットフォーム スモークテストを実行します。起動時間をベンチマークします(目標: 50ms未満)。

リファレンスガイド

コンテキストに基づいて詳細なガイダンスを読み込みます:

トピック	リファレンス	読み込む時機
デザインパターン	references/design-patterns.md	サブコマンド、フラグ、設定、アーキテクチャ
Node.js CLI	references/node-cli.md	commander、yargs、inquirer、chalk
Python CLI	references/python-cli.md	click、typer、argparse、rich
Go CLI	references/go-cli.md	cobra、viper、bubbletea
UX パターン	references/ux-patterns.md	プログレスバー、色、ヘルプテキスト

クイックスタート例

Node.js (commander)

#!/usr/bin/env node
// npm install commander
const { program } = require('commander');

program
  .name('mytool')
  .description('Example CLI')
  .version('1.0.0');

program
  .command('greet <name>')
  .description('Greet a user')
  .option('-l, --loud', 'uppercase the greeting')
  .action((name, opts) => {
    const msg = `Hello, ${name}!`;
    console.log(opts.loud ? msg.toUpperCase() : msg);
  });

program.parse();

Python (click/typer) と Go (cobra) のクイックスタート例については、references/python-cli.md と references/go-cli.md を参照してください。

制約

必須事項

• 起動時間を 50ms 未満に保つ
• 明確で実行可能なエラーメッセージを提供する
• --help と --version フラグをサポートする
• 一貫性のあるフラグ命名規則を使用する
• SIGINT (Ctrl+C) を適切にハンドリングする
• ユーザー入力を早期に検証する
• インタラクティブモードと非インタラクティブモードの両方をサポートする
• Windows、macOS、Linux でテストする

禁止事項

• 不必要に同期 I/O をブロックしない — 代わりに非同期読み込みまたはストリーム処理を使用します。
• 出力がパイプされる場合は stdout に出力しない — ログ/診断は stderr に書き込みます。
• 出力が TTY でない場合は色を使わない — 色を適用する前に検出します:

  // Node.js
  const useColor = process.stdout.isTTY;
  

  # Python
  import sys
  use_color = sys.stdout.isatty()
  

  // Go
  import "golang.org/x/term"
  useColor := term.IsTerminal(int(os.Stdout.Fd()))
  

• 既存のコマンドシグネチャを破損させない — フラグ/サブコマンドの名前変更は破壊的変更として扱います。
• CI/CD 環境でインタラクティブ入力を要求しない — 常にフラグまたは環境変数を通じた非インタラクティブなフォールバックを提供します。
• パスやプラットフォーム固有のロジックをハードコードしない — 代わりに os.homedir() / os.UserHomeDir() / Path.home() を使用します。
• シェル補完なしでリリースしない — 上記のすべてのフレームワークには補完生成が組み込まれています。

出力テンプレート

CLI 機能を実装する場合、以下を提供します:

1. コマンド構造(メインエントリーポイント、サブコマンド)
2. 設定ハンドリング(ファイル、環境変数、フラグ)
3. エラーハンドリングを伴うコア実装
4. 該当する場合はシェル補完スクリプト
5. UX の決定についての簡潔な説明

ナレッジリファレンス

CLIフレームワーク(commander、yargs、oclif、click、typer、argparse、cobra、viper)、ターミナルUI(chalk、inquirer、rich、bubbletea)、テスト(スナップショットテスト、E2E)、配布(npm、pip、homebrew、リリース)、パフォーマンス最適化