前言¶
做 iOS 界面时，设计稿在 Figma，实现往往在 Xcode。常见做法是手动导出 PNG、按 @2x/@3x 命名再拖进 .xcassets，或者让 AI 根据链接「照着画」——后者容易变成近似形状、叠图层或默认 SF Symbols，和稿面不一致。下面介绍一个面向这条链路的 Agent Skill：在用户给出 Figma 链接时，走官方 Images API 拉真实节点位图，并按 iOS 资源习惯落盘。
这是什么¶
figma-ios-asset-export 是 SkillHub 社区 Skill（坐标 @user_104630ff/figma-ios-asset-export，当前版本 1.0.3，分类 design-media）。发布者为 user_104630ff，来源标注为 community。
一句话定位：通过 Figma REST images API 导出设计节点，生成 iOS 可直接使用的资源；默认写入 Xcode .xcassets，格式以 @2x / @3x PNG 为主。Skill 说明中强调：除非用户明确同意，不要用手绘图层、近似图形或 SF Symbols 替代稿面视觉。
SkillHub 页面标注 requires_api_key=true，使用前需准备 Figma API 访问能力（具体密钥配置方式以 Skill 安装后的 SKILL.md 及 Figma 官方文档为准）。
核心功能¶
以下能力均来自官方简介，未额外扩展：
- 真实节点导出：针对用户提供的 Figma 链接中的设计节点，调用 Figma REST images 接口获取位图，而不是在代码里「复刻」外观。
- iOS 默认规格：默认下载 @2x、@3x PNG，并放入
.xcassets结构，便于在 Xcode 中直接引用。 - 矢量可选：仅在用户明确要求时使用 PDF 等矢量导出路径；默认不转向矢量。
- 触发范围：适用于 iOS 整屏、UI 实现、视觉走查、设计还原，以及图标、插画、Logo、空状态、Banner、背景等自定义视觉资源。
- 替代策略约束：Skill 设计意图是避免在未获用户许可时，用自建图层、近似形状或 SF Symbols 顶替 Figma 稿面。
安装与启用¶
在 SkillHub 上，安装方式是通过 AI 助手按统一说明拉取 Skill。将下面提示词发给已支持 SkillHub 安装的客户端（如 Cursor、兼容 SkillHub 规范的 Codex CLI / Claude Code 等），并按返回指引完成配置；各客户端细节以 https://skillhub.cn/install/skillhub.md 为准。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_104630ff/figma-ios-asset-export`。
安装完成后，在对应工具的 Skills 目录中应能看到该 Skill 的 SKILL.md。因标签 requires_api_key=true，启用前请按 Skill 内说明配置 Figma API Key（及工具要求的环境变量或密钥存储方式）。
API 元数据地址（供工具解析 Skill 包）：
https://api.skillhub.cn/user_104630ff/figma-ios-asset-export
Skill 展示页：
https://www.skillhub.cn/skills/user_104630ff/figma-ios-asset-export
典型用法¶
官方资料未给出固定 CLI 命令行示例；典型交互是在对话中提供 Figma 链接与实现意图，由 Agent 按 Skill 规则执行导出与落盘。可复现的用法模式如下。
- 安装并配置 API Key（见上一节）。
- 在任务中附上 Figma 链接，并说明目标，例如：「把这个节点的图标导出到当前工程的
Assets.xcassets」「按 @2x/@3x PNG 做 iOS 切图」。 - 需要矢量时单独说明，例如：「这次用 PDF 矢量进 xcassets」；未说明时 Skill 默认走 PNG 倍图。
- 若允许用系统符号或简化图形替代，需在对话里明确批准；否则 Skill 会倾向于坚持从 Figma 导出真实资源。
经过上面的步骤，Agent 应调用 Figma images API 下载节点图像，并按 iOS 资源命名与目录习惯写入工程，而不是仅用 SwiftUI/UIKit 代码近似稿面。
适用场景与注意¶
适合谁
- 负责 iOS UI 实现、设计还原或视觉走查的开发者。
- 希望 Agent 直接处理 Figma 链接、减少手工导出与命名工作的团队。
限制与注意
- 依赖 Figma API：需有效 API Key；大文件、权限或节点不可导出时，以 Figma 接口与账号权限为准。
- 默认 PNG 倍图：与「单 PDF 矢量一套」的工作流不同；若团队规范是 PDF，要在需求里写清楚。
- 社区 Skill：版本 1.0.3，行为以安装的
SKILL.md为准；SkillHub 统计（截至页面展示）评分 100000、下载 655 次，仅作发现参考，不代表质量背书。 - 不替代设计决策：Skill 约束的是「不要用代码瞎画顶替稿面」，切图命名、Dark Mode、App Icon 规范等仍须结合项目约定。
结尾¶
figma-ios-asset-export 把「Figma 链接 → Figma REST images API → @2x/@3x PNG → .xcassets」写进 Agent 工作流，并默认抵制未经同意的视觉替代。若你的 iOS 任务经常从 Figma 链接触发，可按 SkillHub 说明安装 @user_104630ff/figma-ios-asset-export，并提前准备好 API Key。
- SkillHub 页面：https://www.skillhub.cn/skills/user_104630ff/figma-ios-asset-export
- API 地址：https://api.skillhub.cn/user_104630ff/figma-ios-asset-export
