extract-figma-speclisted
Install: claude install-skill YasuakiOmokawa/skills
# Extract Figma Spec
## 目的
Figma デザインをコードへ反映するとき、対象ノードごとに**全プロパティを構造化データから抽出してチェックリスト化**し、実装と 1 行ずつ照合することで反映漏れを防ぐ。スクショ目視と「人間が挙げた変更点」だけに頼ると、正確な hex の微差・font weight・アイコンや枠の有無・要素まるごとの欠落 を取りこぼす。これを抽出フェーズで構造的に潰す。
## 使うべきとき
- Figma デザインをコードへ反映 / 適用する実装の前、または実装中の差分確認
- 「Figma 通りに」「デザインを反映」「Figma の指定どおりに直して」と頼まれたとき
- figma-dev-mode MCP を使った design-to-code 作業全般
- `/finalize-plan` の正本カバレッジ・ゲート(Step 3.5)が読む `## 正本抽出結果` を作る upstream としても使う
使わないとき:
- Figma を参照しない実装 / バックエンドのみの変更
- 既に AC に全プロパティが落ちていて /qa-ui で検証するだけの段階(このスキルはその AC を作る上流)
- Figma 上のレビュー注釈・変更点コメントの内容確認(figma-dev-mode MCP にコメント取得手段が無い)
## Arguments
- `$ARGUMENTS`: 対象 Figma ノード / URL(省略可)。省略時は Step 1 でノードを特定する。
- 出力先プランファイルパス(省略可)。指定時は Step 5 の書き出し先とする。省略時の扱いは「委譲実行」節を参照。
## 委譲実行 (subagent として起動された場合)
Task で委譲実行される場合、以下を本文の既定手順に優先して適用する。単独起動(ユーザーがメイン会話で直接起動)の動作は変えない。
- **入力解決の順位**: 対象ノード・出力先プランファイルパスとも、① 起動プロンプト本文の明示指定(= `$ARGUMENTS` 相当)を一次経路とする。② 「プラン / セッションに既出」は単独起動時のみ有効で、委譲実行では起動プロンプトに転記されていない限り参照できない。作業ディレクトリ内で見つかったファイル(run dir 配下の既存ファイル等)も、起動プロンプトに明記されていない限り同様に採用しない。③ 対象ノードが①②で決まらない場合は Step 1-2 のドリルダウンに進む。出力先プランファイルパスが①②で決まらない場合は、Step 5 でファイルへ書き込まず `## 正本抽出結果` の全行を最終メッセージにそのまま返す(縮退動作)。
- **ドリルダウンの選定基準**: Step 1-2 のドリルダウンで、`get_metadata`(nodeId なし)が返すページ一覧を起動プロンプトの URL・背景説明のキーワードと照合する。一���するページが 1 件のみなら採用して先に進む。0 件、または複数件で一意に決まらない場合は、AskUserQuestion が利用可能ツール一覧に無いため質問せず、候補一覧(または該当なしの事実)を最終メッセージに含めて Step 1 で停止する。
- **完了報告**: Step 5 完了時・Step 1 で停止した場���のいずれも、最終メッセージに次を含める。(a) 書き出し先ファイルの絶対パス(書き込みを行った場合。未書き込みなら「未書き込み」