エージェントへの受け渡しはスクショではなく「読めるキット」(md・JSON・部品・検証)にする
「いい感じにして」と頼むと毎回違う汎用UIになる。モデルではなく、エージェントが読めるテーマ/キットが足りない。
どんな問題を解決するか / いつ使うか
Claude Code / Cursor / Codex にUIを作らせるとき。スクショや「おしゃれに」だけではトンマナが安定しないとき。ブラウザでテーマを決めたあと、実装エージェントに渡すとき。
やり方
- 見た目の参照を画像だけにしない。エージェントがパースできるファイル一式にする。
- キットに最低限入れるもの(投稿で挙げられていた例):
DESIGN-SYSTEM.md(人間とエージェント向けの説明)design-system.json(機械可読のトークン)- コンポーネントのソース
- DTCG形式のトークン
- 検証スクリプト(トークン逸脱などを機械チェック)
- エージェント用スキル例:
apply-theme/build-screen/audit-consistency
- ZIPやリポジトリにまとめて渡し、「このキットに従って画面を組め」と指示する。スクショは補助に留める。
- 自分の手で用意する場合も同じ構成でよい。既存の DESIGN.md(トークン+ルール)を置き、AGENTS.md / CLAUDE.md から必ず読ませる と トークン名ではなく「正しい使い方のコード例(ゴールデンセット)」をエージェントに渡す。レジストリ/MCPで配る をキットに含める。
注意点・対応状況
- キットがReact+特定UIキット前提だと、別スタックでは部品ソースはそのまま使えない。トークンとmdのルールは流用しやすい。
- 「キットを渡したのに3プロンプト後に汎用角丸に戻る」ことがある。
audit-consistencyや検証スクリプトをループに入れる(エージェントにUI変更のたびにスクショで自己チェックさせる(デザイン→実装→スクショ→レビュー→修正のループ) と併用)。
出典
- 投稿者: @listudio (leolee)
- 投稿: @listudio · 2026-10-09(スレッド起点: @listudio · 2026-10-09)
- 収集日: 2026-10-10(JST)