Communitygithub.com

原型优先

在编写任何代码之前,以原型形式展示设计选项供选择,适用于新屏幕、新流程、重新设计、网站、登录页以及任何“展示选项”或“能做原型吗”的请求。

原型优先 是什么?

“原型优先”是一项AI代理技能,旨在防止在不确定的设计方向上投入工程资源。其核心理念是在编写任何代码之前,让设计师从基于原型的选项中做出选择。该技能定义了一个严格的工作流程,包括五个阶段:收集参考和提问、构建2-4个变体(包含一个源于代理自身建议的更好方案)、以标准化表格格式发送回合并停止、解读设计师的反馈(支持字母选择、精确修改或混合搭配),以及根据选择进行构建。关键规则包括:决不为原型创建PR(甚至草稿也不行)、每轮之后停止等待反馈、将所选原型视为规范、遵循精确的值(颜色、间距、排版)而非标签进行构建。该技能可在Claude Code、Cursor、Codex等AI编码代理中使用,并通过命令行调用如`/prototype-first`、`/prototype-first <variant>`和`/prototype-first compare`来触发完整工作流、迭代单个变体或创建与当前UI的对比视图。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

在你喜欢的 AI 中提问

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

文档

原型优先 是做什么的?

我是一名设计师。我通过看和点击来评判工作,而不是通过阅读计划。一个原型只需几分钟。构建错误的东西则需要一堆PR和一整天的审查。

这个技能只做一件事:在编写代码之前,让我选择一个设计方向。它绝不会为原型打开PR,绝不会将原型作为产品发布,也绝不会构建一个我没有选择的方向。

硬性规则

  1. 绝不为原型打开PR,连草稿都不行。 PR是为要合并到main分支的代码准备的。原型PR会为注定要丢弃的东西增加审查和CI噪音。
  2. 每轮之后停止。 按以下格式发送变体,然后等待我的回复。不要在我查看时开始构建“最有可能被选中的”那个。如果我选了别的,那些工作就白费了,而且我还得审查。
  3. 选中的原型就是规范。 构建结果必须看起来像它。之后的反馈只修改我指出的内容。我会将构建结果与我选中的图片进行比较,因此任何偏差都会被解读为错误,而非改进。
  4. 原型标签保留在原型文件中。 “B2”、“方向A”以及变体昵称永远不能出现在代码、令牌、提交、PR或议题中。它们只在选择过程中有意义。在代码库中,它们是以后别人需要解码的噪音。
  5. 把参考资料当图片看。 当我提到参考网站或应用时,请查看它们的截图。仅靠文本获取会丢失使该参考有价值的视觉品质,结果会显得很平庸。

这应该做成原型吗?

修改是否有一个显而易见的答案(间距值、标签、颜色令牌)?
├── 是 → 直接构建并说明更改了哪些内容。跳过原型是一个好结果。
└── 否
    ├── 新屏幕、新流程、重新设计或2个以上合理答案?
    │   └── 是 → 做原型。
    │       ├── 需要真实数据、真实导航或原生行为?
    │       │   └── 是 → 从main分支创建临时分支 `proto/<topic>`
    │       └── 否 → 独立的HTML文件,在聊天或议题线程中共享
    └── 不确定 → 用一行询问:“这个做原型还是直接构建?”

永远不要将原型隐藏在产品的/lab路由或开发标志后面。

工作流程

阶段 1:参考和提问

  1. 收集我提到的每个参考的截图。将长页面裁剪成几个部分。
  2. 为每个参考写下具体观察:类型、标题处理方式、产品如何展示、布局如何组织以及最突出的一个点。说明每个点为什么有效。
  3. 质疑请求。如果我要求的内容体验不佳,请说出来并说明原因。从最终用户的角度思考,而不是从我描述的直接修复方法出发。
  4. 针对你无法推断的内容,问我几个简短、编号的问题,例如类型、密度、语气以及从当前版本中保留什么。

完成条件: 每个参考都有书面观察结果,并且我回答了你的问题,或者你没有问题可问。

阶段 2:构建变体

  • 展示2到4个变体,标记为A、B、C和D。一个变体无法让你了解我的品味。超过四个则是噪音。
  • 至少有一个变体是你自己的更好想法,如果你在阶段1中提出过异议。把它放在我要求的那个旁边。
  • 在上下文中模拟。 展示整个窗口或区域,而不是一个漂浮在空白页面上的组件。
  • 使用真实的设计。 使用应用当前的令牌、类型和组件。如果应用有明暗两种模式,也要展示出来。
  • 使用逼真的数据。 使用看起来真实的名称、数字和文本长度。绝对不要用lorem ipsum,也不要使用真实人物或地点的数据。
  • 让流程可点击。 对于任何有步骤或状态的操作,构建一个包含场景切换器、明暗切换、可交互操作以及每个状态含义的平白语言说明的HTML文件。
  • 使精细度与问题匹配。 对于视觉方向,它看起来应该像成品,因为外观正是我要评判的。对于流程,它看起来像应用并且能正常工作,边缘的精细度可以稍后处理,因为我评判的是自己是否会迷路。

完成条件: 每个变体都在上下文中使用真实令牌和逼真数据进行了模拟,并且每个流程都是可点击的。

阶段 3:发送本轮结果并停止

按照“所需输出格式”下的格式发送本轮结果。然后停止。

完成条件: 本轮结果已发送。在我回复之前,不做任何其他事情。

阶段 4:解读我的选择

我怎么说这意味着你该怎么做
“C”按展示的样子构建C进入阶段5
“D, 但1.5px 不是3px”D,但做那个精确的修改只修改那一点,然后进入阶段5
“A的按钮,C的搜索栏”混合从我指定变体中取出每个命名的部分。我表示最喜欢的那部分占主导地位。不要偏向于更容易构建的那个变体。
“我喜欢B,但我想测试一下”临时选择构建B,并保留次优选项,直到我在真实应用或设备上尝试过B
对某个变体的反馈迭代只展示该变体的下一轮,回到阶段3
“我不理解这个原型”停止原型设计通过PR构建真实的东西
“这些都不行”你误解了我的意图回到参考和我说的话。不要制作同一想法的第四个版本。

当我不说时,问为什么。 如果我选择了但没有给出理由,问一个简短的问题:“是什么让B赢了?”将我的回答与决定一起记录下来。一个没有理由的选择无法让下一个代理了解我的品味。

完成条件: 你知道了要构建哪个变体或哪部分混合,以及为什么。

阶段 5:从选择开始构建

  • 向构建者简要说明,并提供原型链接和确切的值:颜色、大小、间距和类型。没有人靠记忆重建。
  • 通过“是什么”来描述设计(“密集表格、状态标签、左侧边栏”),绝不用它的标签。
  • 只在我要指出方向时,应用之后的一般性反馈(“太杂乱”、“没有层次结构”)。这并不意味着允许删除我在原型中喜欢的内容。在删除或更改原型元素之前,要指出它并询问。

完成条件: 构建结果与选择匹配,并且没有原型标签出现在代码、提交、PR或议题中。

所需输出格式

每轮结果看起来像这样:

**查看位置:** <链接或附件>,或 `git checkout proto/<topic> && <运行命令>`

| 变体 | 押注在 | 权衡 |
| --- | --- | --- |
| A | <一行:此变体测试的想法> | <它放弃了什么> |
| B | ... | ... |

**我提出异议的内容:** <一两行,或“无”>

回复一个字母、一个组合(`A的x, C的y`),或`none`。

坚持此格式。原型本身会解释一切。

调用变体

调用方式行为
/prototype-first从阶段1开始的完整工作流,阶段3后停止
/prototype-first <变体>迭代上一轮的一个变体,回到阶段3
/prototype-first compare一个带有当前UI的NOW / PROPOSED开关的原型

相关技能