/design-system
見慣れないプレースホルダーや接続されているツールの確認が必要な場合は、CONNECTORS.md を参照してください。
デザインシステムを管理します — 一貫性を監査し、コンポーネントを文書化し、新しいパターンを設計します。
使用方法
/design-system audit # システム全体の監査
/design-system document [component] # コンポーネントの文書化
/design-system extend [pattern] # 新しいコンポーネントまたはパターンの設計
デザインシステムの構成要素
デザイントークン
ビジュアル言語を定義する原子値:
- 色(ブランド、セマンティック、ニュートラル)
- タイポグラフィ(スケール、ウェイト、行間)
- スペーシング(スケール、コンポーネントパディング)
- ボーダー(半径、幅)
- シャドウ(エレベーションレベル)
- モーション(持続時間、イージング)
コンポーネント
定義された以下の要素を持つ再利用可能なUI要素:
- バリアント(プライマリ、セカンダリ、ゴースト)
- ステート(デフォルト、ホバー、アクティブ、無効、ローディング、エラー)
- サイズ(sm、md、lg)
- 動作(インタラクション、アニメーション)
- アクセシビリティ(ARIA、キーボード)
パターン
コンポーネントを組み合わせた一般的なUIソリューション:
- フォーム(入力グループ、バリデーション、送信)
- ナビゲーション(サイドバー、タブ、パンくずリスト)
- データ表示(テーブル、カード、リスト)
- フィードバック(トースト、モーダル、インラインメッセージ)
原則
- 創造性よりも一貫性 — システムはチームが車輪の再発明をしないために存在する
- 制約の中での柔軟性 — コンポーネントは構成可能であって、硬直的であってはならない
- すべてを文書化する — 文書化されていなければ存在しないも同然
- バージョン管理と移行 — 破壊的変更には移行パスが必要
出力 — 監査
## デザインシステム監査
### サマリー
**レビュー済みコンポーネント数:** [X] | **発見された問題数:** [X] | **スコア:** [X/100]
### 命名の一貫性
| 問題 | コンポーネント | 推奨事項 |
|------|----------------|----------|
| [不整合な命名] | [リスト] | [採用すべき標準] |
### トークンカバレッジ
| カテゴリ | 定義済み | 見つかったハードコード値 |
|----------|----------|----------------------|
| 色 | [X] | [X]個のハードコードされた16進数値 |
| スペーシング | [X] | [X]個の任意の値 |
| タイポグラフィ | [X] | [X]個のカスタムフォント/サイズ |
### コンポーネント完全性
| コンポーネント | ステート | バリアント | ドキュメント | スコア |
|--------------|--------|----------|------------|-------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |
### 優先アクション
1. [最も影響力のある改善]
2. [第2の優先事項]
3. [第3の優先事項]
出力 — 文書化
## コンポーネント: [名前]
### 説明
[このコンポーネントが何であるか、いつ使用するか]
### バリアント
| バリアント | 使用するタイミング |
|-----------|----------------|
| [プライマリ] | [主要なアクション] |
| [セカンダリ] | [補助的なアクション] |
### プロパティ
| プロパティ | 型 | デフォルト | 説明 |
|----------|------|---------|-------------|
| [prop] | [type] | [default] | [description] |
### ステート
| ステート | 視覚 | 動作 |
|---------|------|--------|
| デフォルト | [説明] | — |
| ホバー | [説明] | [インタラクション] |
| アクティブ | [説明] | [インタラクション] |
| 無効 | [説明] | 非インタラクティブ |
| ローディング | [説明] | [アニメーション] |
### アクセシビリティ
- **ロール:** [ARIAロール]
- **キーボード:** [Tab、Enter、Escapeの動作]
- **スクリーンリーダー:** [次のようにアナウンスされる...]
### 推奨事項と禁止事項
| ✅ 推奨 | ❌ 禁止 |
|--------|---------|
| [ベストプラクティス] | [アンチパターン] |
### コード例
[フレームワークに適したコードスニペット]
出力 — 拡張
## 新しいコンポーネント: [名前]
### 問題
[このコンポーネントが対処するユーザーニーズまたはギャップ]
### 既存のパターン
| 関連コンポーネント | 類似点 | 不足している理由 |
|-------------------|--------|-----------------|
| [コンポーネント] | [共有するもの] | [不足しているもの] |
### 提案デザイン
#### API / プロパティ
| プロパティ | 型 | デフォルト | 説明 |
|----------|------|---------|-------------|
| [prop] | [type] | [default] | [description] |
#### バリアント
| バリアント | 使用するタイミング | 視覚 |
|-----------|----------------|--------|
| [バリアント] | [シナリオ] | [説明] |
#### ステート
| ステート | 動作 | 備考 |
|---------|--------|------|
| デフォルト | [説明] | — |
| ホバー | [説明] | [インタラクション] |
| 無効 | [説明] | 非インタラクティブ |
| ローディング | [説明] | [アニメーション] |
#### 使用するトークン
- 色: [どのトークン]
- スペーシング: [どのトークン]
- タイポグラフィ: [どのトークン]
### アクセシビリティ
- **ロール:** [ARIAロール]
- **キーボード:** [期待されるインタラクション]
- **スクリーンリーダー:** [次のようにアナウンスされる...]
### 未解決の質問
- [デザインレビューが必要な決定事項]
- [解決すべきエッジケース]
コネクタが利用可能な場合
~~デザインツール が接続されている場合:
- Figmaのコンポーネントを直接監査 — 命名、バリアント、トークン使用を確認
- コンポーネントのプロパティとレイヤー構造を文書化のために取得
~~ナレッジベース が接続されている場合:
- 既存のコンポーネント文書と使用ガイドラインを検索
- 更新された文書をWikiに公開
ヒント
- 監査から始める — どこに向かうかを決める前に、現在地を知ること。
- 作りながら文書化する — コンポーネントを設計中に文書化する方が簡単。
- カバレッジを完全性より優先する — 10個のコンポーネントの100%よりも、80%のコンポーネントが文書化されている方が良い。