用途:从指定网页 URL 生成可复现、经验证的 DESIGN.md 设计说明文档,用于把页面视觉身份沉淀为设计令牌与规范,便于其他智能体复刻页面。
主要能力:用 Playwright 采集 HTML、CSS、资源、图标、动效与截图证据;按视口从上到下慢速滚动截图且要求相邻截图不重叠;生成 analysis.json、styles-summary.json、visual-verification.config.json 等文件;支持把截图分派给多个子智能体并行做图像分析;合并证据后按规范章节撰写 DESIGN.md;提供确定性完整性校验与规范校验;在存在复刻页面时执行像素差异门禁;支持导出 Tailwind 或 DTCG 令牌。
使用方式:先创建产物目录,例如 .omx/artifacts/make-design-md/<slug>/。采集命令:npx --yes -p playwright node .codex/skills/make-design-md/scripts/capture_webpage_design.mjs "https://example.com" .omx/artifacts/make-design-md/example。可加参数如 --viewport-width 1440、--viewport-height 900、--viewports desktop:1440x900,mobile:390x844、--max-shots 12、--wait 1500、--states default,hover,focus。若缺少浏览器,先运行 npx --yes playwright install chromium。图像分析前运行 codex login status。完整性校验:node .codex/skills/make-design-md/scripts/validate_deterministic_design_md.mjs DESIGN.md。规范校验:node .codex/skills/design-md-validator/scripts/validate_design_md.mjs DESIGN.md。像素比对:npx --yes -p pixelmatch -p pngjs node .codex/skills/make-design-md/scripts/compare_design_screenshots.mjs .omx/artifacts/make-design-md/example/visual-verification.config.json。导出命令:npx --yes @google/design.md export --format tailwind DESIGN.md > design.tailwind.json,或 npx --yes @google/design.md export --format dtcg DESIGN.md > design.tokens.json。
适用场景:需要把线上网页的设计系统整理成 DESIGN.md,用于跨智能体复刻、前端实现交接,或导出 Tailwind/DTCG 令牌进入开发或设计工具流程。
限制:需本地具备 Playwright 与 Node 环境;浏览器缺失时需安装 Chromium。图像分析依赖 Codex 登录,未登录时只能用本地图像检查并记录该限制。像素差异门禁未通过会阻断流程,除非人工记录例外。文档要求写令牌、组件、状态、响应式、资源、动效等复刻指引,但不得编造页面中不可见的品牌值。人类视觉批准需记录为 human-approval.json。最终导出需用户选择 Tailwind 或 DTCG。其余价格、平台覆盖等信息暂未提供。