Design.md 网页设计提取
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_cea1fb81/design-md-extractor。
技能介绍
要解决什么问题
把现有网页整理成可给人和模型用的设计说明时,手抄色板、字号和布局既慢又容易漏。Design.md Extractor 针对用户明确给出的 URL 或本地 HTML 路径,在本地用确定性规则抽取页面样式与结构线索,输出 design.md(面向阅读与后续提示)和可选的 design-snapshot.json(留证与排错),全程不调用大模型 API,也不把页面内容上传到外部服务。
工作方式与核心步骤
技能目录内通过 scripts/extract-design.mjs 驱动抽取;若缺少 node_modules/playwright,需先在本目录执行依赖安装。脚本从 bundled 的 lib/design-extractor-core 加载核心逻辑,用 Playwright 加载页面后按规则采样 DOM/CSS,再生成文档。常见 macOS 浏览器路径会自动探测;若 Playwright 找不到浏览器,可显式传入可执行文件路径。默认流程是:确认输入 → 运行抽取脚本 → 优先同时写出 design.md 与 design-snapshot.json → 在汇报前人工扫一眼 design.md 是否合理。
失败时应区分是导航、浏览器、采样、依赖安装还是生成阶段的问题,并回报具体错误,便于对症处理。需要理解快照结构或改抽取行为时,可参考技能内的 references/snapshot-schema.md 与 references/extraction-rules.md。
适用边界
- 只分析用户提供的 URL 或文件,不会顺链爬取其它页面。
- 不推断登录态、隐藏层等页面上未可见的状态。
- 产出的 design token 是实用起点,不能替代手写的品牌规范全书。
使用场景
- 客户只给了一个落地页 URL,你需要在本地生成 `design.md` 供组件实现对齐,且不能把页面 HTML 交给云端模型分析。
- 设计走读前,你从本地保存的 HTML 快照抽取色板与字号,整理成 `design.md` 给团队对照评审。
- 多步 Agent 流程里,先用确定性脚本把目标页写成设计说明,再让模型只读 `design.md` 而不是顺链爬整站。
- 抽取出的间距或颜色明显偏差时,用 `design-snapshot.json` 对照采样结果,判断是页面未加载完还是规则置信度不足。
适合人员
- 负责按参考站实现 UI 的前端工程师,需要从**单一 URL** 得到可入库的设计说明,避免手抄 CSS。
- 维护设计规范的设计师,想把某一页快速转成 token 草案写入 `design.md`,再人工补全品牌细节。
- 编排本地优先编码技能的开发者,要求设计抽取不调用模型 API、也不上传 DOM 或截图。
- 维护抽取脚本的工程师,需要在失败时区分导航、浏览器、依赖安装与生成阶段并回报具体错误。