代码到设计
将您现有的前端代码(React + Vite、Next.js、Angular、Vue 等)转换为 Stitch Design,以便您可以使用 Stitch 进行迭代和改进。
此技能按顺序协调调用三个其他技能:
extract-static-html:从构建输出或运行中的开发服务器(例如 Vite 开发服务器或 Angular CLIng serve)中提取一个自包含的 HTML 文件。extract-design-md:分析源代码(包括 Angularangular.json、外部.html模板、主题文件和组件)以创建设计系统(DESIGN.md)。upload-to-stitch:将该 HTML 文件和设计系统上传到您的 Stitch 项目。
工作流
请按照以下步骤转换您的现有代码。
前提条件
- 一个运行中的本地开发服务器(例如
npm run dev、ng serve)或一个包含index.html和资源的已构建 Web 应用目录。 - 目标 Stitch
projectId(如果未知,请使用list_projects)。
步骤
1. 提取自包含 HTML
委托 extract-static-html 技能生成一个独立的 HTML 文件。
阅读 skills/extract-static-html/SKILL.md 获取详细说明和脚本用法。
预期输出:一个文件,例如 /path/to/extracted/standalone.html。
2. 验证 HTML(可选——由用户驱动)
提取后,告知用户输出文件路径,以便他们可以在浏览器中手动验证(如果需要)。不要因验证而阻塞——直接进入步骤 3。
如果用户在审查后报告问题,请先修复问题再继续。
3. 提取设计系统(文件)
委托 extract-design-md 技能分析项目的源文件(组件、样式表、主题配置)并生设计系统。阅读 skills/extract-design-md/SKILL.md 了解完整的分析工作流。
按照 extract-design-md 技能的输出结构编写 .stitch/DESIGN.md。
4. 上传 DESIGN.md 并在 Stitch 中创建设计系统
委托 manage-design-system 技能上传 DESIGN.md 并在 Stitch 中创建设计系统。阅读 skills/manage-design-system/SKILL.md 了解完整工作流(上传脚本用法、create_design_system_from_design_md 调用和所需模式)在上传时传递 --generated-by 'stitch::code-to-design'。
5. 将 HTML 上传到 Stitch
使用相同的 upload-to-stitch 技能脚本上传提取的 HTML 文件。阅读 skills/upload-to-stitch/SKILL.md 获取详细说明和脚本用法。
您需要:
- 步骤 1 中生成的独立 HTML 文件的路径。
- 您的 Stitch API 密钥(与步骤 4 中使用的相同)。
- 目标
projectId。 --generated-by参数设置为'stitch::extract-static-html'。--title参数设置为页面的路由路径(例如'/dashboard'、'/settings/profile'、'/inbox'),以便 Stitch 中的屏幕名称/标题明确标识其在应用中的路由。