其他
工程接手实现设计时,编写完整交接规格以确保准确落地
当开发开始接手实现设计时,用此技能产出包含视觉、交互、内容、资产、边界情况与实现说明的交接文档。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 48/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 56/100 ×0.15
适用场景
工程接手实现设计时,编写完整交接规格以确通用
解决思路
- 视觉规格:提供间距和尺寸(精确像素值或 token 引用)。
- 视觉规格:提供颜色值(使用 token 名称,而不是 hex codes)。
- 视觉规格:提供排版信息(样式名、字号、字重、行高)。
- 视觉规格:提供 border radius、shadows、opacity 值。
- 视觉规格:提供响应式断点行为。
- 交互规格:定义状态(default、hover、focus、active、disabled)。
- 交互规格:定义过渡和动画(duration、easing、properties)。
- 交互规格:定义手势行为(swipe、drag、pinch)。
- 交互规格:定义键盘交互(tab order、shortcuts)。
- 内容规格:定义字符限制和截断行为。
- 内容规格:定义动态内容规则(什么会变化、min/max)。
- 内容规格:说明本地化考虑(text expansion、RTL)。
- 内容规格:提供空、加载和错误状态内容。
- 资产交付:交付图标(SVG,按约定命名)。
- 资产交付:交付图像(分辨率、format、响应式变体)。
- 资产交付:交付字体(文件或 service links)。
- 资产交付:交付任何自定义插图或图形。
- 边界情况:覆盖最小和最大内容场景。
- 边界情况:说明每个断点下的响应行为。
- 边界情况:说明浏览器/设备特定考虑。
- 边界情况:说明无障碍要求(ARIA、键盘、screen reader)。
- 实现说明:给出组件复用建议。
- 实现说明:说明数据结构假设。
- 实现说明:说明 API 依赖。
- 实现说明:说明性能考虑。
- 最佳实践:使用 design tokens,而不是 raw values。
- 最佳实践:标注行为,而不仅是外观。
- 最佳实践:包含所有状态,而不仅是 happy path。
- 最佳实践:为复杂布局提供 redlines。
- 最佳实践:与开发者走查 handoff。
适用边界 · 注意事项
- 当目标是验证实现结果时,不要用本技能,改用 design-qa-checklist。
- 当需要定义可复用库组件时,不要用本技能,改用 component-spec (design-systems)。
- 设计尚未确定或缺少必要规格与资产时,不要开始交接。