写给 AI coding 的 UI Prompt

如何为 AI 编程助手写出清楚的 UI Prompt?

把模糊的产品想法整理成可实现的 UI Prompt,补齐用户目标、操作方式、页面状态、限制与验收检查。

指南 · 06
先看答案

好的 UI Prompt 要说清楚:谁需要完成什么、界面如何操作、要处理哪些状态、项目有哪些限制,以及如何验收。只有在组件行为真的符合任务时,才指定组件名称。

01

1. 先写用户目标,不要先指定组件

先说清楚谁要完成什么,以及这件事为什么重要。确认行为真的合适后,再加入 UI 术语。组件名称只是一种可能的解法,不是产品目标。

  • 模糊:添加一个漂亮的玻璃拟态 Dashboard。
  • 更清楚:让客服主管看出未解决的工单与紧急程度,并在不丢失当前筛选条件的情况下打开下一条工单。
02

2. 写清楚操作、状态与边界

说明界面如何打开、每个操作会改变什么、如何关闭,以及哪些内容必须保留。可能发生时,也要写入加载、空白、错误、成功、重试、取消和权限状态。

03

3. 先按行为选模式,再补视觉与动效

能想象界面却不知道名称时,可以先用图鉴找词,再比较相近模式。把操作行为、视觉风格和动效分开决定,避免视觉要求悄悄改变产品的使用方式。

04

4. 加入可以实际验收的条件

把重要规则改写成可以观察、可以判断通过或失败的检查。按功能涵盖键盘、可见焦点、状态提示、小屏幕、缩放、减少动态、加载、失败、重试和数据保留。

05

5. 要求写代码前,先提供项目背景

写出现有技术、设计系统、可复用组件、数据来源、路由和修改范围,也要说明哪些行为不能改。助手在修改前仍应查看真实项目和测试。

06

6. 用固定结构保留每个产品决策

实用顺序是:结果、用户与场景、操作行为、页面状态、内容与数据、视觉方向、无障碍、项目限制、验收条件,以及不做的范围。假设和未决问题要明确标出,不要隐藏。

  • 结果:完成后,谁应该能做成什么?
  • 操作与状态:流程如何开始、改变、完成、失败和恢复?
  • 验收:哪些明确证据可以证明结果正常?