用途
UX Specification 用于把产品需求文档(PRD)转化为具体的用户流程、页面和交互规格,让编码智能体能够据此实现界面。它存在的意义是弥合产品需求与实现之间的差距,明确产品“长什么样、如何表现”。
输入要求
该技能期望以下输入:
- PRD(来自 prd-generation 或用户提供)
- 任何已有的草图、线框图或参考(可选)
- 设计偏好或约束(可选)
工作流程
第 1 步:读取 PRD
从 PRD 中提取:
- 用户故事(尤其是 Must Have)
- 功能与验收标准
- 目标用户特征
- 技术约束
第 2 步:映射用户流程
针对每个核心用户故事定义流程,需回答:
- 用户从哪里开始?
- 顺利路径是什么?
- 有哪些决策点?
- 用户最终到达哪里?
- 可能出现什么问题?
第 3 步:定义页面
针对流程中的每个页面:
- 目的是什么?
- 需要哪些组件?
- 展示哪些数据?
- 有哪些可用操作?
- 存在哪些状态?
第 4 步:指定交互
针对关键交互:
- 什么触发该操作?
- 用户获得什么反馈?
- 屏幕上发生什么变化?
- 耗时多久?
第 5 步:澄清缺口
如有需要,提出针对性问题,例如:
- “这应该是模态框还是新页面?”
- “如果列表为空会怎样?”
- “用户如何知道正在加载?”
- “有特定布局偏好吗——侧边栏、标签页、单页?”
输出格式
使用 Write 工具自动将输出保存到 design/06-ux-spec.md,同时向用户展示。输出结构包括:
- Overview:产品与主要用户目标的简要总结
- Information Architecture:导航结构(树形)与关键用户路径
- User Flows:每个流程包含触发条件、用户目标、流程图、步骤、错误路径
- Screens:每个页面包含 URL/路由、目的、入口点、ASCII 布局、组件表、状态表(默认/加载/空/错误/成功)、操作表
- Components:每个组件包含使用页面、目的、Props/Inputs 表、变体、状态(默认/悬停/激活/禁用)
- Interactions:每个交互包含触发、响应、时长、反馈
- Responsive Behavior:断点(移动端 < 768px、平板 768px–1024px、桌面 > 1024px)与关键适配
- Design Notes:可选,风格、参考、约束
适配指南
- 简单项目(1–3 个页面):跳过信息架构;合并流程与页面;最小化组件部分;跳过响应式行为。
- 中型项目(4–8 个页面):使用完整结构;聚焦核心流程而非边缘情况。
- 复杂项目(10+ 个页面):增加逐页细节;记录所有组件变体;包含边缘情况流程;增加 Design Notes 部分。
写作指南
- ASCII 布局足够——不要过度复杂,只需展示结构
- 状态至关重要——加载、空、错误状态可防止智能体猜测
- 触发条件要具体——“点击”与“悬停”与“聚焦”有区别
- 命名保持一致——跨页面使用相同组件名称
交接
展示 UX 规格后,询问:“Ready to generate prompts.md with /prompt-export, or want to refine any screens first?”
注意:文件会自动保存到 design/06-ux-spec.md,并用于后续开发提示。
适用场景
适用于已有 PRD、需要将其转化为可执行界面规格的团队或个人,尤其是希望让编码智能体依据明确规格实现界面的工作流。
限制
资料未提供关于收费、价格、平台支持范围、具体效果或性能的说明。