以 skill 自身的术语
把现有产品转化为一份书面设计合约。在仓库模式下,它会审计本地产品的 token、主题、共享基础组件与渲染路由,并在该产品根目录写入 DESIGN.md;在 URL 模式下,它会在桌面和移动宽度下,根据 DOM、计算样式和已加载样式表重建一份草案。
两种模式共用同一套证据流水线——角色、值、来源、范围、复现次数、置信度——以及同一套扁平 token 模式,导出目标可选 css-tailwind、json-tailwind 或 dtcg。只有在治理来源明确指定,或通过三重验证的值才会被保留,且文档只有在 lint 与导出均通过后才会发布。它只改动 DESIGN.md,不改动其他任何内容。
它产出什么
- URL 模式下写入当前工作区的重建版 DESIGN.md 草案,并标注为草案。
- 一份报告,列出所使用的模式、被审计的产品或 URL、所用的治理来源,以及文档中排除的冲突或无支持依据的部分。
- 最终的 lint 与导出结果,二者必须都通过才能交回文档。
工作方式
- 01选择模式
当本地产品仓库可用时使用仓库模式,在该产品根目录写入 DESIGN.md;当只给出一个公开 URL 时使用 URL 模式,在当前工作区生成一份重建草案。
- 02收集证据并记录来源
在任何归一化之前,每个候选项都会先记录其来源、范围和复现次数,因此两种模式都进入同一套记录流水线。
- 03归一化为 DESIGN.md 模式(schema)
不确定的、本地但无合约依据的,或与实现无关的候选项会被剔除;其余则映射到规范化的扁平 token 模式中。
- 04在验证通过前拦截草案
只有在解析出的 frontmatter 通过结构检查之后,才会写入 Markdown,因此正文绝不会先写好再反向拼凑到 YAML 上。
- 05Lint 与导出
先运行结构化 lint,然后按所选目标执行一次兼容性导出,且每个已填充的分类都必须出现在输出中。
- 06报告模式、来源与缺口
报告会说明所用的模式和被审计的产品或 URL、所用的治理来源、任何因缺乏支持而省略的内容,以及 lint 与导出的结果。