用途:在当前项目根目录生成一份完整的 DESIGN.md 设计系统规范。文件采用 @google/design.md 格式,由两部分组成——YAML frontmatter 存放机器可读的 token 系统(颜色、排版、圆角、间距、组件),正文说明系统如何运作。该文件作为唯一事实来源,供人与智能体在改动 UI 前查阅,因此每个值都必须有依据,宁可诚实标注缺口,也不填模糊内容。
主要能力:可从多种输入来源综合生成规范,包括截图/图片、实际 URL、代码库、文字描述和品牌参考(内置 stripe、linear.app、vercel、notion 四种现成分析)。多种来源可组合;冲突时按可信度排序:真实代码值 > 截图测量 > 描述推断 > 品牌参考默认值。
必要用法:写作前先读 references/format.md 获取 frontmatter 结构、token 引用语法和正文章节模板。流程分为:盘点输入、采集证据、构建 token 系统、撰写正文、写入 <git root>/DESIGN.md、验证、汇报。验证命令为 npx -y @google/design.md lint DESIGN.md,须清零错误;未使用 token 警告需处理或删除(border/hairline 色除外)。导出命令 npx -y @google/design.md export DESIGN.md --format css-tailwind 可作为可机器消费的冒烟测试,建议告知用户但不要擅自运行。若 DESIGN.md 已存在,先阅读并保留其意图,不应静默覆盖。
限制:从截图取色为估算,需归一化近似重复值;仅凭描述生成时须把全部假设记入 Known Gaps,不得使用 TBD 等占位符;对比度警告在忠实记录现有 UI 时保留原值并注明。具体平台、价格、支持范围等资料暂未提供。