iOS App Generator Skill

ios-app-generator 是一个 Codex skill，用于把一个 iOS App 想法转成可执行的产品与工程交付包。它覆盖 PRD、UI 规格、SwiftUI/SpriteKit 实现方案、多语言与主题约束、App Store 文案，以及后续自动发布占位清单。

能做什么

• 从一句 App 想法生成 docs/PRODUCT_REQUIREMENTS.md
• 生成 SwiftUI / SpriteKit / 原生 iOS 的实现方向
• 约束项目结构、主题系统、本地化和持久化方式
• 生成 App Store 描述、ASO 关键词、截图文案、更新日志
• 为未来 TestFlight / App Store 自动化发布预留清单
• 参考本地 AI 生成 iOS 项目风格：/Users/kl/Desktop/kunlunLibray/flutter/懒人不懒

适用场景

这个 skill 适合这些请求：

• “帮我从 0 到 1 生成一个 iOS App”
• “先写 PRD，再给 SwiftUI 实现方案”
• “生成一个 SpriteKit 休闲小游戏”
• “给这个 App 生成 App Store 文案和 ASO 关键词”
• “按中英文、多主题、本地持久化的方式生成 MVP”

默认技术取向：

• SwiftUI 做 App shell、页面、设置、导航、HUD
• SpriteKit 做 2D 游戏场景、触摸、粒子、遮罩和游戏循环
• iOS 17+
• 本地优先，无服务端、无登录、无广告、无内购、无追踪
• zh-Hans 和 en 从第一版开始支持

安装

把仓库克隆到 Codex skills 目录：

mkdir -p ~/.codex/skills
git clone git@github.com:hunaocode/ios-app-generator.git ~/.codex/skills/ios-app-generator

如果你使用的是自定义 skill 目录，也可以放到你的自定义目录，例如：

mkdir -p /Users/kl/Desktop/kunlunLibray/customSkills
git clone git@github.com:hunaocode/ios-app-generator.git /Users/kl/Desktop/kunlunLibray/customSkills/ios-app-generator

安装后，在 Codex 里这样使用：

Use $ios-app-generator 帮我从0到1生成一个极简习惯打卡 iOS App，先写 PRD，再生成 SwiftUI 实现方案、代码结构、多语言、主题和 App Store 文案。

使用示例

生成完整 App MVP

Use $ios-app-generator 帮我生成一个番茄钟 iOS App，要求支持中英文、主题切换、本地统计和 App Store 文案。

生成 iOS 小游戏

Use $ios-app-generator 帮我做一个洗车模拟 iOS 小游戏，先写 PRD，再生成 SwiftUI/SpriteKit 实现方案和代码结构。

只生成 App Store 文案

Use $ios-app-generator 给这个 App 生成 App Store 描述、ASO 关键词、截图文案和首版更新日志。

输出约定

完整 App 生成任务应尽量产出：

docs/PRODUCT_REQUIREMENTS.md
docs/UI_SPEC.md
docs/APP_STORE_METADATA.md
docs/RELEASE_TODO.md
Swift / SwiftUI / SpriteKit 源码或可执行实现补丁
验证命令和结果

目录结构

ios-app-generator/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    ├── app-store-copy.md
    ├── car-wash-simulator.md
    ├── ios-implementation.md
    ├── localization-theme.md
    ├── prd-workflow.md
    └── release-placeholder.md

设计原则

• 先产品后代码：先明确用户、核心循环、MVP 范围和验收标准。
• 原生优先：默认 SwiftUI + SpriteKit，不主动引入后端或重型依赖。
• 本地化优先：所有用户可见文本进入 Localizable.xcstrings。
• 主题一致：使用 ThemeStore、AppTheme、ThemePalette 这类环境驱动主题结构。
• App Store 合规：默认不加广告、追踪、内购、账号或私有 API。
• 可验证：代码生成后应尽量运行 xcodebuild 和本地化检查。

发布说明

当前 skill 的 Step 5 自动发布只做 TODO 占位，不直接处理证书、描述文件、App Store Connect API Key 或 Fastlane 自动上传。

后续可以扩展：

• Fastlane 初始化
• TestFlight 上传
• App Store Connect 元数据同步
• 截图自动化
• 隐私清单和合规检查