/design-handoff
如果遇到不熟悉的占位符或需要检查已连接的工具,请参阅 CONNECTORS.md。
从设计稿生成全面的开发者交接文档。
使用方法
/design-handoff $ARGUMENTS
为 @$1 生成交接规范。
如果提供了 Figma 链接,则从 Figma 拉取设计。否则,根据提供的描述或截图开展工作。
应包含的内容
视觉规范
- 精确尺寸(内边距、外边距、宽度)
- 设计令牌引用(颜色、字体、间距)
- 响应式断点及行为
- 组件变体与状态
交互规范
- 点击/触摸行为
- 悬停状态
- 过渡与动画(时长、缓动函数)
- 手势支持(滑动、捏合、长按)
内容规范
- 字符限制
- 截断行为
- 空状态
- 加载状态
- 错误状态
边界情况
- 最小/最大内容
- 国际化文本(较长字符串)
- 慢速连接
- 数据缺失
无障碍
- 焦点顺序
- ARIA 标签与角色
- 键盘交互
- 屏幕阅读器播报
原则
- 不要猜测 — 如果未指定,开发者就会自行猜测。请明确每一项。
- 使用令牌,而非值 — 引用
spacing-md而不是16px。 - 展示所有状态 — 默认、悬停、激活、禁用、加载、错误、空。
- 解释原因 — “该部分在移动端折叠,因为用户通常单手操作”有助于开发者做出合理判断。
输出
## 交接规范:[功能/屏幕名称]
### 概述
[此屏幕/功能的作用,用户上下文]
### 布局
[网格系统、断点、响应式行为]
### 使用的设计令牌
| 令牌 | 值 | 用途 |
|------|------|------|
| `color-primary` | #[hex] | 主要按钮、链接 |
| `spacing-md` | [X]px | 段落间距 |
| `font-heading-lg` | [字号/字重/字族] | 页面标题 |
### 组件
| 组件 | 变体 | 属性 | 备注 |
|------|------|------|------|
| [组件] | [变体] | [属性] | [特殊行为] |
### 状态与交互
| 元素 | 状态 | 行为 |
|------|------|------|
| [CTA 按钮] | 悬停 | [背景变暗 10%] |
| [CTA 按钮] | 加载 | [显示加载动画,按钮禁用] |
| [表单] | 错误 | [红色边框,错误信息] |
### 响应式行为
| 断点 | 变化 |
|------|------|
| 桌面端 (>1024px) | [默认布局] |
| 平板 (768-1024px) | [变化内容] |
| 手机端 (<768px) | [变化内容] |
### 边界情况
- **空状态**:[无数据时显示的内容]
- **长文本**:[截断规则]
- **加载中**:[骨架屏或加载动画]
- **错误**:[错误状态外观]
### 动画/动效
| 元素 | 触发条件 | 动画 | 时长 | 缓动函数 |
|------|----------|------|------|----------|
| [元素] | [触发条件] | [描述] | [ms] | [缓动函数] |
### 无障碍备注
- [焦点顺序]
- [需要的 ARIA 标签]
- [键盘交互]
如果连接了工具
如果已连接 ~~设计工具:
- 从 Figma 拉取精确尺寸、令牌和组件规范
- 导出资源并生成完整的规范表
如果已连接 ~~项目管理工具:
- 将交接文档链接到实现工单
- 为规范中的每个章节创建子任务
提示
- 提供 Figma 链接 — 我可以拉取精确的尺寸、令牌和组件信息。
- 提及边界情况 — “100 个项目时会发生什么?”有助于我制定边界条件规范。
- 指定技术栈 — “我们使用 React + Tailwind”有助于我给出相关的实现备注。