/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を使用しています」と指定すると、関連する実装ノートを提供できます。