用途:该技能把产品/设计方向转化为可执行的 UI 设计简报,用于指导图像生成概念、HTML 原型或后续实现工作。它是产品思考与实现之间的桥梁,定义界面应呈现的外观、感觉与行为,但不强制过早确定代码架构。
何时使用:当用户希望为想法探索 UI 设计、在 idea 工作流中加入专门的 UI/设计阶段、生成应用截图/仪表盘/落地页/产品界面的图像提示词、在交给编码智能体前先产出 UI 简报、根据已有截图批评或重设计已构建应用、或把设计文档转成逐屏 UI 需求时使用。
不适用:用户只想要快速 Lite 想法笔记;想法尚不清晰、无法确定目标用户与核心行为;用户想立即获得生产级前端代码(应在选定 UI 方向后使用实现类技能);用户只想要正式的 token 规范(可用 design-md)。
产物位置:Full 模式的想法包中,该产物放在设计文档之后、实现规划之前,编号为 02-ui-design-brief.md。若用户跳过此阶段,保留旧工作流编号与行为,或在实现规格中把 UI 决策标记为假设,不因缺少 UI 简报而阻塞流程。
所需输入:产品目的与目标用户、核心用户流程、主要屏幕或界面、平台目标(web/桌面/移动 web/原生移动/多界面)、期望感受(平静、指挥中心、有趣、专业、密集、极简等)、视觉约束(品牌、现有仓库/设计系统、无障碍需求、深色/浅色模式)、重要状态(空、加载、错误、成功、首次运行、重复使用)。缺失且用户未强制推进时,每次只问一个简洁问题。
UI 简报结构包含:Purpose、Product Feel、Design Principles、Primary Surfaces / Screens、Screen-by-Screen Notes、Layout / Information Architecture、Component Inventory、Key User Flows、States to Design、Visual Direction、Accessibility and Responsiveness、Content / Copy Notes、Optional Image-Generation Concepts、Selected Direction、Open Questions、Handoff Notes for Implementation。
可选图像生成:图像生成仅作概念探索,不是实现真相来源。默认三种概念提示词:Conservative、Strong-fit、Divergent。每个提示词应指定产品类别与目标用户、屏幕类型与平台、信息层级、密度与交互姿态、视觉风格与主题、不应出现的内容,并说明结果是 UI 概念截图而非营销艺术。图像生成后,将路径或 URL 记入简报,用视觉分析或人工评审提取优劣,更新 Selected Direction;不要要求构建智能体盲抄图像,而应转成文本需求、组件、token 与验收标准。
构建后重设计循环:截取已构建应用截图,与 UI 简报和产品设计文档对比,识别层级、间距、导航、文案、状态处理、响应式等 UI 差距;可选生成替代 UI 概念;产出聚焦的重设计简报与实现任务清单,交给 Superpowers 时限制为仅改进 UI,除非明确批准否则不改后端行为。
集成规则:默认仅 Full 模式;不得使工作流强制或脆弱;跳过则继续旧的设计文档→实现规格→交接顺序;用户求快时,仅在设计文档中并入简短的 UI/UX 备注章节;图像生成不可用时,写入图像提示词并继续纯文本 UI 简报;已有仓库时,先检查当前 UI/组件再发明新方向。
常见陷阱:让图像变成规格(图像是灵感,书面 UI 简报与实现交接才是真相来源);把 Lite 模式复杂化;通用仪表盘式堆砌(避免假指标、无关图表、装饰性卡片);跳过状态(空、加载、错误、成功、首次运行、移动状态);破坏产物编号;复制专有参考。
验证清单:工作流为 Full 模式或用户明确要求 UI 设计;产品/设计方向清晰到足以做屏幕级 UI 决策;若执行了该阶段,02-ui-design-brief.md 存在;即使跳过图像生成,可选图像提示词也存于简报中;生成图像被当作参考并转成文本需求;实现交接引用选定的 UI 方向,或明确说明 UI 为假设;若跳过该阶段,旧工作流仍可无阻塞推进。