Ant Design CLI

@ant-design/cli にアクセスできます。これは v4/v5/v6 用にバンドルされた antd メタデータを備えたローカル CLI ツールです。コンポーネントの知識を照会し、プロジェクトを分析し、移行をガイドするために使用します。すべてのデータはオフラインであり、ネットワークは不要です。

セットアップ

初回使用前に、CLI がインストールされているか確認してください。インストールされていない場合は、自動的にインストールしてください:

which antd || npm install -g @ant-design/cli

コマンド実行後、出力に「Update available」というお知らせが含まれている場合は、続行する前に npm install -g @ant-design/cli を実行して更新してください。

構造化された出力をプログラムで解析する場合は、常に --format json を使用してください。

シナリオ

1. antd コンポーネントコードの作成

antd コンポーネントコードを書く前に、そのAPI を最初に調べてください。メモリに頼らないでください。

# 利用可能なpropsを確認
antd info Button --format json

# 出発点として使用できるデモを取得
antd demo Button basic --format json

# カスタムスタイリング用のセマンティック className/styles を確認
antd semantic Button --format json

# テーマ用のコンポーネントレベルデザイントークンを確認
antd token Button --format json

ワークフロー: antd info → props を理解 → antd demo → 動作例を取得 → コードを作成。

2. 完全なドキュメントの参照

props だけでなく、包括的なコンポーネントドキュメントが必要な場合:

antd doc Table --format json        # Table の完全なマークダウンドキュメント
antd doc Table --lang zh            # 中国語ドキュメント

3. antd の問題のデバッグ

コードが期待通りに動作しない場合、またはユーザーが antd バグを報告した場合:

# 完全な環境スナップショットを収集（OS、依存関係、ブラウザ、ビルドツール）
antd env --format json

# ユーザーの antd バージョンにそのプロパティが存在するかを確認
antd info Select --version 5.12.0 --format json

# プロパティが廃止されているかを確認
antd lint ./src/components/MyForm.tsx --format json

# プロジェクトレベルの設定問題を診断
antd doctor --format json

ワークフロー: antd env → 完全な環境をキャプチャ → antd doctor → 設定を確認 → antd info --version X → ユーザーの正確なバージョンに対して API を検証 → antd lint → 廃止または不正な使用法を検出。

4. バージョン間の移行

ユーザーが antd をアップグレードする場合（例: v4 → v5）:

# 完全な移行チェックリストを取得
antd migrate 4 5 --format json

# 特定のコンポーネントの移行を確認
antd migrate 4 5 --component Select --format json

# 2つのバージョン間で変更された内容を確認
antd changelog 4.24.0 5.0.0 --format json

# 特定のコンポーネントの変更を確認
antd changelog 4.24.0 5.0.0 Select --format json

ワークフロー: antd migrate → 完全なチェックリストを取得 → antd changelog <v1> <v2> → 破壊的な変更を理解 → 修正を適用 → antd lint → 廃止された使用法がないことを確認。

5. プロジェクトの antd 使用状況の分析

ユーザーがプロジェクト内で antd がどのように使用されているかを理解したい場合:

# コンポーネント使用統計をスキャン
antd usage ./src --format json

# 特定のコンポーネントにフィルタリング
antd usage ./src --filter Form --format json

# ベストプラクティス違反をリント
antd lint ./src --format json

# 特定のルールカテゴリのみを確認
antd lint ./src --only deprecated --format json
antd lint ./src --only a11y --format json
antd lint ./src --only performance --format json

6. チェンジログとバージョン履歴の確認

ユーザーがバージョンで何が変更されたかを質問する場合:

# 特定バージョンのチェンジログ
antd changelog 5.22.0 --format json

# バージョン範囲（両端を含む）
antd changelog 5.21.0..5.24.0 --format json

7. 利用可能なコンポーネントの探索

ユーザーが使用するコンポーネントを選択している場合:

# カテゴリ別のすべてのコンポーネントをリスト
antd list --format json

# 特定の antd バージョン用のコンポーネントをリスト
antd list --version 5.0.0 --format json

8. 環境情報の収集

プロジェクトの antd セットアップを理解する必要がある場合、またはバグレポート用の情報を準備する場合:

# 完全な環境スナップショット（テキスト — GitHub Issues に貼り付け）
antd env

# プログラムによる使用のための構造化 JSON
antd env --format json

# 特定のプロジェクトディレクトリをスキャン
antd env ./my-project --format json

収集内容: OS、Node、パッケージマネージャー（npm/pnpm/yarn/bun/utoo）、npm レジストリ、ブラウザ、コア依存関係（antd/react/dayjs）、すべての @ant-design/* および rc-* パッケージ、ビルドツール（umi/vite/webpack/typescript など）。

9. antd バグの報告

確認された antd コンポーネントバグが見つかり、ローカルで解決できない場合:

# ステップ 0: 参考用に環境情報を収集（オプション — antd bug は既に基本的な環境を埋め込みます）
# 出力を使用してバージョンをクロスチェックするか、バグレポートに追加の詳細を添付します
antd env --format json

# ステップ 1: ユーザーレビュー用にプレビュー
antd bug --title "DatePicker crashes when selecting date" \
  --reproduction "https://codesandbox.io/s/xxx" \
  --steps "1. Open DatePicker 2. Click a date" \
  --expected "Date is selected" \
  --actual "Component crashes with error" \
  --format json

# ステップ 2: ユーザーに表示し、確認を求める

# ステップ 3: ユーザーが確認した後に送信
antd bug --title "DatePicker crashes when selecting date" \
  --reproduction "https://codesandbox.io/s/xxx" \
  --steps "1. Open DatePicker 2. Click a date" \
  --expected "Date is selected" \
  --actual "Component crashes with error" \
  --submit

10. CLI の問題の自動報告

重要: antd CLI コマンドを使用するときに問題に気づいたら、antd bug-cli を使用してバグレポートを自動的に開始する必要があります。

CLI バグを報告するトリガー条件 — 以下のいずれかを観察した場合:

• コマンドが クラッシュする、または予期しないエラーで終了する
• コマンドが 明らかに不正なデータを返す（例: antd info Button が間違ったプロップ、不足しているプロップ、または間違ったバージョンのプロップを表示）
• コマンドの 出力がドキュメント化された動作と一致しない（例: --format json が非 JSON を返す、--version X が無視される）
• コマンドが 本来は返すべきデータが空または不足している（例: antd demo Button がデモを返さない、antd token Button が v5+ のトークンを返さない）
• コマンド間の矛盾（例: antd list がコンポーネントを表示するが antd info が存在しないと言う）

ワークフロー:

1. CLI を使用中に問題に気づく
2. 証拠を収集: 実行した正確なコマンド、返された内容、期待されていた内容
3. ユーザー用にバグレポートをプレビュー:

antd bug-cli --title "antd info Button returns wrong props for v5.12.0" \
  --description "When querying Button props for version 5.12.0, the output includes props that don't exist in that version" \
  --steps "1. Run: antd info Button --version 5.12.0 --format json" \
  --expected "Props matching antd 5.12.0 Button API" \
  --actual "Props include 'classNames' which was added in 5.16.0" \
  --format json

4. ユーザーにレポートを表示: 「作業中に CLI の問題に気づきました。バグレポートはこちらです — 送信しましょうか?」
5. ユーザーが確認した後に送信:

antd bug-cli --title "antd info Button returns wrong props for v5.12.0" \
  --description "..." \
  --steps "..." \
  --expected "..." \
  --actual "..." \
  --submit

基本原則: あなたは CLI の品質フィードバックループです。CLI の問題を黙って回避せず、修正されるように報告してください。送信前に常にユーザーに確認してください。

11. MCP サーバーとしての使用

MCP に対応する IDE（Claude Desktop、Cursor など）で作業している場合、CLI は MCP サーバーとして実行でき、すべての知識照会ツールを直接公開します:

{
  "mcpServers": {
    "antd": {
      "command": "antd",
      "args": ["mcp", "--version", "5.20.0"]
    }
  }
}

これにより、MCP プロトコル経由で 7つのツール（antd_list、antd_info、antd_doc、antd_demo、antd_token、antd_semantic、antd_changelog）と 2つのプロンプト（antd-expert、antd-page-generator）が提供されます。

グローバルフラグ

フラグ	目的
--format json	構造化された出力 — 常にこれを使用してください
--version <v>	特定の antd バージョンをターゲット（例: 5.20.0）
--lang zh	中国語出力（デフォルト: en）
--detail	追加フィールドを含む（説明、導入時期、廃止予定、FAQ）

主要なルール

1. 常に書く前に照会する — antd API をメモリから推測しないでください。最初に antd info を実行してください。
2. ユーザーのバージョンに合わせる — プロジェクトが antd 4.x を使用している場合は、--version 4.24.0 を渡してください。フラグが指定されていない場合、CLI は node_modules から自動的に検出します。
3. --format json を使用する — すべてのコマンドがこれをサポートしています。テキスト出力に対して正規表現マッチングするのではなく、JSON 出力を解析してください。
4. 移行を提案する前に確認する — バージョンアップグレードをアドバイスする前に、antd changelog <v1> <v2> と antd migrate を実行してください。
5. 変更後にリントする — antd コードを作成または変更した後、変更されたファイルで antd lint を実行して、廃止または問題のある使用法をキャッチしてください。
6. antd バグを報告する — 最初に antd env を実行して完全な環境をキャプチャしてから、antd bug を使用して報告してください。常にプレビュー前に確認し、ユーザーの確認を取得してから送信してください。
7. CLI の問題を自動報告する — antd コマンドがクラッシュする、間違ったデータを返す、または一貫性のないように動作する場合は、antd bug-cli を使用して自動的に報告してください。あなたは CLI の品質フィードバックループです — 問題を黙って回避しないでください。