Agent Skill 编码与开发

设计文档生成器

Figma插件,可提取本地样式指南并生成DESIGN.md和SKILL.md文件,适用于Claude Code、Codex、Cursor等AI工具

查看 GitHub 仓库 ↗ ⭐ 142 Stars

📌 Skill基础信息

Skill名称:design-md-figma

简称:设计文档生成器

来源:社区第三方 (bergside)

运行宿主:Claude Code、Codex、Cursor 等基于 AI 的编程辅助工具

核心定位:通过提取 Figma 设计稿中的本地样式指南,自动生成 DESIGN.md 和 SKILL.md 文件,为 AI 编程工具提供设计规范上下文。

🧩 内部核心组成

该 Skill 主要包含以下核心组件:

核心能力模块

  • Figma 插件接口:连接 Figma 设计工具,提取样式数据
  • 文档生成引擎:将设计规范转换为标准化 Markdown 格式
  • 样式解析器:解析颜色、字体、间距等设计系统元素

输出文件

  • DESIGN.md:完整的设计规范文档
  • SKILL.md:AI 工具专用的技能描述文档

🛠 安装与启用方式

安装命令

skills install --user bergside/design-md-figma

前置要求

  • 需要安装并配置 Figma 桌面应用或 Figma Web
  • 需要有效的 Figma 账号和访问权限
  • 支持 Figma 插件运行环境

启动方式

  1. 在 Figma 中打开设计文件
  2. 通过插件菜单启动 design-md-figma
  3. 选择需要提取样式的画板或组件
  4. 执行生成操作

📋 标准工作流

  1. 设计稿准备:用户在 Figma 中完成界面设计并定义设计系统
  2. 插件启动:通过 Figma 插件面板启动 design-md-figma
  3. 样式提取:插件自动扫描并提取颜色、字体、间距等设计标记
  4. 文档生成:将提取的设计规范转换为结构化的 Markdown 文档
  5. 文件输出:生成 DESIGN.md 和 SKILL.md 文件到指定目录
  6. AI 工具集成:将生成的文档提供给 Claude、Cursor 等 AI 编程助手使用

⚠️ 关键限制与注意事项

平台限制

  • 仅支持 Figma 设计平台,不支持 Sketch、Adobe XD 等其他设计工具
  • 需要 Figma Pro 账号才能访问某些高级功能

技术限制

  • 依赖 Figma API 的稳定性和访问权限
  • 复杂组件嵌套可能无法完全解析
  • 自定义设计系统需要严格遵循命名规范

生产环境适用性

  • 适合中小型项目的设计规范文档生成
  • 大型企业级设计系统可能需要额外定制
  • 建议在重要项目中使用前进行充分测试

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

  • 需要为 AI 编程工具提供设计上下文的开发团队
  • 希望自动化设计文档生成的设计系统项目
  • 追求设计与开发协作效率的敏捷团队
  • 使用 Figma 作为主要设计工具的产品团队

❌ 不适合场景

  • 使用非 Figma 设计工具的项目团队
  • 极度复杂或非标准的设计系统结构
  • 需要高度定制化文档格式的特殊需求
  • 对设计规范保密性要求极高的军事或金融项目

如何安装

skills install --user bergside/design-md-figma

通用安装教程:在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:

  1. 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
  2. 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
  3. 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
  4. 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)

桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。

Claude Code(终端 CLI)

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。

VS Code(含 GitHub Copilot)

打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。

Windsurf

底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。

其他工具(ChatGPT、本地脚本等)

不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。

风险提示

✅ 低风险

自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。

相似 Skill 推荐

ECC 智能体系统
affaan-m/ECC
低风险

这是一个智能体性能优化系统,为Claude Code、Codex、Opencode、Cursor等提供技能、直觉、记忆、安全性和以研究为先的开发能力。

cc-switch 全能助手
farion1231/cc-switch
低风险

一款跨平台的桌面全能助手,适用于 Claude Code、Codex、OpenCode、OpenClaw、Grok Build 和 Hermes Agent。唯一官方网站:ccswitch.io

Ruflo
ruvnet/ruflo
低风险

Ruflo是一个多智能体编排平台,专为AI编码代理(如Claude Code、Cursor、Codex、Copilot、Gemini、Amp等12个以上)设计。当用户需要以下操作时使用此技能:(1)在项目中安装/初始化R

营销技能
coreyhaines31/marketingskills
低风险

为Claude Code和AI代理提供的营销技能,涵盖转化率优化(CRO)、文案撰写、搜索引擎优化(SEO)、数据分析和增长工程。