Apple Developer Toolkit 是一个面向苹果开发生态的一体化技能，将三项工具能力整合在一起：文档检索、App Store Connect 管理，以及自动化 iOS 应用构建。
一、安装与初始化
所需的可执行文件在首次使用时通过 Homebrew 自动安装：
brew tap Abdullah4AI/tap && brew install appstore swiftship
也可以运行技能内置的安装脚本：
bash scripts/setup.sh
使用 App Store Connect 相关功能前需要先进行认证：
appstore auth login --name "MyApp" --key-id "KEY_ID" --issuer-id "ISSUER_ID" --private-key /path/to/AuthKey.p8
二、文档检索
该部分用于查询 Apple 开发者文档与 WWDC 视频内容。提供的命令示例包括：
node cli.js search "NavigationStack" node cli.js symbols "UIView" node cli.js doc "/documentation/swiftui/navigationstack" node cli.js overview "SwiftUI" node cli.js samples "SwiftUI" node cli.js wwdc-search "concurrency" node cli.js wwdc-year 2025 node cli.js wwdc-topic "swiftui-ui-frameworks"
可用于搜索 API、查询符号信息、获取具体文档页内容、查看框架概览与示例代码，并可按关键词、年份或主题检索 WWDC 视频（覆盖 2014 至 2025 年）。
三、App Store Connect 管理
通过 appstore 命令行工具完成应用发布与运营管理，常见任务与命令如下：
- 列出应用：appstore apps
- 上传构建：appstore builds upload --app "APP_ID" --ipa "app.ipa" --wait
- 发布 TestFlight：appstore publish testflight --app "APP_ID" --ipa "app.ipa" --group "Beta" --wait
- 提交 App Store：appstore publish appstore --app "APP_ID" --ipa "app.ipa" --submit --confirm --wait
- 列出证书：appstore certificates list
- 查看评论：appstore reviews --app "APP_ID" --output table
- 销售报表：appstore analytics sales --vendor "VENDOR" --type SALES --subtype SUMMARY --frequency DAILY --date "2024-01-20"
- Xcode Cloud：appstore xcode-cloud run --app "APP_ID" --workflow "CI" --branch "main" --wait
- 公证：appstore notarization submit --file ./MyApp.zip --wait
- 校验：appstore validate --app "APP_ID" --version-id "VERSION_ID" --strict
功能覆盖范围包括：TestFlight、构建、签名、订阅、应用内购买（IAP）、分析、财务、Xcode Cloud、公证、Game Center、Webhooks、App Clips、截图、工作流自动化，以及从 Fastlane 迁移。完整命令参考见 references/app-store-connect.md。
四、iOS 应用构建
该部分可从自然语言描述生成完整的 iOS 应用，命令包括：
swiftship # 交互模式 swiftship setup # 安装前置依赖（Xcode、XcodeGen、Claude Code） swiftship fix # 自动修复构建错误 swiftship run # 在模拟器中构建并启动 swiftship info # 显示项目状态 swiftship usage # 令牌用量与成本
工作流程为：describe → analyze → plan → build → fix → run（描述 → 分析 → 规划 → 构建 → 修复 → 运行）。
- 分析：从描述中提取应用名称、功能与核心流程
- 规划：产出文件级构建计划，包括数据模型、导航与设计
- 构建：生成 Swift 源代码、project.yml 与资源目录
- 修复：编译并自动修复直到构建成功
- 运行：启动 iOS 模拟器并运行应用
交互模式支持的命令包括 /run（在模拟器中构建并启动）、/fix（自动修复编译错误）、/open（在 Xcode 中打开项目）、/model [name]（切换模型，可选 sonnet、opus、haiku）、/info（显示项目信息）、/usage（令牌用量与成本）。
五、参考资料
- references/app-store-connect.md：完整的 App Store Connect CLI 命令
- references/ios-rules/：38 条 iOS 开发规则（无障碍、深色模式、本地化等）
- references/swiftui-guides/：12 份 SwiftUI 最佳实践指南（动画、Liquid Glass、状态等）
- references/ios-app-builder-prompts.md：用于应用分析、规划与构建的系统提示词
iOS 规则（38 个文件）涵盖：无障碍、App Clips、应用审核、Apple 翻译、生物识别、相机、图表、颜色对比度、组件、深色模式、设计系统、反馈状态、文件结构、禁用模式、基础模型、手势、触觉反馈、HealthKit、实时活动、本地化、地图、MVVM 架构、导航模式、通知服务、通知、Safari 扩展、分享扩展、Siri Intents、间距布局、语音、存储模式、Swift 约定、计时器、排版、视图组合、视图复杂度、网站链接、小组件。
SwiftUI 指南（12 个文件）涵盖：动画、表单与输入、布局、Liquid Glass、列表模式、媒体、现代 API、导航、性能、滚动模式、状态管理、文本格式化。
六、限制
当前资料未提供该技能的具体收费模式、价格、平台支持范围（除提到的 Xcode、iOS 模拟器、Homebrew 环境外）、运行所需的最低系统版本，以及各项功能的成功率或效果保证等信息。