Communitygithub.com

设计交接文档生成

从设计稿生成全面的开发者交接文档。适用于设计就绪、需要交付工程团队的场景,涵盖布局、设计令牌、组件属性、交互状态、响应式断点、边界情况和动画细节。

设计交接文档生成 是什么?

此技能用于自动生成详细的设计交接文档,帮助设计师与开发团队之间实现无缝协作。它能够从 Figma 设计稿(或文本/截图)中提取关键信息,输出结构化的 Markdown 规范文档,覆盖布局测量、设计令牌引用、组件变体与状态、交互行为、响应式断点、边界情况处理以及无障碍要求。技能遵循“不假设”、“使用令牌而非固定值”、“展示所有状态”和“解释设计原因”四项原则,确保开发者获得完整且可执行的实现指南。支持连接 Figma 以自动拉取精确尺寸和令牌,也可集成项目管理工具创建任务清单。适用于任何需要将设计交付给开发者的场景,尤其是使用组件化框架(如 React + Tailwind)的项目。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/plugins/anthropic-design/skills/design-handoff

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

/design-handoff

如果遇到不熟悉的占位符或需要检查已连接的工具,请参阅 CONNECTORS.md。

从设计稿生成全面的开发者交接文档。

使用方法

/design-handoff $ARGUMENTS

为 @$1 生成交接规范。

如果提供了 Figma 链接,则从 Figma 拉取设计。否则,根据提供的描述或截图开展工作。

应包含的内容

视觉规范

  • 精确尺寸(内边距、外边距、宽度)
  • 设计令牌引用(颜色、字体、间距)
  • 响应式断点及行为
  • 组件变体与状态

交互规范

  • 点击/触摸行为
  • 悬停状态
  • 过渡与动画(时长、缓动函数)
  • 手势支持(滑动、捏合、长按)

内容规范

  • 字符限制
  • 截断行为
  • 空状态
  • 加载状态
  • 错误状态

边界情况

  • 最小/最大内容
  • 国际化文本(较长字符串)
  • 慢速连接
  • 数据缺失

无障碍

  • 焦点顺序
  • ARIA 标签与角色
  • 键盘交互
  • 屏幕阅读器播报

原则

  1. 不要猜测 — 如果未指定,开发者就会自行猜测。请明确每一项。
  2. 使用令牌,而非值 — 引用 spacing-md 而不是 16px。
  3. 展示所有状态 — 默认、悬停、激活、禁用、加载、错误、空。
  4. 解释原因 — “该部分在移动端折叠,因为用户通常单手操作”有助于开发者做出合理判断。

输出

## 交接规范:[功能/屏幕名称]

### 概述
[此屏幕/功能的作用,用户上下文]

### 布局
[网格系统、断点、响应式行为]

### 使用的设计令牌
| 令牌 | 值 | 用途 |
|------|------|------|
| `color-primary` | #[hex] | 主要按钮、链接 |
| `spacing-md` | [X]px | 段落间距 |
| `font-heading-lg` | [字号/字重/字族] | 页面标题 |

### 组件
| 组件 | 变体 | 属性 | 备注 |
|------|------|------|------|
| [组件] | [变体] | [属性] | [特殊行为] |

### 状态与交互
| 元素 | 状态 | 行为 |
|------|------|------|
| [CTA 按钮] | 悬停 | [背景变暗 10%] |
| [CTA 按钮] | 加载 | [显示加载动画,按钮禁用] |
| [表单] | 错误 | [红色边框,错误信息] |

### 响应式行为
| 断点 | 变化 |
|------|------|
| 桌面端 (>1024px) | [默认布局] |
| 平板 (768-1024px) | [变化内容] |
| 手机端 (<768px) | [变化内容] |

### 边界情况
- **空状态**:[无数据时显示的内容]
- **长文本**:[截断规则]
- **加载中**:[骨架屏或加载动画]
- **错误**:[错误状态外观]

### 动画/动效
| 元素 | 触发条件 | 动画 | 时长 | 缓动函数 |
|------|----------|------|------|----------|
| [元素] | [触发条件] | [描述] | [ms] | [缓动函数] |

### 无障碍备注
- [焦点顺序]
- [需要的 ARIA 标签]
- [键盘交互]

如果连接了工具

如果已连接 ~~设计工具:

  • 从 Figma 拉取精确尺寸、令牌和组件规范
  • 导出资源并生成完整的规范表

如果已连接 ~~项目管理工具:

  • 将交接文档链接到实现工单
  • 为规范中的每个章节创建子任务

提示

  1. 提供 Figma 链接 — 我可以拉取精确的尺寸、令牌和组件信息。
  2. 提及边界情况 — “100 个项目时会发生什么?”有助于我制定边界条件规范。
  3. 指定技术栈 — “我们使用 React + Tailwind”有助于我给出相关的实现备注。

Individual skills in this repo

This repo contains 15 individual skills — each has its own dedicated page.

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

相关技能