用途：为单个产品或同一网站创建或更新 DESIGN.md，记录约束界面的设计语言，而非罗列所有存在的值；仅允许修改 DESIGN.md，不得改动产品源码、依赖、配置或生成文件，也不得自创格式契约。
两种模式：仓库模式下在所选产品根目录创建或更新 DESIGN.md，若仓库含多个可部署产品需由用户指明；URL 模式在用户只给公开网址时，在当前工作区生成重建草稿，要求可渲染浏览器访问，检查 DOM、计算样式与公开加载的样式表，覆盖桌面与移动宽度，仅截图不能确定精确值；若无法渲染检查，应索取截图或源文件，不得仅凭文案、元数据或 HTML 结构创建。有源码时应优先仓库模式。
证据流程：role → value → source → scope → recurrence → confidence；两模式共用同一记录与输出管线。URL 值需满足三证：可观察、有测量或跨采样页/视口复现、且会改变具体实现选择，否则省略。
内容规则：YAML 只写具名共享 token 与角色，使用映射而非序列，不使用组件工具类或重复字面量构造尺度；圆角仅源码定义 --radius 时写 rounded.base；排版仅用 fontFamily、fontSize、lineHeight、fontWeight、letterSpacing 等规范字段；不虚构品牌个性、受众或情绪理由。先检查规范：npx @google/design.md spec。
写作与校验：从最小 frontmatter 开始（仅 name 必填），正文以 ## Overview 开头，只在有依据时按序加入 Colors、Themes、Typography、Layout、Elevation & Depth、Shapes、Components、Do's and Don'ts。校验运行 npx @google/design.md lint DESIGN.md，再按所选导出目标运行 npx @google/design.md export --format <format> DESIGN.md；导出目标：Tailwind v4 用 css-tailwind，v3 用 json-tailwind，其他用 dtcg。每个已填充分类须在导出中对应输出，否则视为失败并重写；更新既有文档可用 npx @google/design.md diff <previous-file> DESIGN.md 保留已接受决策。校验未通过前不得返回或展示草稿，URL 模式须标注为重建草稿。报告需含模式与审计对象、创建或更新结果、所用依据源、省略或冲突项、最终 lint 与导出结果。缺失事实暂未提供。