frontend-ui-ux-system

Frontend UI/UX System

用途

• 把 UI/UX 决策前置到计划和方案阶段，不把视觉和体验变成实现末端的补丁。
• 让 tech-lead、frontend-engineer、qa-engineer 在同一套设计语言下协作。

默认做法

1. 检查项目根目录是否存在 DESIGN.md：

• 若存在：读取 DESIGN.md，将其 Section 02（色盘）、Section 03（排版）、Section 04（组件）的具体值作为后续所有设计决策的基准，不得与之冲突。
• 若不存在：在 [design-system-brief.md](../../templates/design-system-brief.md) 第 7 节确认参考品牌，通过 npx getdesign@latest add <brand> 或直接填写 [DESIGN.md 模板](../../templates/DESIGN.md) 生成，放置于项目根目录。
• 参考：[DESIGN.md 使用工作流](../../docs/runbooks/design-md-workflow.md) · [字段映射说明](references/design-md-integration.md)

1. 先阅读 [frontend-ui-ux-standards.md](../../rules/frontend-ui-ux-standards.md) 和 [frontend-quality-gates.md](../../rules/frontend-quality-gates.md) 明确硬性门禁。
2. 用 [product-style-map.md](references/product-style-map.md) 与 [design-tokens.md](references/design-tokens.md) 锁定产品类型、视觉方向和 token 策略。
3. 对新界面或大改版先补齐 [design-system-brief.md](../../templates/design-system-brief.md)，对进入实现的任务补齐 [ui-implementation-plan.md](../../templates/ui-implementation-plan.md)。
4. 在交付评审前使用 [interaction-accessibility.md](references/interaction-accessibility.md)、[delivery-checklist.md](references/delivery-checklist.md) 与 [ui-review-checklist.md](../../templates/ui-review-checklist.md) 做闭环检查。

何时优先调用

• tech-lead 需要判断某个需求的 UI 范围、设计约束和体验门禁是否已经足够明确。
• frontend-engineer 需要在多种视觉方向和交互模式中选定统一方案。
• qa-engineer 需要把视觉、交互、无障碍和性能检查标准从“主观观感”变成一致规则。