SuperAPI AI 工具集

ux-specification

设计与创作

查看项目

更新于 10-15 08:17

技能介绍

用途

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、需要将其转化为可执行界面规格的团队或个人,尤其是希望让编码智能体依据明确规格实现界面的工作流。

限制

资料未提供关于收费、价格、平台支持范围、具体效果或性能的说明。