跳转到使用指南
prototype作者 Emil Kowalski

Prototype Skill.

Claude Code 和 Codex skill,用于 UI 设计:为一个 UI 组件构建多个真正不同的版本,并提供实时可视化选择器。

  • Web & UI
  • UI 代码
emilkowalski/skills · skills/prototype/SKILL.mdSKILL.md
--- name: prototype description: Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own. --- ## Operating Posture ## Hard Rules ## Workflow ## Invocation Variants ## Tone
从上游文件读取的前言和章节标题(2026-09-14)· 完整内容 7,432 字符

01 功能说明

原型 skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

这是一个用于逐个探索单个 UI 元素的发散型 skill —— 一个 toast、定价卡片、一个长按删除按钮。它接收对该元素的描述,围绕一个指定的轴(布局、密度、个性、动效、交互模型)构建若干真正不同的版本,并将它们放到一个可视化选择器背后,让用户实时切换查看并选出最终版本。

它只在被明确调用时运行,默认生成三个变体,将探索性内容排除在生产代码之外,并在某个变体被集成后删除原型界面。

它产出什么

  • 一个承载各变体的实时可视化选择器,供切换查看并选出最终版本。
  • 一张对比表,列出每个变体的轴、适用场景以及代价。
  • 所选变体的生产代码,已集成到代码库中,原型界面已删除。
  • 当有浏览器工具可用时,为每个变体截图。
查看示例提示词 ↗

工作方式

  1. 01
    限定在单一元素范围内

    如果 brief 涉及多个组件,该 skill 会挑选出杠杆效应最高的单一元素,说明选择理由,并将其余部分作为后续运行提供。

  2. 02
    侦察现场

    梳理框架、样式体系、动效库、token、产品个性以及该元素所渲染的上下文,使各变体看起来在产品中是原生的。

  3. 03
    先命名各个方向

    默认生成三个变体,在被要求或空间确实广阔时可扩展到五个;每个变体在编写任何代码之前都会先获得名称和轴。

  4. 04
    搭建选择器脚手架

    在项目中,一个独立的路由承载每个变体各一个文件,外加一个小型脚手架文件;选择器本身是从 PICKER.md 复制而来,而非重新设计。

  5. 05
    展示前先验证

    运行该脚手架,逐一切换每个变体以检查渲染和交互的正确性,如有浏览器工具则附上截图。

  6. 06
    推举最终版本

    用户选定后,该变体会按照项目的文件结构、命名规范和 token 使用方式被集成,原型界面随之移除。

02 找到适合场景

何时使用 prototype Skill

当工作属于此类 UI 设计时,在 Claude Code 或 Codex 中使用 prototype skill。下方的适用场景和限制摘自该 skill 自己的文件。

适合场景

  • 你有一个已描述的 UI 元素待探索 —— 一个 toast、一张定价卡片、一个长按删除按钮。
  • 你想要并排看到若干可站得住脚的方向,并倾向于通过实时切换来选择,而不是阅读规格说明。
  • 工作位于一个正在运行的、带有开发服务器的项目中,可以用一个独立路由来承载脚手架。
  • 你完全没有项目,只是在做探索,需要一个可以直接在浏览器中打开的东西。

了解边界

  • 审查已有的 UI —— 这项工作属于 review-animations。
  • 为现有动效规划修复方案,或选择依赖项,这两者都属于其他 skill 的范畴。
  • 把差异化当作放低执行质量的许可:粗糙的变体无法说明它所代表的方向。

需要提供的信息

  • UI 部件的描述这个东西是什么、会出现在哪里、必须完成什么——用一句话重述 brief。
  • 用于侦察的项目访问权限以便 token、个性风格与周边上下文可以为最大胆的变体设定边界。
  • 可选的变体数量调用形式中的 x5 表示需要更多变体,上限为五个。
  • 你最终的选择skill 在展示完整套变体后即停止;晋升需等待你的选择或 keep/riff 指令。

03 Skill 内部

prototype skill 赋予 Claude Code 和 Codex 的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 探索时绝不触碰生产代码

    所有工作都停留在一个隔离的原型界面中;集成只发生在第 6 阶段,且仅针对用户选定的变体。

  2. 每个变体占据一个命名的轴向

    变体必须在布局、密度、个性风格、动效或交互模式上有所分化,且每个轴向在开始构建之前都要能用一句话说清楚。

  3. 每个变体都要有真实内容

    真实的交互、真实的动效,以及带有可信名称与数字的、具有产品质感的文案;不要 lorem ipsum,不要死按钮,不要“想象这一部分”。

  4. 选择器是固定的界面元素

    其标记、样式、键盘绑定与行为均逐字来自 PICKER.md,绝不因项目而调整——它的外观不是一项设计决策。

  5. 每个变体都要满足工艺标准

    差异化不会降低标准:进场动效使用 ease-out,绝不使用 ease-in,UI 动效时长低于 300ms,transform-origin 要正确,只使用 transform/opacity,并处理好 reduced-motion。

  6. 变体切换是即时的

    切换是每次会话超过 100 次的操作,因此依据频率规则,变体切换不带任何动效。

  7. 名称要描述方向

    变体以方向命名——Quiet、Editorial、Playful、Dense——绝不用 Option A/B/C;两个仅在强调色或文案上不同的方向应视为同一个方向。

  8. 选定之后删除该界面

    当某个方案获胜并被晋升后,原型界面会被移除,除非用户要求保留。

04 投入使用

在 Claude Code 或 Codex 中安装 prototype

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 prototype 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/emilkowalski/skills --skill prototype

针对 skills/prototype/SKILL.md 的通用 skills CLI 形式;具体仓库可能会记录其自有路径。

给 Skill 一个首次 UI 设计任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Build me a few versions of the toast that appears after someone saves a filter. It shows bottom-left over the dashboard, has an undo action, and auto-dismisses. We're on React with Tailwind and the tokens live in theme.css. Give me 3 variants and put them behind the picker.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 每个变体都有名称和明确的轴向,且没有两个变体共享同一个轴向位置。
  • 每个变体都能从选择器中访问并正常工作,没有控制台错误。
  • 交付表中不预先指定收藏项;如果被问到会选哪个,理由应来自产品的个性和使用频率。
  • 如果两个变体在构建过程中趋同,就删掉其中一个并说明原因,而不是硬凑数量。
  • 执行 keep 命令后,要检查选择器是否应保留:纯粹的 keep 形式会删除原型表面,保留选择器的形式则会保留它。

在 OpenDesign 中通过其 SKILL.md 链接导入 prototype:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Repository
github.com/emilkowalski/skills 分支 main
Skill 文件
skills/prototype/SKILL.md 验证时记录的内容校验和;提交 d23d7f8
License
MIT 来自 LICENSE。
仓库星标数
37,516 2026-09-14 为整个 emilkowalski/skills 仓库拍摄的 GitHub 快照,该仓库在此目录中包含 9 个 skills。不是 prototype 的评级或使用计数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 运作姿态以资深设计工程师的立场行事;分化本身即是价值所在,工艺标准依然适用
  2. 硬性规则关于生产代码、轴向、可用变体、选择器和清理的五条编号约束
  3. 工作流第 1 到 6 阶段:范围界定、勘察、方向、框架、验证、晋级
  4. 调用变体描述、x5、riff 和 keep 调用及其行为的表格
  5. 语气诚实地推介每个变体,说明其代价,绝不预先指定收藏项
Skill 自身的描述
"构建你描述的 UI 部分的多个真正不同的版本,渲染在可视化选择器后面,以便你可以实时翻阅它们并提升感觉对的那个。仅在明确调用时运行;不会自动触发。"

SKILL.md 前置内容中的描述。完整文件约 7,432 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 prototype Skill 的问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

我在编辑 UI 时它会自动触发吗?

不会。它只在被明确调用时运行,绝不会自行触发,且已为其禁用模型调用。你可以用一个描述、可选的 x5 数量,或 riff 或 keep 命令来调用它。

Prototype

在真实 UI 设计任务上运行 prototype

下载 OpenDesign,从其 SKILL.md 链接导入 prototype,粘贴上方的提示,在结果前阅读计划。

终端
npx skills add https://github.com/emilkowalski/skills --skill prototype

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows