用途
该技能接受一个公开网页 URL，通过 awwwards MCP 的受保护采集能力获取设计令牌、页面结构、截图与最多三个代表性组件，然后撰写 DESIGN.md 与 design-evidence.json 两份文件。文档是对观测结果的引用子集，不是官方品牌系统，也不代表网站原始设计令牌来源。
主要能力
- 生成 DESIGN.md，包含 Overview、Colors、Typography、Layout、Elevation & Depth、Shapes、Components、Do's and Don'ts、Sources、Coverage and limitations、Unresolved details 各节，使用指定 YAML front matter。
- 生成 design-evidence.json 侧车文件，记录每次采集的 artifact、SHA-256、覆盖度与限制，以及每条设计值的 claim（含 classification 为 observed、inferred 或 proposed）。
- 内置校验脚本，可选使用 Google 的 design.md linter 检查文档结构。
使用方式
输入参数：url 必填，绝对公开 http(s) URL；outDir 可选，默认当前目录；viewport 可选 desktop（默认）或 mobile。每次运行仅一个 URL 和一个视口。
工作流依次为：守卫检查（export_design_tokens，publicOnly:true，selector:"body"，maxNodes:800）；结构分析（analyze_page_structure，publicOnly:true，maxBands:20）；截图（capture_live_site，publicOnly:true，inline:false，须亲自检查保存的图片后再写视觉结论）；组件采集（最多三个代表性根，capture_component，publicOnly:true，maxNodes:150，maxDepth:12，compact:false，不得猜测结构捕获未显示的 selector）；撰写 DESIGN.md 与 design-evidence.json；运行校验；报告已采集、已省略及未决或被阻断的步骤。
若安装的 awwwards-mcp 版本不支持 publicOnly，必须停止，不得用无保护的采集替代。守卫失败、robots 阻断、导航失败或缺失必需证据时不得继续，应报告失败。
校验命令（在已安装技能目录内）： node scripts/validate-design-md.mjs DESIGN.md design-evidence.json 该脚本需 Node 22+、Python 3 与 PyYAML（pip install pyyaml）。 可选 Google 格式校验： npx --yes --package="@google/design.md" designmd lint DESIGN.md
适用场景
需要为任意公开网站生成可追溯、带证据引用的设计系统说明文档时使用，例如设计参考、竞品分析或设计系统整理。也适合需要机器可读证据侧车记录设计值来源与分类的场景。
限制
- 每次仅一个 URL 和一个视口；不爬取多页、不下载资源、不绕过认证。
- 不记录自动动效；不覆盖移动端、深色模式、hover、focus 等全部状态。
- 不得声称官方品牌系统、恢复原始令牌名称、完整响应式覆盖、无障碍合规、资产复用权利或像素级还原。
- 不得编造 CSS 变量、源令牌名称或状态；不得仅凭记忆或截图撰写 DESIGN.md。
- 不得将 create_design_brief 作为替代，也不得声称存在专门的 get_design_md 工具。
- DESIGN.md 不超过 24 KiB UTF-8，侧车不超过 256 KiB；截图不得以 base64 嵌入 Markdown。
- 失败条件包括 INVALID_URL、BLOCKED_DESTINATION、ROBOTS_DISALLOWED 或 ROBOTS_UNAVAILABLE、PAGE_BLOCKED 或 TIMEOUT、缺失令牌/结构且无可用截图、组件采集无法识别真实根。
- 关于价格、收费、平台兼容性等未在资料中明确的信息，暂未提供。