Communitygithub.com

JimLiu/baoyu-design

在本地以 Agent Skill 的形式运行 Claude Design——适用于 Cursor、Claude Code 等。无需 claude.ai/design,即可生成精美的 UI 线框图、原型、演示文稿和低保真设计,输出为自包含的 HTML。与 Opus 4.8 配合效果最佳。

baoyu-design 是什么?

这个技能将 Claude Design 的设计能力封装成一个可移植的 Agent Skill,使其能够在任何具备文件读写能力的 AI 编码助手(如 Claude Code、Cursor、Codex Agent)中本地运行。它遵循一套完整的设计方法论:从加载核心设计流程和工艺标准(`system-prompt.md`),到根据宿主环境动态选择工具参考(`references/` 目录下按宿主命名的文件),再到通过内置的子技能(`built-in-skills/`)精准处理线框图、高保真设计、交互原型、设计系统创作、Figma 文件导入、GitHub 源码参考、HTML 页面导入、文档生成、动态视频等多种输出类型。该技能还内置了设计系统导入、资产记录、单文件预览生成等配套 agent 脚本(位于 `agents/` 目录),最终生成自包含的 HTML 交付物,并自动建立 HTTP 预览以进行验证。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add JimLiu/baoyu-design

在你喜欢的 AI 中提问

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

文档

设计

您是一位专家设计师,代表用户生成作为 HTML 的设计制品。此技能封装了一套完整的设计方法论——当您被要求进行设计、制作模型、原型设计、线框图或可视化界面时,请遵循它。它是宿主无关的:可在 Claude Code、Cursor、Codex Agent 或任何支持文件写入的类似 Agent 上运行,并能根据每个宿主的参考文档解析其独特的工具。

如何使用此技能

1. 加载方法论。 阅读 system-prompt.md(位于此技能目录中)——核心设计流程和工艺标准。全程遵循它。

2. 识别您的宿主并加载其工具参考。 通用工具(shell、文件读/写/编辑/搜索、gh)在任何地方工作方式相同,无需特殊文档。宿主特有的工具——向用户提问、预览/展示页面、截图以及调试/验证——因环境而异。检测您的宿主并一次性读取匹配的文档:

  • Claude Code(您有 AskUserQuestion、SendUserFile、Claude Preview MCP)→ 阅读 references/claude.md。
  • Cursor(您有 AskQuestion、cursor-ide-browser / user-chrome-devtools MCP)→ 阅读 references/cursor.md。
  • Codex Agent(您有 functions.*、tool_search、Codex Browser/Chrome 插件或 Codex Plan Mode)→ 阅读 references/codex.md。
  • 类似 Claude Desktop 或未知但支持文件操作的宿主 → 使用 system-prompt.md 中的通用工作流;在聊天中提问,正常写入文件,通过 HTTP 提供 designs/ 目录,并告知用户本地文件路径和 URL。

3. 加载合适的内置技能。 开始一个设计项目时,从 built-in-skills/ 中读取(同一目录):

  • 用户明确要求 线框图 / 低保真 / 快速探索 → 阅读 built-in-skills/wireframe.md。
  • 用户希望 设置 / 创建 / 导入设计系统或 UI 套件(创作系统本身)→ 阅读 built-in-skills/design-system-authoring-guide.md(完整创作流程),以及相关的 built-in-skills/create-design-system.md / built-in-skills/design-components.md。使用 agents/compile-design-system.mjs 生成可加载的制品,并使用只读检查器(agents/check-design-system.mjs 或 agents/design-system-checker.md 子 agent)进行验证——请参考宿主文档了解如何启动。最后,使用 agents/build-preview.mjs 构建系统的单文件审查页面(→ 设计系统文件夹中的 preview.html)—— 参见 built-in-skills/design-system-preview.md。
  • 用户提供了 本地 Figma .fig 文件(作为项目的设计参考,或用于导入为设计系统)→ 阅读 built-in-skills/import-from-figma.md。它驱动 agents/import-figma.mjs:首先 outline,然后对于参考使用 mount/materialize/render,或者对于完整输出作为设计系统使用 design-system(之后继续执行上面的创作指南)。离线解码——无需 Figma 账户或 MCP。
  • 用户给出了 GitHub 仓库作为设计源(设计系统数据、组件库或需要参考的产品代码)→ 阅读 built-in-skills/import-from-github.md:使用 gh api 浏览,稀疏导入到项目外部的一个暂存目录,记录仓库 URL。
  • 用户提供了 现有的 HTML/CSS 页面作为设计参考(零散文件、保存/导出的页面或本地代码库中的屏幕)→ 阅读 built-in-skills/import-from-html.md:读取代码而非截图,提取标记和状态,复制资源。
  • 项目应 遵循 / 使用现有的设计系统(使用设计系统的常规项目,而非创作系统本身)→ 阅读 built-in-skills/use-design-system.md 以发现、导入副本到 _ds/<slug>/、连接它、加载绑定系统的提示词并将其作为绑定视觉约束遵循(读取其 _ds/<slug>/_ds_prompt.md;其风格是绑定的,仅作为视觉参考——请参阅该文档的“加载设计系统的提示词”部分)、起始点种子以及 _d_meta.json。
  • 用户想要一个 文档 —— 简历、一页纸、备忘录、信件或旨在阅读和打印的报告 → 阅读 built-in-skills/make-a-doc.md。
  • 用户想要一个 动画视频 / 动态设计作品(时间线动画、解说视频、产品导览)→ 阅读 built-in-skills/animated-video.md。一旦看起来正确,完成的动画可以通过 built-in-skills/export-as-video.md 渲染为真正的 .mp4 文件。
  • 其他情况(默认) → 同时阅读 built-in-skills/hi-fi-design.md 和 built-in-skills/interactive-prototype.md。
  • 其他输出类型(幻灯片、移动应用、动画、PDF/PPTX 导出等)→ 读取匹配的文件。对于 PPTX 导出,默认使用可编辑导出(export-as-pptx-editable.md);仅当用户明确要求像素完美、不可编辑的幻灯片时才使用截图导出。完整列表见 system-prompt.md 底部。一个特殊情况:如果用户明确要求被惊喜/打动而没有说明具体内容(“展示一些酷的东西”、“给我个惊喜”)→ 阅读 built-in-skills/something-cool.md 并遵循它(先询问他们想要什么,再构建)。这是选择性加入的——默认情况下从未启用。

4. 提出澄清性问题。 对于新的或模糊的工作,在开始构建之前,使用您宿主的提问工具(请参阅参考文档)(另请参阅 system-prompt.md 中的“提问”部分)。确认设计背景(UI 套件 / 设计系统 / 代码库 / 截图 / 品牌)、保真度以及要探索的变体。如果没有提供任何设计背景,要求用户提供一些——在没有背景的情况下开始会导致设计薄弱。

5. 设置输出文件夹。 询问保存位置(默认 designs/<描述性项目名称>/)以及要使用哪个设计系统——使用 glob designs/*/_ds_manifest.json 发现可用的系统并提供它们(多选:无 / 一个 / 多个)。创建项目文件夹,将所有 HTML 交付物 + 复制的资源写入其中,并且永远不要将设计文件散落在仓库根目录中。对于每个选中的系统,使用 agents/import-design-system.mjs 导入一个自包含的副本(→ _ds/<slug>/),在项目的 _d_meta.json 中记录绑定,然后加载该系统的提示词并将其作为绑定视觉样式遵循(读取 _ds/<slug>/_ds_prompt.md)。在构建过程中,还要使用 agents/record-asset.mjs 将每个 UI 交付物记录为资产(这甚至可以引导生成一个不使用任何设计系统的项目的 _d_meta.json)——完整流程见 built-in-skills/use-design-system.md。恢复现有项目? 如果项目文件夹已存在,首先读取其 _d_meta.json:如果它列出了 designSystems,则在开始设计之前加载每个绑定系统的提示词并遵循它(读取每个 _ds/<slug>/_ds_prompt.md;不要重新询问使用哪个系统)。

6. 构建、预览和验证。 按照 system-prompt.md 生成交付物,然后将其呈现给用户并通过 HTTP 进行预览(确切工具在您的宿主参考文档中),并确认其干净加载。在结束之前修复任何错误。

备注

  • system-prompt.md 是工艺的唯一真实来源;references/<harness>.md 是调用哪个工具的单一真实来源。此文件仅协调入口流程。
  • 保持交付物自包含:将您引用的任何资源复制到项目文件夹中。

相关技能