ant-design

Ant Design

S - スコープ

• 対象：antd@^6 ＋ React 18-19。必要に応じて ant-design-pro@^5 ／ @ant-design/pro-components ／ @ant-design/x@^2 を使用します。
• ツール：オフラインでのコンポーネントメタデータ、デモ、変更履歴、移行、Lint、診断チェック、使用状況分析には @ant-design/cli を使用します。
• 方針：意思決定のガイダンスのみを提供し、エンドユーザー向けのチュートリアルは提供しません。
• 情報源の方針：公式ドキュメントのみを使用し、文書化されていない API や内部の .ant-* への依存は避けます。

デフォルトの前提

• 言語：TypeScript。
• スタイリング：まずトークンを使い、次に classNames／styles を使います。グローバルな上書きは避けます。
• プロバイダー：厳密な分離が必要な場合を除き、ルートに ConfigProvider を 1 つ配置します。

必須ルール

• antd コンポーネントのコードを書く前、または変更する前に、antd info <Component> --format json でコンポーネント API を確認してください。CLI でオフライン取得できる情報を、記憶に頼って補わないでください。
• antd CLI コマンドでは、必ず --format json を使用してください。
• プロジェクトのバージョンが重要な場合は、--version <x.y.z> で指定するか、CLI にローカルの node_modules から自動検出させてください。
• antd のコードを変更した後は、antd lint <changed-path> --format json を実行してください。
• antd CLI コマンドがクラッシュする、誤ったデータを返す、または文書化された動作に反する場合は、黙って回避策を取るのではなく、ユーザーの確認用に antd bug-cli のプレビューを作成してください。
• コンポーネントに関する質問では、まずコンポーネント名を公式のルートスラッグ {components}（小文字のケバブケース。例：TreeSelect -> tree-select、Button -> button）に対応付けてから、次の順でドキュメントを取得してください（まず中国語版、次に英語版）：
  1. https://ant.design/components/{components}-cn
  2. https://ant.design/components/{components}
  • 例：tree-select-cn -> tree-select、button-cn -> button。
• 文書化された antd／Pro／X の API のみを使用してください。
• props／イベント／コンポーネント名を捏造しないでください。
• 内部 DOM や .ant-* セレクターに依存しないでください。
• テーマの優先順位：グローバルトークン -> コンポーネントトークン -> エイリアストークン。

P - プロセス

1) 分類

• 対象レイヤーを特定します：コア antd、Pro、X。
• バージョン、レンダリングモード（CSR／SSR／ストリーミング）、データ規模を確認し、@ant-design/cli を主な検索手段にするか判断します。

2) 信頼できる情報源を調べる

• 構造化された情報の検索には、まずローカルの @ant-design/cli を優先します。
  • props／API には antd info
  • 動作するベースラインには antd demo
  • 全ドキュメントには antd doc
  • テーマ設定やスタイリングフックには antd token／antd semantic
  • デバッグやアップグレードには antd doctor、antd lint、antd usage、antd migrate、antd changelog
• 説明形式のドキュメントやクロスチェックが必要な場合は、次に公式コンポーネントドキュメントを取得します（まず -cn、次に英語版）。

3) 判断

• プロバイダーの基本方針：CSR -> ConfigProvider、SSR -> ConfigProvider ＋ StyleProvider。
• テーマ設定の基本方針：グローバルトークン -> コンポーネントトークン -> classNames／styles。
• 推奨事項に加えて、リスクと検証ポイント（SSR／アクセシビリティ／パフォーマンス）を示し、CLI の調査結果を使用した場合はそれを引用します。

O - 出力

• 判断理由を簡潔に（1～3 文で）説明します。
• 最小限のプロバイダー／テーマ設定方針を含めます。
• 具体的な SSR／アクセシビリティ／パフォーマンスのチェック項目を含めます。
• Pro の場合：ルート／メニュー／アクセス制御と CRUD スキーマの方針を含めます。
• X の場合：メッセージ／ツールのスキーマとストリーミング状態の方針を含めます。

参考資料

ファイル	使用する場面
references/antd-cli.md	API の検索、デモ、Lint、診断チェック、移行、変更履歴の確認、使用状況分析、バグ報告について、正確なオフライン CLI のワークフローが必要な場合。

リグレッションチェックリスト

• ルートに ConfigProvider が 1 つだけあること。SSR のスタイル順序とハイドレーションを検証済みであること。
• トークンを最初に定義し、広範なグローバル .ant-* オーバーライドを使用しないこと。
• テーブルに安定した rowKey があり、ソート／フィルター／ページネーションの導線が統一されていること。
• Select のリモートモードでは、リモート検索を使用する場合、ローカルフィルターを無効にすること。
• Upload の制御モードまたは非制御モードが明示され、失敗／再試行の経路があること。
• Pro のルート／メニュー／アクセス制御がバックエンドの強制適用と一貫していること。
• X のストリーミングが停止／再試行と決定論的なツール描画に対応していること。
• antd CLI を使用した場合、コマンドを --format json 付きで実行し、CLI の不具合は antd bug-cli のプレビューを通じて報告済みであること。