スキル: トークンビルド
DTCGトークンの真実源をプラットフォーム対応の出力に変換します。トークンは一度作成すれば、すべてのプラットフォーム出力が自動生成されます。
手順
workflows/token-build.mdを読む(アーキテクチャ、ツールオプション、解決ルール、出力ターゲット、CI)。- ツールを選択する: Style Dictionary(マルチプラットフォーム、デフォルト)、Tokens Studio(Figma所有トークン —
figma-integrationと組み合わせて使用)、W3C DTCGエクスポート、または小規模なカスタムスクリプト(scripts/validate_tokens.pyをモデルに)。 - 解決ルールに従う: エイリアスをプラットフォームごとの最終値に解決する。セマンティックトークンとコンポーネントトークンを公開する(プリミティブは内部に留める)。ベース+ダーク/ブランド/デンシティのオーバーライド(
tokens/theming.json)は差分のみとして出力する。$typeに基づいてフォーマットする。 - 要求されたターゲットを生成する: CSS
:root変数、Tailwind v4@theme、型付き JS/TS、iOS アセットカタログ +Color.DS/Spacing、Androidcolors.xml/Compose テーマ。 - CI を構築する:
tokens/*.jsonの変更をトリガーに、scripts/validate_tokens.pyを実行し、再生成する。コミットされたアーティファクトが古い場合は失敗させる。scripts/contrast.pyで色をゲートする。
検証(完了条件)
python3 scripts/validate_tokens.pyがパスすること(未解決のエイリアスがないこと)。- 再生成してもコミットされたアーティファクトとの差分が生じないこと。
- ダーク/ブランド/デンシティの出力には差分のみが含まれ、全体の複製ではないこと。