1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | objc-ios-maintenance |
| 作者/维护者 | sun6762(个人开发者,另有 1 位协作者参与提交) |
| 来源链接 | https://github.com/sun6762/objc-ios-maintenance |
| 许可证 | MIT |
| GitHub Stars | 97(GitHub API,2026-07-30) |
| Forks | 8(GitHub API,2026-07-30) |
| 最新版本 | 未标注版本号,仓库未打 Release 标签 |
| 安装方式 | git clone 到 Codex 或 Claude Code 的 skills 目录 |
2. 功能介绍与亮点
objc-ios-maintenance 是一个专门服务“老项目”的 Agent Skill:面向仍在维护的 Objective-C + UIKit 代码库,覆盖内存与所有权(ARC、strong/weak/copy、block 循环引用)、崩溃治理(符号化、dSYM/MetricKit、OOM/Jetsam/watchdog)、UIKit 性能(离屏渲染、cell 复用、滚动掉帧)、Swift 混编边界、构建系统与依赖(CocoaPods/SPM 混用、-ObjC/-force_load、静态库符号裁剪)、废弃 API 与合规适配(UIWebView→WKWebView、隐私清单、Required Reason API)、数据持久化安全(Keychain、Core Data/SQLite 线程安全)、推送与后台生命周期等十余个老项目高发问题域。
亮点在于工程化程度:仓库内 27 篇 references/ 专题文档逐一展开每个问题域的具体判断标准与常见错误清单,scripts/scan_objc_risks.py 附带独立测试文件,evals/evals.json 提供结构化验收用例,assets/templates/ 为新手准备了保守的 UIKit 分层模板——这种“总入口 SKILL.md + 多篇 references + 可测试脚本 + 验收用例”的组织方式在同类个人维护技能中较为少见。
3. 适用场景
固定分类:工程效率与代码质量
- 维护仍在服役的老 Objective-C iOS 项目,审查
.h/.m/.mm中的内存、线程、崩溃与性能风险 - 治理 Xcode 工程、CocoaPods/SPM 混用、闭源静态库到 xcframework 迁移等构建配置问题
- 排查 App Store 审核相关的废弃 API、隐私清单、权限体系适配
- 为无测试覆盖的老代码补充特征测试(characterization test)安全网,再做重构
- Objective-C 与 Swift 混编边界的排查与新手安全层代码生成
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 提供个人 skill(
~/.claude/skills/)与项目共享(git submodule到.claude/skills/)两种明确安装路径,并给出/objc-ios-maintenance调用示例 - Codex:✅ 原生支持——README 提供
${CODEX_HOME}/skills安装步骤,仓库另附agents/openai.yaml供 Codex UI 展示 - OpenClaw:❓ 未验证——已抓取材料未提及
- Hermes Agent:❓ 未验证——已抓取材料未提及
5. 推荐理由
Objective-C + UIKit 遗留项目仍大量存在于电商、金融、出行等长生命周期 App 中,但社区里新出现的 Agent Skill 几乎清一色转向 Swift/SwiftUI,专门服务这类老项目维护的技能供给稀缺。这个技能不是泛泛的“代码审查”提示词,而是把内存所有权、崩溃分类、构建依赖、合规适配等老 iOS 工程师日常踩坑的问题域逐一拆解为可执行的检查清单,并配了可独立运行的诊断脚本与验收用例,对仍在维护 OC 老项目、又想借助 Agent 提效的团队有直接可用的价值。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | 97 stars、8 forks;fork 时间分散在创建后一周内,无集中刷量迹象;但目前 0 个 issue/PR,暂无第三方讨论或独立贡献者证据 |
| 可用性 | 9 | SKILL.md + 27 篇 references + 可测试诊断脚本 + 验收用例 + 新手模板结构完整;Codex 与 Claude Code 均有明确安装步骤;2026-07-26 仍有提交维护;零付费依赖 |
| 安全性 | 9 | 诊断脚本 scan_objc_risks.py 为纯正则文本扫描,无 subprocess/网络请求/eval;不索取任何 API Key 或凭据;建议做法本身倡导敏感数据入 Keychain;License 明确;未见可疑指令或混淆代码 |
安全检查清单逐项结果: ① Shell 命令与权限范围——技能本身不执行 shell 命令,诊断脚本仅本地文件文本扫描;② 联网外发——无任何网络调用;③ API Key/凭据——无依赖,且指导用户把敏感数据存入 Keychain 而非明文;④ 可疑指令——通读 SKILL.md 全文与脚本源码未发现 prompt injection 或隐蔽外发迹象;⑤ 作者信誉——账号自 2016 年活跃,无刷星/SEO 操纵措辞;⑥ License——MIT,明确;⑦ 最近维护——2026-07-26 有提交,处于活跃期。
综合评分(三项均值):7.33
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| xcode-build-optimization-agent-skill(avdlee) | Xcode 构建速度优化 | 只聚焦构建耗时问题,不覆盖内存/崩溃/合规等运行时与审核问题 |
| swift-concurrency-agent-skill / swiftui-agent-skill(avdlee) | 现代 Swift 并发与 SwiftUI 开发 | 服务对象是新写的 Swift 代码,不处理 Objective-C 遗留代码库 |
| twostraws/swift-agent-skills | Swift/Apple 平台技能的社区目录站 | 是一份索引/导航资源而非单个技能,收录对象以 Swift 生态为主 |
社区里同类 Apple 平台技能普遍围绕 Swift/SwiftUI 展开,objc-ios-maintenance 是目前少见的专门服务 Objective-C 遗留代码维护的技能,与上述 Swift 向工具形成互补而非直接竞争。
8. 用户评价
该技能目前在第三方平台及社交媒体尚无独立用户评价。
9. 其他补充
仓库全部文档(README、SKILL.md、references)均以中文撰写,未提供英文版本。
10. 安装使用方式
Codex:
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/sun6762/objc-ios-maintenance.git "${CODEX_HOME:-$HOME/.codex}/skills/objc-ios-maintenance"
在 Codex 中可通过 $objc-ios-maintenance 显式调用,也可以让 Codex 根据任务描述自动选择。
Claude Code(个人 skill):
mkdir -p ~/.claude/skills
git clone https://github.com/sun6762/objc-ios-maintenance.git ~/.claude/skills/objc-ios-maintenance
Claude Code(项目共享,团队协作推荐):
mkdir -p .claude/skills
git submodule add https://github.com/sun6762/objc-ios-maintenance.git .claude/skills/objc-ios-maintenance
安装后无需重启,直接在对话中描述 Objective-C 相关任务,或用 /objc-ios-maintenance(Claude Code)/ $objc-ios-maintenance(Codex)显式调用即可触发。
11. 注意事项
- 仓库创建仅 11 天,尚处早期阶段,单一主要作者维护,长期更新节奏有待观察
- 未标注版本号、无 Release 记录,功能变动缺乏可追溯的版本历史
scan_objc_risks.py只做规则匹配式提示,命中结果仍需人工结合调用上下文判断,不能替代 clang static analyzer、Infer 等真实静态分析工具- OpenClaw、Hermes Agent 的兼容性暂无材料可验证,如需在这两个生态使用建议先自行测试