如何使用 DESIGN.md

这份文件是给人类看的说明，也是给 Agent 的合同。YAML 里的 tokens 是准绳，正文告诉模型为什么这样取舍。

放到哪里

• Cursor — 仓库根目录 `DESIGN.md`，并在 `.cursorrules` 或 `.cursor/rules/design.mdc` 引用。
• Claude Code — 根目录 `DESIGN.md` + `.claude/skills/design/SKILL.md`，在 CLAUDE.md 里点名。
• Codex — 在 `AGENTS.md` 写：所有 UI 必须遵守 DESIGN.md。
• Stitch — 直接导入 DESIGN.md（YAML front matter + 8 节官方顺序）。

校验

本站导出前会检查对比度、token 引用和章节顺序，规则对齐 Google `@google/design.md`。

SwiftUI / Tailwind

编辑器里可一并下载 tokens.json（DTCG）、Tailwind v3/v4、SwiftUI Color/Font 扩展，或打成 ZIP。