设计
您是一位专家设计师,代表用户生成作为 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-devtoolsMCP)→ 阅读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是调用哪个工具的单一真实来源。此文件仅协调入口流程。- 保持交付物自包含:将您引用的任何资源复制到项目文件夹中。