design.md
为AI编码代理提供视觉设计规范的格式标准
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：design.md。 它的用途是：为AI编码代理提供视觉设计规范的格式标准 完整的 Skill 内容见：https://321skill.com/skills/design-md/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请根据本项目的DESIGN.md规范，创建一个主要按钮组件。”，它会读取文件中的颜色、圆角、字体等令牌值，并结合“Tertiary颜色用于交互驱动”等设计原理，生成一个使用正确品牌色和样式的按钮代码。或者，在修改UI时
对AI说：“将这个卡片的背景色改为中性色，并参考设计规范调整内边距。”，AI会准确找到{colors.neutral}和{spacing.md}对应的值进行应用。
介绍
DESIGN.md旨在解决AI代理在生成或修改代码时，难以理解和遵循项目视觉设计系统的问题。它是一个格式规范文件，通过结合机器可读的设计令牌（YAML前置元数据）和人类可读的设计原理（Markdown正文），为AI提供持久化、结构化的设计知识。
使用时，开发者需要在项目根目录或相关目录下创建DESIGN.md文件。文件顶部用YAML定义颜色、字体、间距等具体设计令牌值，下方用Markdown章节阐述设计理念、应用场景和指导原则。AI代理在读取此文件后，便能依据其中的精确值和上下文指导，生成符合设计规范的UI代码。
该工具主要面向希望将设计系统与开发流程深度集成的团队，特别是那些频繁使用AI编码助手（如GitHub Copilot、Claude Code）的前端开发者、全栈工程师和设计系统维护者。它有助于确保AI生成的代码在视觉上保持一致性。
与单纯的设计令牌JSON文件或设计稿标注工具不同，DESIGN.md的核心区别在于其“机器可读+人类可读”的双层结构。它不仅是静态的数据字典，更通过Markdown正文传递了设计意图和决策逻辑，使AI能理解“为什么”这么设计，从而做出更合理的应用判断，而非生硬地套用数值。
核心特点
核心区别在于其“设计令牌+设计原理”的双层结构，不仅为AI提供精确的样式数值（YAML），还通过Markdown正文解释设计意图和应用场景，使AI能理解“为什么”而不仅仅是“是什么”，从而生成更符合设计逻辑的代码。
注意事项
该规范主要服务于基于代码生成UI的AI代理，不适用于需要高度创意、非结构化或完全自由发挥的视觉设计场景。
常见问题
DESIGN.md和普通的CSS变量或设计令牌文件有什么区别？
DESIGN.md包含了设计原理和上下文解释，能指导AI如何应用令牌，而不仅仅是定义令牌值本身。
使用DESIGN.md后，AI就能100%生成符合设计的代码吗？
不能保证100%，但它能显著提升AI对设计系统的理解和应用一致性，具体效果还取决于描述的清晰度和AI模型的能力。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/design-md/raw/index.md 读取 design.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/design-md/raw/index.md（查看排版版本）