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.md

GitHub

Briefbound 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 内给出反馈,且悬停不是唯一路径;失焦后再校验,错误写在字段旁;破坏性操作可撤销或先确认。选择、数值和危险操作用原生控件。
  • 覆盖长文本、空、错误、加载、选中、焦点、禁用和窄屏;不重叠、跳动、裁切或挡住操作。保证语义、键盘、可见焦点、对比度和非颜色提示。
  • 避免嵌套卡片、装饰堆叠、单一色调、紧凑面板里的超大字号,以及与任务无关的炫技。

实施与验证

  1. 读取 owning component、样式/token 和相邻页面,确定现有约定。
  2. 选择满足用户任务的最小界面方向;复杂复用决策才做外部调研。
  3. 命中 PREVIEW_REQUIRED 时先完成隔离网页并等待批准;批准前不进入正式实现。
  4. 收到 APPROVED 或有依据的 PREVIEW_SKIPPED 后,在授权 surface 内实施,保持原有数据和行为契约。
  5. 可运行时用浏览器验证目标路由,覆盖主要桌面视口和相关移动视口;检查 console、溢出、交互反馈和关键状态。
  6. 画布、3D、图片或动效是核心时,补充像素非空、构图、资源加载或运动证据。

代码检查只证明结构,不能替代可运行 UI 的视觉证据;浏览器不可用时明确说明未验证项,不声称“视觉已完成”。

有自然闸门时正文末行为 下一步建议: <一个具体动作>,否则声明继续已授权工作。