用途
本技能面向“从公开网站提取设计语言”的场景:用户输入 /extract <公开 HTTPS URL>,或要求从某个公开 HTTPS 网站 URL 提取 DESIGN.md 时触发。目标是从页面可观察到的设计证据中整理出一份 grounded DESIGN.md,而不是整站克隆为可运行代码,也不声称提取的是目标站点的官方品牌规范。
主要能力
- 斜杠命令触发:/extract <url> 立即运行工作流;只输入 /extract 时先询问公开 HTTPS URL,拿到 URL 前不开始提取。
- 证据收集:读取 HTML 标题与元数据、外链与内联 CSS、代表性元素的计算样式;浏览器工具可用时截取 1440x900 桌面截图与 390x844 移动截图。
- 先证据后写作:先写入 blueprint.json 与 sources.json,再撰写最终 DESIGN.md。
- 固定文档结构:DESIGN.md 严格包含 9 个二级标题,顺序为:Visual Theme & Atmosphere、Color Palette & Roles、Typography Rules、Component Stylings、Layout Principles、Depth & Elevation、Do's and Don'ts、Responsive Behavior、Agent Prompt Guide。除这 9 节外不添加 Sources、Confidence 或 Appendix 章节。
- 自检与校验:写作前后分别依据模板、证据、QUALITY_CHECKLIST 等参考文件进行自检,保证具体 token 可追溯到 blueprint.json,不确定的发现被标注为定性观察。
- 输出报告:结束时报告输出路径与置信度警告。
使用方式
- 创建证据目录:在用户项目内创建 .blueprint-extractor/<slug>/。
- 校验目标 URL:不符合安全与范围要求时简短拒绝。
- 收集证据:若 scripts/extract-blueprint.mjs 存在且依赖可用则优先运行,并以它的产物为准;否则用可用的浏览器、HTTP 与文件系统工具手动收集等效证据。
- 提取具体 token:颜色来自 CSS、计算样式、SVG 属性或采样截图;字体来自 CSS、计算样式或 @font-face;断点来自媒体查询或明确标注为从截图推断;间距、圆角、阴影、边框、动效引用 CSS 或计算样式。只有截图时保持定性观察,不编造数值 token。
- 撰写 DESIGN.md:默认英文;用户指定语言时使用用户语言。每个具体 token 需能追溯到 blueprint.json。
- 自审与最终校验:确认文件位于预期路径、二级标题名称与顺序符合模板、各数值有证据或标注为推断、满足质量清单。校验失败时修正证据或降级不受支持的值。
适用场景
适用于从公开可访问的 HTTPS 网站提取可迁移的设计语言:视觉主题与氛围、配色与角色、字体规则、组件样式、布局原则、层次与阴影、做与不做、响应式行为,以及给智能体的提示指南。最终文档强调把证据转化为可复用的设计指导,而不是枯燥的 token 罗列;保留目标项目自身的领域模型、信息架构与核心工作流,只迁移视觉语言。源站点的具体领域对象(如“播放列表”“专辑封面”“购物车”“文档页”“仪表盘”“结账流程”)会被抽象为领域中立的模式(如“集合/导航侧栏”“重复内容项”“视觉缩略图或强调块”)后再复用。
限制
- URL 安全:仅接受 https://;拒绝 localhost、回环地址、私有 IP、链路本地或私有主机名;拒绝登录门禁或付费墙内容、非 HTML 响应、不可达或空页面、重定向过多的地址;拒绝绕过登录、抓取私有仪表盘、提取 Figma 或克隆可运行代码的请求;不跟随表单、登录流程、结账流程、破坏性操作或用户专属页面。
- 证据边界:不得从截图中臆造数值 token;断点若非来自媒体查询须明确标注为推断;不支持示例不得进入 DESIGN.md,除非标注为定性或推断。
- 品牌保守:不导入知名产品的模式、品牌传说或官方系统声明,除非捕获页面、CSS 或计算样本支持。
- 输出约束:DESIGN.md 不添加 Sources、Confidence、Appendix 章节;置信度警告放在最终助手回复或证据包中。
暂未提供
资料未说明该技能的具体安装命令、依赖安装方式、scripts/extract-blueprint.mjs 的运行时要求、收费或价格信息,以及所支持浏览器工具的具体清单。