テック技報最新号へ →
デザイン

エージェントへの受け渡しはスクショではなく「読めるキット」(md・JSON・部品・検証)にする

「いい感じにして」と頼むと毎回違う汎用UIになる。モデルではなく、エージェントが読めるテーマ/キットが足りない。

@listudio · 2026-10-10
#AIデザイン#コーディングエージェント#DESIGN.md#デザインシステム#Cursor#ClaudeCode#Codex

どんな問題を解決するか / いつ使うか

Claude Code / Cursor / Codex にUIを作らせるとき。スクショや「おしゃれに」だけではトンマナが安定しないとき。ブラウザでテーマを決めたあと、実装エージェントに渡すとき。

やり方

  1. 見た目の参照を画像だけにしない。エージェントがパースできるファイル一式にする。
  2. キットに最低限入れるもの(投稿で挙げられていた例):
    • DESIGN-SYSTEM.md(人間とエージェント向けの説明)
    • design-system.json(機械可読のトークン)
    • コンポーネントのソース
    • DTCG形式のトークン
    • 検証スクリプト(トークン逸脱などを機械チェック)
    • エージェント用スキル例:apply-theme / build-screen / audit-consistency
  3. ZIPやリポジトリにまとめて渡し、「このキットに従って画面を組め」と指示する。スクショは補助に留める。
  4. 自分の手で用意する場合も同じ構成でよい。既存の DESIGN.md(トークン+ルール)を置き、AGENTS.md / CLAUDE.md から必ず読ませる と トークン名ではなく「正しい使い方のコード例(ゴールデンセット)」をエージェントに渡す。レジストリ/MCPで配る をキットに含める。

注意点・対応状況

出典

X の元の投稿を開く