最近把一套自己在做企业级 iOS 依赖治理时反复用到的方法论和资料整理成了一个开源项目：iOS Migration Expert。
很多 CocoaPods → Swift Package Manager 的文章，更多是在讲“怎么接入 SPM”，但真实项目里更难的部分往往不是接入本身，而是迁移之后一堆隐性问题：
- 某些 pod 虽然有 SPM，但 package/product 名不一致
- CocoaPods 注入过的
xcconfig、search paths、OTHER_LDFLAGS遗留在项目里 - 混编项目里 Objective-C import、module map、bridging 断掉
- 资源加载方式变化
- binary SDK 不能直接平移
- CI 仍然依赖
pod install - 不是所有依赖都能一口气迁走，必须分阶段或 hybrid
所以这个项目的重点，不是“生成一个新的依赖声明文件”，而是提供一套可以复用的迁移知识框架：
SKILL.md：给 AI agent 的主入口mappings/：CocoaPods → SPM mapping 数据docs/：迁移中的关键专题templates/：不同迁移形态的模板checklists/：迁移前 / 完成后 / rollback 校验examples/：典型项目场景scripts/：审计辅助脚本
如果你正在做：
- iOS 旧项目治理
- CocoaPods 退场
- SPM 迁移评估
- AI 辅助工程化
欢迎看看，也欢迎补充 mapping、案例和 edge cases。
仓库地址：
https://github.com/changjiashuai/ios-migration-expert
