design

设计技能

使用 $design 发现产品与 UI 证据，仅补齐对设计至关重要的上下文缺口，并创建或刷新仓库中持久存在的 DESIGN.md 契约。它是一份持续维护的设计简报，而非像素级匹配循环或一次性评审。

共享的操作、委派、状态、钩子、团队、取消与验证不变量位于 templates/AGENTS.md。请遵循该来源，而不要在此处重复其规则。

适用场景

• 产品、UX、前端或设计系统决策需要仓库内的唯一事实来源。
• 某项功能在进入设计师工作流或实现之前需要一份设计简报。
• 现有 UI、资产、截图或约束需要一份可执行的设计摘要。

不要将其用于视觉参考实现匹配（使用 $visual-ralph）、仅做截图对比，或没有面向用户设计影响的后端/基础设施工作。

与 $visual-ralph 的关系

$design 在 DESIGN.md 中负责产品目标、用户、信息架构、视觉语言、组件、无障碍、约束与待解决问题。$visual-ralph 负责针对已批准的视觉参考或实时 URL 基线进行实现、给出可度量的判定结果，以及像素差异证据。当两者都需要时，先运行 $design；DESIGN.md 支持视觉判定目标，但不替代它。

工作流

1. 发现本地证据

检查并引用现有的 DESIGN.md、设计/UX/前端文档、README/规格/issue、路由/页面/布局/组件/story、主题与 token 文件、资产、截图/原型图、Storybook 或 Playwright 基线，以及无障碍/响应式/i18n/平台约束。将观察与推断分开；记录缺失的证据。

2. 仅针对缺失的上下文进行访谈

仅针对仓库无法解决的缺口提出简洁的问题：用户/任务、目标/非目标、品牌个性与禁忌美学、主要流程、无障碍/设备/浏览器目标，或不可用的资产/参考。如果无法获得答案，记录明确的假设与待解决问题，而不是阻塞。

3. 创建或刷新 DESIGN.md

保留有用内容，移除矛盾之处，标记未知项，并保持决策可执行。根文件必须包含以下章节：

Design

Source of truth

状态（Draft | Active | Needs refresh）、日期、产品界面、已审查的证据。

Brand

个性、信任信号、避免事项。

Product goals

目标、非目标、成功信号。

Personas and jobs

主要人物画像、用户任务、使用情境。

Information architecture

导航、路由/屏幕、内容层级。

Design principles

原则与权衡。

Visual language

色彩、字体排印、间距、形状/高度、动效、图像/图标。

Components

现有/新组件、变体/状态、token 归属。

Accessibility

目标标准、键盘/焦点、对比度、语义、减少动效/感官相关考量。

Responsive behavior

断点/设备、布局适配、触控/悬停差异。

Interaction states

加载、空状态、错误、成功、禁用、离线/慢速网络（如适用）。

Content voice

语气、术语、微文案规则。

Implementation constraints

框架/样式、token、性能、兼容性、测试/截图预期。

Open questions

[ ] 问题、负责人与影响。

4. 应用契约

在做出 UI 决策之前，引用相关的 DESIGN.md 章节，复用已记录的组件/token，并在实现暴露出矛盾时更新该文件或添加待解决问题。不要另造一个平行的设计系统层。

5. 交接

对于常规前端工作，提供相关章节、仓库证据与验收标准。对于视觉参考、图像或实时 URL 匹配，请带着已批准的基线交接给 $visual-ralph，并将 DESIGN.md 仅标注为支持性上下文。

证据与完成

仅当设计文档/资产/组件/截图已检查或已注明缺失；缺失的上下文已得到解答、假定或列出；根目录 DESIGN.md 包含所有必需章节；建议引用该文件；且任何 Visual Ralph 交接都与设计治理明确分离时，方可完成。

任务：{{ARGUMENTS}}