/design-handoff
見慣れないプレースホルダーがある場合や、どのツールが接続されているかを確認する必要がある場合は、CONNECTORS.md を参照してください。
デザインから包括的な開発者向けハンドオフドキュメントを生成します。
使用方法
/design-handoff $ARGUMENTS
以下のハンドオフ仕様書を生成: @$1
Figma URL が提供された場合は、Figma からデザインを取得します。それ以外の場合は、提供された説明またはスクリーンショットから作業します。
含める内容
ビジュアル仕様
- 正確な測定値(パディング、マージン、幅)
- デザイントークン参照(色、タイポグラフィ、スペーシング)
- レスポンシブブレークポイントと動作
- コンポーネントのバリアントと状態
インタラクション仕様
- クリック/タップ動作
- ホバー状態
- トランジションとアニメーション(持続時間、イージング)
- ジェスチャーサポート(スワイプ、ピンチ、長押し)
コンテンツ仕様
- 文字数制限
- 切り詰め動作
- 空の状態
- ローディング状態
- エラー状態
エッジケース
- 最小/最大コンテンツ
- 国際テキスト(長い文字列)
- 低速接続
- データ欠落
アクセシビリティ
- フォーカス順序
- ARIA ラベルとロール
- キーボード操作
- スクリーンリーダーへの通知
原則
- 想定しない — 指定されていない場合、開発者は推測します。すべてを指定してください。
- トークンを使用し、値は使用しない —
16pxではなくspacing-mdを参照してください。 - すべての状態を示す — デフォルト、ホバー、アクティブ、無効、ローディング、エラー、空。
- なぜかを説明する — 「これはモバイルで折りたたまれます。ユーザーは主に片手で操作するためです」と説明することで、開発者は適切な判断を下せます。
出力
## ハンドオフ仕様書: [機能/画面名]
### 概要
[この画面/機能の機能、ユーザーコンテキスト]
### レイアウト
[グリッドシステム、ブレークポイント、レスポンシブ動作]
### 使用されているデザイントークン
| トークン | 値 | 用途 |
|-------|-------|-------|
| `color-primary` | #[hex] | CTAボタン、リンク |
| `spacing-md` | [X]px | セクション間 |
| `font-heading-lg` | [サイズ/ウェイト/ファミリー] | ページタイトル |
### コンポーネント
| コンポーネント | バリアント | プロパティ | 備考 |
|-----------|---------|-------|-------|
| [コンポーネント] | [バリアント] | [プロパティ] | [特別な動作] |
### 状態とインタラクション
| 要素 | 状態 | 動作 |
|---------|-------|----------|
| [CTAボタン] | ホバー | [背景を10%暗くする] |
| [CTAボタン] | ローディング | [スピナー、無効] |
| [フォーム] | エラー | [赤い枠線、エラーメッセージを下に表示] |
### レスポンシブ動作
| ブレークポイント | 変更点 |
|------------|---------|
| デスクトップ (>1024px) | [デフォルトレイアウト] |
| タブレット (768-1024px) | [変更点] |
| モバイル (<768px) | [変更点] |
### エッジケース
- **空の状態**: [データがない場合に表示するもの]
- **長いテキスト**: [切り詰めルール]
- **ローディング**: [スケルトンまたはスピナー]
- **エラー**: [エラー状態の外観]
### アニメーション / モーション
| 要素 | トリガー | アニメーション | 持続時間 | イージング |
|---------|---------|-----------|----------|--------|
| [要素] | [トリガー] | [説明] | [ms] | [イージング] |
### アクセシビリティに関する注意点
- [フォーカス順序]
- [必要なARIAラベル]
- [キーボード操作]
コネクターが利用可能な場合
~~デザインツール が接続されている場合:
- Figma から正確な測定値、トークン、コンポーネント仕様を取得
- アセットをエクスポートし、完全な仕様シートを生成
~~プロジェクトトラッカー が接続されている場合:
- ハンドオフを実装チケットにリンク
- 仕様の各セクションにサブタスクを作成
ヒント
- Figmaリンクを共有する — 正確な測定値、トークン、コンポーネント情報を取得できます。
- エッジケースに言及する — 「100個のアイテムがある場合はどうなるのか?」と質問することで、境界条件を仕様化できます。
- テクノロジースタックを指定する — 「React + Tailwind を使用しています」と指定することで、関連性の高い実装ノートを提供できます。