figma-ios-uicollectionview-codegen

UICollectionView 代码生成

⚡ QUICK_REF（Agent 优先读此处）

核心定位：本 SKILL 提供"流程框架 + 指导原则 + 强制约束"，具体如何分析和生成代码由大模型根据实际场景判断。

本 skill 的定位：阶段 2 基础 UI 代码生成（UI + 临时模型 + Mock 数据 + 交互骨架），阶段 3 会用 PRD + 接口文档把 mock 换成真实接口、临时模型换成 API 模型，本 skill 不管阶段 3。

核心流程（6 步）：

1. 分析 Cell 结构 → 遍历所有子节点，识别布局和元素
2. 推断临时模型字段 → 根据语义推断阶段 2 临时 struct（阶段 3 会用真实 API 模型替换）
3. 生成 Mock 数据 → 阶段 2 强制（图片走 manifest.json.mock.default_image_url，其他字段语义生成）
4. 生成 CollectionView → lazy var + layout + DataSource
5. 生成 Cell 代码 → 子视图 + 布局（SnapKit）+ configure 方法
6. 生成交互逻辑 → didSelectItemAt（有选中态 → toggle；无 → print + // TODO(阶段3): 补业务跳转/网络请求）

---

生成内容清单

组件	说明	必须
Model 定义	根据子元素推断字段	✅
Mock 数据	从 Figma 提取或生成占位	✅
CollectionView	lazy var + layout 配置	✅
Cell 定义	configure(item:) 方法	✅
DataSource	numberOfItemsInSection + cellForItemAt	✅
Delegate	didSelectItemAt 交互逻辑	✅
LeftAlignedFlowLayout	标签集合专用（可选）	⚠️

---

强制约束（质量保证）

✅ 必须遵守:

• 模型必须包含 id 字段
• 必须使用 Model，禁止字符串数组
• 颜色/字体走 bindings map（未命中用 UIKit fallback）
• 布局按 host.layout_engine（默认相对约束；可用 SnapKit 或原生 Auto Layout）
• 交互逻辑：有 isSelected → toggle + reload；无 → print
• 访问级别匹配：DataSource / Delegate 的 extension 访问级别必须等于宿主类。详见下方「访问级别匹配规则」。

❌ 严格禁止:

• 禁止跳过流程步骤
• 禁止硬编码数据（必须从 Figma 提取或根据语义生成）
• 禁止同时使用 estimatedItemSize 和 sizeForItemAt
• 禁止生成不完整的代码
• 禁止 public class 配 extension（默认 internal）的搭配 —— 必报「Method must be declared public」编译错误。

---

访问级别匹配规则（强制，避免协议一致性报错）

报错形态（这是本规则要根除的）：

Method 'collectionView(_:numberOfItemsInSection:)' must be declared public
because it matches a requirement in public protocol 'UICollectionViewDataSource'

原因：public 类实现 public 协议，方法访问级别必须 ≥ public，但 extension 默认是 internal。

---

另一常见报错（同文件内独立 UICollectionViewCell 子类 + configure(item:)）：

Method must be declared fileprivate because its parameter uses a private type

原因：数据模型写成 private struct FooItem，而 Cell 的 func configure(item: FooItem) 默认为 internal。方法的可见性不能高于签名中出现的类型——private 类型只能出现在 private / fileprivate 成员签名里。