google-labs-code/design.md

解決的問題

編碼代理在生成 UI 時往往難以保持一致的視覺身份。DESIGN.md 為描述設計系統提供了一種標準化的持久格式，使 AI 代理既能理解精確的數值（Token），也能理解視覺品牌背後的邏輯（文本）。

工作原理

該系統使用雙層檔案格式：

1. YAML Front Matter：包含顏色、排版、間距和組件特定屬性（例如按鈕顏色）的機器可讀設計 Token。
2. Markdown Body：包含組織在特定章節（例如概述、顏色、排版）中的人類可讀設計原理與指南。

它包含一個 CLI 工具，用於檢查這些檔案的結構正確性、檢查 WCAG 對比度、檢測損壞的 Token 引用，並將 Token 導出為 Tailwind CSS (v3 與 v4) 或 W3C Design Tokens Format 等格式。

適用對象

希望確保生成的 UI 與特定品牌身份和設計系統保持一致的、正在使用 AI 編碼代理的開發人員與設計師。

亮點

• 混合格式：將結構化的 YAML Token 與描述性的 Markdown 文本相結合。
• 無障礙檢查：內建針對 WCAG AA 對比度的 Lint 檢查。
• WriteLine 導出：支援導出至 Tailwind CSS 與 W3C DTCG 格式。
• 面向代理設計：包含一個 spec 命令，用於輸出格式規範以便注入到代理提示詞中。