📌 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 插件运行环境
启动方式:
- 在 Figma 中打开设计文件
- 通过插件菜单启动 design-md-figma
- 选择需要提取样式的画板或组件
- 执行生成操作
📋 标准工作流
- 设计稿准备:用户在 Figma 中完成界面设计并定义设计系统
- 插件启动:通过 Figma 插件面板启动 design-md-figma
- 样式提取:插件自动扫描并提取颜色、字体、间距等设计标记
- 文档生成:将提取的设计规范转换为结构化的 Markdown 文档
- 文件输出:生成 DESIGN.md 和 SKILL.md 文件到指定目录
- AI 工具集成:将生成的文档提供给 Claude、Cursor 等 AI 编程助手使用
⚠️ 关键限制与注意事项
平台限制:
- 仅支持 Figma 设计平台,不支持 Sketch、Adobe XD 等其他设计工具
- 需要 Figma Pro 账号才能访问某些高级功能
技术限制:
- 依赖 Figma API 的稳定性和访问权限
- 复杂组件嵌套可能无法完全解析
- 自定义设计系统需要严格遵循命名规范
生产环境适用性:
- 适合中小型项目的设计规范文档生成
- 大型企业级设计系统可能需要额外定制
- 建议在重要项目中使用前进行充分测试
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景:
- 需要为 AI 编程工具提供设计上下文的开发团队
- 希望自动化设计文档生成的设计系统项目
- 追求设计与开发协作效率的敏捷团队
- 使用 Figma 作为主要设计工具的产品团队
❌ 不适合场景:
- 使用非 Figma 设计工具的项目团队
- 极度复杂或非标准的设计系统结构
- 需要高度定制化文档格式的特殊需求
- 对设计规范保密性要求极高的军事或金融项目
如何安装
skills install --user bergside/design-md-figma通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 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 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com