核心用法
该 Skill 是一套面向 iOS 平台层的诊断与决策指南系统，而非代码生成工具。其核心用法遵循"五层定位法"：将任何 iOS 缺陷归类到生命周期、entitlement、权限、资源预算或平台版本五个层级之一，再调用对应深度文档（lifecycle.md、capabilities.md、permissions.md 等）获取精准修复路径。
用户通过配置 ~/Clawic/data/ios/config.yaml 声明技术栈偏好（SwiftUI/UIKit、部署目标、依赖管理器等），Skill 据此调整示例代码方言与验证步骤。每次会话自动读取 memory.md 中的历史观测记录，确保诊断具备连续性。关键交付物——如 rejection 修复方案、性能基线、发布记录——必须按模板写入指定文件，形成可追溯的知识资产。
典型工作流包括：App Review 被拒时对照 guideline 编号直接修改代码而非申诉；推送失效时按"token→环境→topic→payload"顺序排查；遇到 0xdead10cc 终止码时立即检查 App Group 容器中的数据库句柄释放逻辑。所有建议均附带物理设备验证要求，明确拒绝"模拟器测试即交付"的陷阱。
显著优点
体系化诊断框架：五层分类法将混沌的 iOS 平台问题结构化，避免"背景预算问题误当网络 bug 修一周"的层错位陷阱。每条规则（如 Rule 3 的能力三角、Rule 6 的性能阈值）均给出可量化的判定标准。
企业级知识管理：强制要求将 durable 产出（release 记录、设备清单、平台事实）写入标准化文件，解决"同一 AASA 缓存问题每季度被重新发现"的组织失忆症。共享设备库、财务订阅跟踪、项目关联引用等设计支持团队协作。
安全合规领先：纯 Markdown 零可执行代码架构，凭证仅存储指针（keychain:、env:、1password: 等），本地数据目录明确排除敏感信息写入。六维安全扫描全通，GDPR/CCPA 合规性经过验证。
实战导向的深度文档：24 个专题覆盖从 simctl/devicectl 命令速查、隐私清单合规到订阅涨价机制等细微场景，Quick Reference 表格支持症状-方案-深度文档的直接跳转。
潜在缺点与局限性
非自动化工具：该 Skill 不提供脚本自动修复功能，所有方案需人工实施。对于追求"一键解决"的开发者，学习曲线陡峭。
平台边界严格限定：明确排除 Swift 语言细节、Xcode IDE 配置、跨平台框架（React Native/Flutter）及 App Store 提交流程，完整 iOS 交付需配合 swift、xcode、app-store 等关联 Skill。
Darwin 独占性：依赖 xcodebuild 工具链，仅支持 macOS 环境，Windows/Linux 开发者无法直接使用。
文档依赖的维护成本：memory.md 的结构化写入要求、设备清单的主动维护、年度回归测试的 ## Due 表管理，对缺乏文档纪律的团队形成额外负担。
适合的目标群体
- iOS 平台工程师：负责解决设备专属疑难（仅真机出现的崩溃、推送失效、后台任务异常）的资深开发者
- 技术负责人：需要建立团队 iOS 知识库、发布流程规范与性能基线体系的工程经理
- 独立开发者：缺乏完整测试矩阵，需通过系统指南规避常见 App Review 陷阱的 solo 开发者
- 客户项目交付团队：需要管理多客户设备库存、跟踪会员续费状态、隔离项目数据的代理机构
不适合纯 Swift 语法学习者、跨平台框架用户，或寻求 Xcode 签名/构建自动化方案的团队。
使用风险
配置漂移风险：config.yaml 与 memory.md 的观测记录可能出现冲突，Skill 优先采用声明值，长期可能导致观测数据堆积而未被清理。建议定期审计配置目录。
数据迁移残留：旧路径 ~/ios/ 或 ~/clawic/ios/ 的数据若未主动迁移至 ~/Clawic/data/ios/，可能导致历史记录碎片化。
凭证指针失效：依赖外部密码管理器（1Password）、环境变量或 Keychain 的凭证指针，若用户环境变更而 Skill 数据未同步更新，将导致命令执行失败。
版本滞后风险：iOS 年度大版本更新后，部分指南可能需等待 Skill 更新，受 beta_os_policy 配置影响。
本地存储增长：设备清单、发布记录、项目关联数据持续积累，长期运行需关注 ~/Clawic/data/ 目录磁盘占用。