业务页 Agent 有规矩了，加 Pod、开 H5、发 TF 还在瞎写？我补了 11 条 Skill前两篇讲过 ios-

v0.2 把「页面长什么样、字段叫什么、旧版有没有多弹窗」管住了。
实际开发里还有一类更隐蔽的翻车：工程接入和混合页——Agent 为了「跑通」会乱来。

常见场景：

项目全是 CocoaPods，它给你加 SPM，还 invent 一个版本号
每做一个 H5 入口就新建一套 WKWebView VC，token 拼接跟邻页不一样
上传接口字段名自己编 file / image，跟后台对不上
发 TestFlight 漏 dSYM，ATT 在冷启动弹还加一层「为了更好的体验」教育弹窗

v0.3.0 新增 11 个 Skill，专门管这些。Skill 总数 37 → 48。

GitHub：github.com/mapleleaf99…
更新说明：RELEASE_NOTES v0.3.0

v0.3 分三块

1. 工程接入（4 个）

Skill	管什么
`ios-cocoapods-spm`	只走项目现有 Pod 或 SPM，不混用、不猜版本
`ios-image-loading`	SDWebImage/Kingfisher/封装 — 占位、圆角、reuse 取消跟邻页
`ios-upload-multipart`	走现有 OSS/上传层，multipart 字段名精确
`ios-plist-capabilities`	Plist + Capabilities 对齐邻功能，不编用途说明

2. 混合 H5（3 个）

Skill	管什么
`ios-wkwebview`	现有 WebView 容器，URL/token/返回栈 — 不新建第二套
`ios-webview-bridge`	H5↔Native message 名、JSON 键精确（跟 Flutter 桥一样严）
`ios-share-export`	系统分享 / 保存相册，权限跟旧版，不多弹窗

3. 发版与质量（4 个）

Skill	管什么
`ios-privacy-manifest`	PrivacyInfo / Required Reason — 跟邻 target，不编 reason
`ios-att-tracking`	ATT 时机对齐旧版，系统弹窗前不加额外 Alert
`ios-release-checklist`	Archive / TF / dSYM 清单（流程向，不写 secrets）
`ios-uitest-smoke`	XCUITest 冒烟跟现有测试风格，不引新框架

和 v0.2 怎么配合

v0.2 管「页面 + 数据 + 设计」；v0.3 管「接工程 + 开 H5 + 能发版」。

典型组合：

用 ios-wkwebview + ios-webview-bridge + ios-legacy-parity + no-speculation-dev。
打开这个 H5 活动页跟 ActivityWebVC 一致。
JS 桥 message 名：（粘贴）不要新建 WebView 栈。

用 ios-upload-multipart + ios-network-request + no-speculation-dev。
上传截图跟 AvatarUpload 一致。
presign API + multipart 字段：（粘贴）

用 ios-release-checklist。
3.2.0 build 420 发 TestFlight，查 fastlane/CI，注明 dSYM 步骤。

更多组合见 PROMPT_COOKBOOK 中文。

安装

全量更新：

cd ios-agent-skills && git pull && ./install.sh

只装 v0.3 新增的 11 个：

./install.sh --only ios-cocoapods-spm,ios-image-loading,ios-upload-multipart,ios-plist-capabilities,ios-wkwebview,ios-webview-bridge,ios-share-export,ios-privacy-manifest,ios-att-tracking,ios-release-checklist,ios-uitest-smoke

装完新开 Agent 对话。
自检：./verify-install.sh --dir "$HOME/.cursor/skills"

没装 Skill 时 vs 装了

没约束，Agent 常：

# Podfile — 项目全是 Pods，它加了 SPM
# 或 invent 版本
pod 'SomeLib', '9.9.9'

// 新 WebView VC，token 参数名跟邻页不一样
url += "?access_token=\(token)"

有 Skill，应变成：

先搜邻页 Podfile 条目 / WebView VC / 上传封装 → 复制模式 → 缺 contract 就问

（Skill 管行为，不替你们写公司类名。）

使用注意（短）

正文里 点名 Skill：用 ios-wkwebview 比指望自动触发稳
改 Podfile 后记得本地 pod install — Skill 会提醒你，不会替你跑
H5 桥如果只改 Native，Skill 会列出 H5 待改项
发版清单不写证书密码；敏感信息别贴进对话

业务页 Agent 有规矩了，加 Pod、开 H5、发 TF 还在瞎写？我补了 11 条 Skill