以 skill 自身的术语
通过串联三个 skill——extract-static-html、extract-design-md 和 upload-to-stitch——将现有前端代码库(React + Vite、Next.js、Angular、Vue)转换为 Stitch Design。它面向需要将运行中的应用或已构建的 Web 目录迁移到 Stitch 中继续迭代的设计师和开发者。
该工作流会提取一个自包含的 HTML 文件,将设计系统写入 .stitch/DESIGN.md,在 Stitch 中创建设计系统,然后以该页面路由路径命名的屏幕上传该 HTML。这是保存、迁移或上传请求所必须走的路径,HTML 验证是可选的,且从不会阻塞运行。
它产出什么
- 一个自包含的 HTML 文件,例如 /path/to/extracted/standalone.html。
- 以 DESIGN.md 形式写成的设计系统描述。
- 上传到 Stitch 的屏幕,其名称和标题标明了它在应用中所对应的路由。
工作方式
- 01提取一个自包含的 HTML 文件
交由 extract-static-html skill 处理,该 skill 基于构建输出或运行中的开发服务器(如 Vite 或 Angular CLI 的 ng serve)工作,并生成一个独立的 HTML 文件。
- 02提供验证方式而不中断流程
提取完成后,你会告知用户文件所在位置,以便他们自行在浏览器中检查,而运行会继续进行到下一步,不受影响。
- 03将源代码分析为设计系统
extract-design-md skill 会读取项目的组件、样式表和主题配置,其结果会写出为一个设计系统文件。
- 04在 Stitch 中创建设计系统
manage-design-system skill 会上传 DESIGN.md,并使用所需的 schema 调用 create_design_system_from_design_md。
- 05将 HTML 作为 Screen 上传
同一个上传脚本会使用 Stitch API key 和 projectId 发送独立的 HTML,并将 title 参数设置为该页面路由,以便在 Stitch 中能够识别该 screen。