用途：为一个产品或连贯的网站创建或更新 DESIGN.md，记录规范设计语言，而非罗列所有现有值。仅修改 DESIGN.md，不改动产品源码、依赖、配置或生成文件，也不自创格式。
主要能力：提供两种模式。仓库模式在可用本地仓库时使用，在所选产品根目录创建或更新 DESIGN.md，可确立规范值、token 名称、组件归属与已有依据。URL 模式在仅提供公开 URL 时使用，需渲染浏览器访问，检查 DOM、计算样式与已加载样式表，覆盖桌面与移动宽度，生成重构的 DESIGN.md 草稿。两种模式共用同一记录与输出流程：角色→值→来源→范围→复现→置信度。
使用方式：仓库模式按既定顺序检查现有 DESIGN.md、token 与全局样式、共享基础组件、代表性路由与消费者、表面局部实现。URL 模式采样颜色、排版、间距布局、边框圆角阴影、导航按钮输入卡片等重复结构，优先使用计算值与已加载 CSS，并要求观察、依据、后果三项证明。仅当有治理来源定义命名系统时才添加 colors、typography、rounded、spacing、components 等 frontmatter。
验证：运行 npx @google/design.md lint DESIGN.md 进行结构校验，再用 npx @google/design.md export --format <format> DESIGN.md 做一次兼容导出，确认已填充类别均有对应 token 类别输出。更新已有文档时可用 npx @google/design.md diff <previous-file> DESIGN.md 对比。
限制：URL 模式仅能确立可观察视觉模式与计算值，不能确立内部 token 名称、组件归属、未记录依据或是否刻意规范。无渲染检查能力时应索取截图或源文件，不得仅凭文案、元数据或 HTML 结构创建。校验未通过前不得返回或展示草稿。不编造品牌个性、受众或情感依据。