菜单
Map iconfont nodes from design.json[node].iconfont into Swift via .cursor/bindings/iconfont_map.json. Hit → emit mapped font/text snippets; miss → fallback + TODO. Use when generating icon/button code from iconfont nodes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Entry point for Figma → iOS UIKit/Swift code in this repo. Three-phase workflow: phase 1 runs figma-ios-preload-data to produce a unified data package; phase 2 (this playbook) consumes it via linked specialized skills (MK tokens, iOS 12, node conventions, SnapKit layout) to emit **baseline UI code** — visual/layout fidelity at 100%, data is mock, business logic stubbed behind `// TODO(阶段3): ...` markers. Phase 3 (PRD + API-doc rewrite into production code) is OUT OF SCOPE. Use when generating or refactoring Figma-based iOS UI, Figma to Swift, codegen, or when the user asks which skill applies.
从 Figma 节点自动识别选择交互模式（单选/多选/Toggle），生成选中态变化逻辑（更新数据模型 + 刷新 UI）， 集成 RxSwift 交互模式。Use when generating selection interaction code, or when user mentions 选中态交互、单选、多选、didSelectItem、Toggle。
Apply Figma comments that are pre-matched to nodes by figma-ios-preload-data. Read confidence + parsed tags from comments.json. Iconfont corrections are already written into design.json; color comments stay in comments.json for Phase-2 mapping. Use when generating code from Figma with designer comments.
从 figma-ios-preload-data 数据包（design.json）提取组件各状态的视觉特征（背景色、边框、文字颜色、字体）， 生成带 updateAppearance() 的状态切换代码。 Use when extracting visual states from Figma components, generating selected/unselected/disabled state code, or when user asks about 选中态、状态切换、updateAppearance。
Map Figma colors and fonts from the data package into Swift via configurable JSON maps under .cursor/bindings/. Hit → emit mapped code snippet; miss → UIKit fallback. Use when generating color or font code from design.json.
Reference iOS image assets that figma-ios-preload-data pre-downloaded into the data package. Covers two cases: (1) local imagesets (copy + UIImage(named:)), and (2) server-side images (avatars / covers / category icons / any RECTANGLE filled with IMAGE that has no local imageset) — these MUST use the data package's mock.default_image_url via sd_setImage, never fabricated asset names. Use when wiring any UIImage reference or generating mock data for image fields.
| name | figma-ios-iconfont-mapping |
| description | Map iconfont nodes from design.json[node].iconfont into Swift via .cursor/bindings/iconfont_map.json. Hit → emit mapped font/text snippets; miss → fallback + TODO. Use when generating icon/button code from iconfont nodes. |
权威配置：
.cursor/bindings/iconfont_map.json
示例包（MK）：.cursor/bindings/examples/mk/iconfont_map.json
颜色仍走 figma-ios-design-token-mapping（查color_map.json）。
本 skill 不写死宿主 iconfont 类名；调用约定只活在iconfont_map.json里。
design.json[node].iconfont.symbol
→ 查 bindings/iconfont_map.json 的 map
→ 命中：用 map 里的 font / text（可替换 {size}）
→ 未命中：用 fallback + TODO 注释（禁止臆造 OC 属性名）
figma-ios-preload-data 已识别 iconfont 并写入 design.json[node_id].iconfont：
{
"symbol": "icon_query_24",
"size_hint": 24,
"color": "rgba(255,255,255,1)",
"rotation": 90.0,
"source": "comment"
}
| 字段 | 用法 |
|---|---|
symbol | 查表 key（已含评论修正） |
size_hint | 替换 map/fallback 里的 {size}；缺失则用 min(frame.w, frame.h) |
color | 走 color_map（见颜色 skill） |
rotation | 有且 |deg|≥1 时加 transform；评论要求不旋转则忽略 |
若数据包仍带旧字段
lib_hint/objc_property/font_call：忽略。阶段 1 已不再写入；生成以iconfont_map.json为准。
source：explicit / implicit / comment（阶段 1 已处理评论覆盖，阶段 2 直接用 symbol）。
_role.is_iconfont_library == true（如 iconfont_24）自身不渲染，跳过。
.cursor/bindings/iconfont_map.jsoniconfont.symbol 查 maplabel.font = <map.font> // 替换 {size}
label.text = <map.text>
label.textColor = <color_map 查 iconfont.color 的结果>
fallback.comment（替换 {symbol}），再用 fallback.font / fallback.text；禁止编造 MKIconFont.shared().mk_xxx{
"schema_version": "1.0.0",
"fallback": {
"font": "UIFont.systemFont(ofSize: {size})",
"text": "\"?\"",
"comment": "// TODO(阶段2): iconfont `{symbol}` 未在 iconfont_map.json 命中"
},
"map": {
"icon_query_24": {
"font": "MKIconFont.iconFont(withSize: 24)",
"text": "MKIconFont.shared().mk_icon_query_24"
},
"icon_next_12": {
"font": "MKIconFont.iconFont(withSize: {size})",
"text": "MKIconFont.shared().mk_icon_next_12"
}
}
}
map 为空 = 全部走 fallback（个人开发者）。
接入宿主 iconfont：从 examples/mk/iconfont_map.json 复制后改，或按「一个 symbol → font/text 两段代码」自建。详见 bindings/README。
// 仅当 iconfont.rotation 存在且评论未禁止旋转
icon.transform = CGAffineTransform(rotationAngle: CGFloat(rotation) * .pi / 180)
评论含「不要旋转 / 保持原始方向」且 confidence>=medium → 忽略 rotation。
命中 map 后：
// Figma node: I1:407;2:7337 iconfont/icon_query_24
let queryIcon = UILabel()
queryIcon.font = MKIconFont.iconFont(withSize: 24) // map.font
queryIcon.text = MKIconFont.shared().mk_icon_query_24 // map.text
queryIcon.textColor = /* color_map 查 iconfont.color；未命中则 UIColor fallback */
按钮同理：titleLabel?.font + setTitle(_:for:) 使用同一对 font/text。
未命中：
// TODO(阶段2): iconfont `icon_unknown_24` 未在 iconfont_map.json 命中
let icon = UILabel()
icon.font = UIFont.systemFont(ofSize: 24)
icon.text = "?"
design.json[node].iconfonticonfont_library 已跳过iconfont_map.json