用途:BMAD 方案阶段的 UX 规划技能,仅在项目包含 UI 时启用,产出两份规划文档作为下游故事编写与外部开发工具的 UX 契约。它只产出规格,不写代码。
产物:位于 bmad-output/(或 config.yaml 指定目录)的 DESIGN.md(视觉系统:令牌、组件、无障碍契约)与 EXPERIENCE.md(旅程、流程、状态、错误/空/加载规格)。两份文档为锁定的规划产物,外部开发工具可读不可改;设计决策记入 decision-log.md。
三种意图:Create 从零生成两份文档(最常用);Update 需求变更时修订指定章节并在 decision-log.md 追加带日期条目;Validate 审计现有文档完整性与 WCAG 2.1 AA 差距,运行 WCAG 检查清单,只报告不改代码。
前置读取顺序:bmad-output/config.yaml(项目名、轨道、输出目录)、project-context.md(用户画像、平台目标、约束)、prd.md(若有:功能列表、用户故事、验收标准)、architecture.md(若有:组件边界、API 契约);缺失时先向用户询问关键输入。
DESIGN.md 覆盖:设计令牌(色彩含语义色、字体与 8px 基础单位、间距、圆角、阴影、320/768/1024/1440px 断点,令牌须为具体值;移动端正文最小 16px)、组件规格(每组件默认及 hover/focus/active/disabled/loading/error/success 状态、响应式行为、ARIA 与 44×44px 触控目标)、WCAG 2.1 AA 契约(正文对比度 ≥4.5:1、大文本 ≥3:1、UI 图形 ≥3:1、可见焦点指示、键盘可达、320px 无横向滚动)。可用脚本验证:bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-ux/scripts/wcag-checklist.sh"、python "${CLAUDE_PLUGIN_ROOT}/skills/bmad-ux/scripts/contrast-check.py" #foreground #background、bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-ux/scripts/responsive-breakpoints.sh"。
EXPERIENCE.md 覆盖:用户旅程(目标、画像、入口、主路径、预计时间、流失风险)、屏幕/状态清单(默认、加载、空、错误、成功、禁用)、决策点与备选路径(触发、展示、恢复)、交互与动效(时序缓动、尊重 prefers-reduced-motion)。
超过四个主要旅程时可并行子代理:先将共享上下文写入 bmad-output/ux-shared-context.md,再分派令牌/组件/无障碍/各旅程草稿,主上下文汇总并全屏运行 WCAG 检查。
限制:绝不编写应用代码、CSS、组件实现或测试;项目无 UI(仅 API、CLI 或后台服务)时跳过并在 decision-log.md 记录;两份文档获批后交给 story-creation 技能,止于“实现”之前。更多细节见 REFERENCE.md。