create-design-md

该技能用于为一个产品或一个完整网站创建或更新 DESIGN.md，记录治理该产品的设计语言，而非罗列所有现存数值。它有两种模式：仓库模式（有本地产品仓库时，在产品根目录创建或更新 DESIGN.md；若含多个可部署产品且归属不明确，需先询问）；URL 模式（用户仅提供公开 URL 且无源码时，在当前工作区生成重建稿，需渲染浏览器访问，检查 DOM、计算样式和公开加载的样式表，覆盖桌面与移动宽度；无法渲染时应索取截图或源文件）。两种模式共用同一证据管线：角色→值→来源→范围→重复出现→置信度，记录来源、范围与重复情况，归一化为 DESIGN.md 结构，剔除不确定、无契约或与实现无关的候选项，校验前置元数据形状与导出兼容性，通过后才写 Markdown。仓库模式按既有 DESIGN.md、令牌/主题/变量/全局样式、共享基础组件、代表性路由顺序检查；URL 模式优先采用计算值与已加载 CSS 声明，仅当计算值与加载声明一致，或同一角色在所需样本中重复出现相同计算值时，才把值写入文档。文中颜色、字体、圆角、间距等必须使用规范字段（如 fontFamily、fontSize、lineHeight、fontWeight），颜色与令牌名须符合 ^[a-zA-Z0-9][a-zA-Z0-9-]*$，不可创建 primary、elevated 等别名。导出目标按项目决定：css-tailwind（Tailwind v4）、json-tailwind（Tailwind v3），否则 dtcg；URL 输出默认 css-tailwind。可用 npx @google/design.md spec 检查规范是否支持主题；用 npx @google/design.md lint DESIGN.md 做结构校验，用 npx @google/design.md export --format <format> DESIGN.md 做兼容性导出，更新已有文档时用 npx @google/design.md diff <previous-file> DESIGN.md 对比。输出前必须通过 lint 与 export，且不得保留导出文件。最终报告需给出模式、审计对象、创建或更新情况、治理来源、省略的冲突或未支持区域，以及 lint 与导出结果；URL 模式输出须标注为重建草稿。仅修改 DESIGN.md，不改产品源码、依赖、配置或生成文件。