briefbound-ui-design
Use when a Briefbound task needs a new or revised UI/UX direction, information architecture, interaction model, responsive behavior, accessibility decision, or implementable interface contract; do not
SKILL.mdskills/engineering/briefbound-ui-design/SKILL.md
GitHubBriefbound UI Design
目标
作为 UI/UX 专项 owner,把用户目标转成可实施、可渲染验证的界面契约。先尊重现有产品和设计系统;真实设计分叉影响结果时才向用户对齐,不把普通前端修改升级成设计流程。
Briefbound task contract
- Context Boundary: 用户目标、目标页面/组件、现有设计系统、相邻界面、实现技术栈和可运行环境。
- Output Contract: 可实施的界面契约;命中预览闸门时先交付隔离预览 URL、代表截图、覆盖状态和用户批准状态。
- Allowed Action: 在 Briefbound Router 授权范围内检查 UI surface;
PREVIEW_REQUIRED时只写隔离预览,收到APPROVED后才可修改正式 UI owning surface;不顺带重做品牌、后端协议或无关页面。 - Success Evidence: 预览阶段为可访问网页、桌面/移动截图、关键状态与模拟边界;正式阶段为浏览器截图、DOM/布局、目标视口和交互状态检查。
- Stop Condition:
WAITING_USER_REVIEW、用户要求REVISE/ABANDON、目标 surface 不明、品牌/设计系统冲突、应用不可运行且代码证据不足,或修改越过授权边界。 - Route Out: 品牌表达成为主要未知量时转
briefbound-visual-design;只交付方案或需要独立实施 handoff 时转briefbound-frontend-engineering;已有界面审查转briefbound-ui-review;跨组件事实源治理转briefbound-design-system;复杂外部复用决策转briefbound-feature-reuse-research;验证后的真实残留转briefbound-development-cleanup;PR 正确性审查转briefbound-pr-review;阻塞则回briefbound-router。
统一调用契约
- 只处理 Briefbound task contract 范围;不匹配时回
briefbound-router或更具体 owner,复合任务不吞其他 owner。 - 用户可见内容默认中文,完成只报状态、产出、证据和剩余风险;代码、命令、路径、错误原文、API/协议、skill 名和枚举保留原样;Route Out 仅以 Briefbound task contract 为准;有自然闸门(需用户裁决、批准或被外部阻塞)时末行
下一步建议: <一个具体动作>,否则声明继续已授权工作。
触发强度
FAST_PATH:既有模式下的文案、小样式、状态或响应式修复。记录PREVIEW_SKIPPED依据,直接修改并做目标验证。COMPACT_FLOW:新增页面/组件或多个相关交互状态。界面结果未批准时先制作隔离预览并等待用户预审。FULL_FLOW:跨页面信息架构、设计系统、品牌重构、复杂编辑器或高影响可访问性改造。只保留会改变决策的方案和闸门。
默认 0 个问题。用户只说“更好看/更现代”时,先结合产品类型、现有界面和主要任务给出推荐方向;仅当不同方向会显著改变布局、交互或品牌结果时,集中给出 2-3 个具体选项,标出推荐和代价。
单 owner 贯穿
用户同时要求设计并实现时,本 owner 贯穿预览、批准后的正式实施和浏览器验证,不再二次加载 Frontend Engineering。WAITING_USER_REVIEW 是必须暂停的自然闸门,不因已有一般实现许可而跳过。仅当用户只要设计方案、需要跨会话/独立 owner 交接,或实现范围超出当前授权时才 Route Out。视觉细节和现有 token 使用是本任务内部决策;只有品牌语言或共享事实源成为主要问题时才切换专项 owner。
预览批准闸门
继承 Briefbound Router 的 PREVIEW_REQUIRED / PREVIEW_SKIPPED:
PREVIEW_REQUIRED:新增页面,或信息架构、布局、交互、响应式结果、跨组件 UI 结果尚未获用户确认。PREVIEW_SKIPPED:文案、明确小修、既有模式机械改动,或已有用户批准的具体设计/预览。- 预览优先复用项目技术栈、组件和安全 mock 数据,放入已有 preview/example surface 或任务级临时目录;不先改正式 route、生产组件或真实写接口。
- 必须提供可访问本地网页、主要桌面/移动截图、关键状态和模拟/未验证说明;项目无法运行才降级为独立 HTML/CSS/JS 网页。
- 交付后进入
WAITING_USER_REVIEW,请用户回复APPROVED / REVISE <反馈> / ABANDON。沉默、测试通过或 Agent/UI Review 判断都不构成批准。 REVISE只迭代预览;APPROVED后按已确认契约连续修改正式 surface;ABANDON不落地该方向。
界面契约
实施或审查前,内部确认最少必要信息:
- 用户与任务:谁在什么场景下,需要看懂、比较、输入或完成什么。
- Surface 与主路径:首屏、主操作、返回/取消,以及 loading、empty、error、disabled、success 等关键状态。
- 信息层级:什么先被看到,哪些内容需要扫描、对比、编辑或信任。
- 交互模型:控件类型、反馈、键鼠/触控、破坏性动作与恢复方式。
- 视觉约束:现有 token、组件库、品牌、密度、字体、颜色、图标、动效和图像资产。
- 响应式边界:目标视口、固定格式元素、换行、溢出、最小尺寸和移动端降级。
- 验证面:需要打开的 route、状态和视口。
简单任务不输出完整契约;只把会影响实现或验收的部分说给用户。
设计判断
- 设字号、行高、行长时读
briefbound-visual-design的references/craft-baseline.md排版段;设间距和栅格时读间距段。 - 运营工具保持安静、紧凑、可扫描;展示页才加强图像、节奏和动效。先复用相邻页面、组件和 token;组件库不自动成为设计系统。
- 交互:相关字段成组,次要项折叠;触控目标至少 44×44px;按下约 100ms 内给出反馈,且悬停不是唯一路径;失焦后再校验,错误写在字段旁;破坏性操作可撤销或先确认。选择、数值和危险操作用原生控件。
- 覆盖长文本、空、错误、加载、选中、焦点、禁用和窄屏;不重叠、跳动、裁切或挡住操作。保证语义、键盘、可见焦点、对比度和非颜色提示。
- 避免嵌套卡片、装饰堆叠、单一色调、紧凑面板里的超大字号,以及与任务无关的炫技。
实施与验证
- 读取 owning component、样式/token 和相邻页面,确定现有约定。
- 选择满足用户任务的最小界面方向;复杂复用决策才做外部调研。
- 命中
PREVIEW_REQUIRED时先完成隔离网页并等待批准;批准前不进入正式实现。 - 收到
APPROVED或有依据的PREVIEW_SKIPPED后,在授权 surface 内实施,保持原有数据和行为契约。 - 可运行时用浏览器验证目标路由,覆盖主要桌面视口和相关移动视口;检查 console、溢出、交互反馈和关键状态。
- 画布、3D、图片或动效是核心时,补充像素非空、构图、资源加载或运动证据。
代码检查只证明结构,不能替代可运行 UI 的视觉证据;浏览器不可用时明确说明未验证项,不声称“视觉已完成”。
有自然闸门时正文末行为 下一步建议: <一个具体动作>,否则声明继续已授权工作。