Communitygithub.com

beavon2010/claude-skills

将前端代码(Vite、React、Angular、Vue 等)转换为 Stitch Design,通过链式调用静态 HTML 提取、设计系统提取和文件上传来实现。**始终**在用户意图将现有 Web 应用或 React/Angular/Vue 组件迁移到 Stitch 时使用此技能(例如,“保存”、“迁移”或“上传”请求)。即使是简单的“保存”操作,也必须使用此技能,因为这是确保提取设计系统和正确链接资产的唯一方法。

claude-skills 是什么?

该技能将一个复杂的、多步骤的工作流封装成一个单一的自动化流程,用于将现有前端应用(支持 React + Vite、Next.js、Angular、Vue 等主流框架)转化为 Stitch Design。它按顺序协调调用三个子技能:首先通过 `extract-static-html` 从构建输出或运行中的开发服务器提取一个自包含的 HTML 文件;然后由 `extract-design-md` 分析源代码(包括 Angular 的 `angular.json`、外部 HTML 模板、主题文件和组件)以生成设计系统文档 `DESIGN.md`;最后通过 `upload-to-stitch` 将 HTML 文件和相关设计系统上传到指定的 Stitch 项目。这一设计确保了转换过程的完整性和资产链接的正确性,用户无需手动干预中间步骤。该技能在 Claude Code、Cursor 等支持技能调用的 AI 代理平台上运行,用户只需提供项目路径、Stitch 项目 ID 和 API 密钥即可。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beavon2010/claude-skills/tree/HEAD/.claude/skills/code-to-design

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代码到设计

将您现有的前端代码(React + Vite、Next.js、Angular、Vue 等)转换为 Stitch Design,以便您可以使用 Stitch 进行迭代和改进。

此技能按顺序协调调用三个其他技能:

  1. extract-static-html:从构建输出或运行中的开发服务器(例如 Vite 开发服务器或 Angular CLI ng serve)中提取一个自包含的 HTML 文件。
  2. extract-design-md:分析源代码(包括 Angular angular.json、外部 .html 模板、主题文件和组件)以创建设计系统(DESIGN.md)。
  3. 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 中的屏幕名称/标题明确标识其在应用中的路由。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能