mc-skills/catalog

Fork 0

mc-skills 6e3f9bab06 catalog: 更新 2026-04-06 22:24

2026-04-06 22:24:03 +08:00

14 KiB

Raw Permalink Blame History

苹果开发者工具套件

iOS开发 SwiftUI App Store CLI工具 代码生成

Apple Developer Toolkit

三合一工具，单一二进制文件。文档、App Store 和应用构建器

搜索 Apple 文档、管理 App Store Connect，并通过自然语言构建多平台应用

$ appledev build

> 一个带连续打卡计数和每周网格视图的习惯追踪应用

  ✓ 已分析：StreakGrid
  ✓ 计划就绪（11 个文件，3 个模型）
  ✓ 构建完成 — 11 个文件
  ✓ 已在 iPhone 17 Pro 上启动

以单一统一二进制文件 appledev 发布，内含三个独立工具。每个工具可单独使用，凭证要求各不相同。

安装

brew install Abdullah4AI/tap/appledev

从源码安装

git clone https://github.com/Abdullah4AI/apple-developer-toolkit.git
cd apple-developer-toolkit
bash scripts/setup.sh

Agent 技能

为任意 AI 编程 Agent 添加 iOS 和 SwiftUI 知识——支持 Claude Code、Codex、Cursor、Windsurf、Gemini CLI 等：

# 安装全部技能（推荐）
npx add-skill Abdullah4AI/apple-developer-toolkit

# 安装指定技能
npx add-skill Abdullah4AI/apple-developer-toolkit --skill ios-rules
npx add-skill Abdullah4AI/apple-developer-toolkit --skill swiftui-guides

技能	新增内容	Token 消耗
`ios-rules`	38 条 iOS 规范：无障碍、导航、架构、深色模式、本地化、App 审核	~20K tokens
`swiftui-guides`	12 篇 SwiftUI 指南：液态玻璃、状态管理、动画、布局、性能	~20K tokens

技能开箱即用，兼容所有支持 Agent Skills 格式的 Agent。

包含内容

文档
_{Apple 文档 + 1,267 场 WWDC 专题（2014-2025）}

node cli.js search App Store Connect
_{120+ 条命令，覆盖构建、TestFlight、提交审核}

appledev store 应用构建器
_{自然语言转编译好的 SwiftUI 应用}

appledev build

功能	凭证要求	无需配置即可使用
文档搜索	无	是
App Store Connect	API 密钥（.p8）	否
应用构建器	LLM API 密钥 + Xcode	否

支持平台

在提示词中提及任意 Apple 平台——可自由组合多个：

_默认

_"iPad"

_{"Apple Watch"}

_"Mac"

_{"Apple TV"}

_{"Vision Pro"}

框架

应用尽可能优先使用 Apple 原生框架：

SwiftUI _UI	SwiftData _持久化	Swift Charts _{数据可视化}	MapKit _地图	HealthKit _健康	WidgetKit _小组件
AVFoundation _{相机与媒体}	PhotosUI _{照片选取器}	ActivityKit _实时活动	CoreML _机器学习	ARKit _增强现实	RealityKit _{3D 与空间计算}

发布

无需离开终端，直接发布到 App Store 和 TestFlight。

App Store
_{完整提交流程}

TestFlight
_{Beta 版本分发}

集成

在提示词中提及身份验证、数据库或付费功能，工具包会自动接入支持的后端服务。

RevenueCat
_{订阅与付费墙}

Supabase
_{身份验证、数据库、存储}

Telegram
_{构建与审核通知}

Slack
_团队通知

飞书 / Lark
_团队通知

Git
_{自动打版本标签}

文档搜索

在本地搜索 Apple 框架、符号和 WWDC 专题，无需 API 密钥。

node cli.js search "NavigationStack"        # 框架搜索
node cli.js symbols "UIView"                # 符号查询
node cli.js doc "/documentation/swiftui/view" # 完整文档
node cli.js overview "SwiftUI"              # 框架概览
node cli.js samples "SwiftUI"               # 示例代码

node cli.js wwdc-search "concurrency"       # 搜索 WWDC 演讲
node cli.js wwdc-year 2025                  # 按年份浏览
node cli.js wwdc-topic "swiftui-ui-frameworks" # 按主题浏览

App Store Connect

120+ 条命令，全面覆盖 App Store Connect API。

# 身份验证
appledev store auth login --name "MyApp" \
  --key-id "KEY_ID" --issuer-id "ISSUER_ID" \
  --private-key ./AuthKey.p8

# 发布到 TestFlight
appledev store publish testflight \
  --app "APP_ID" --ipa app.ipa --group "Beta" --wait

# 提交到 App Store
appledev store publish appstore \
  --app "APP_ID" --ipa app.ipa --submit --confirm --wait

# 提交前验证
appledev store validate --app "APP_ID" --version-id "VER_ID"

所有命令分类

分类	命令
入门	auth、doctor、init、docs
应用	apps、app-setup、versions、localizations、screenshots、video-previews
TestFlight	testflight、builds、sandbox、feedback、crashes
审核与发布	review、reviews、submit、validate、publish、status
签名	signing、bundle-ids、certificates、profiles、notarization
变现	iap、subscriptions、offer-codes、win-back-offers、pricing
数据分析	analytics、insights、finance、performance
自动化	xcode-cloud、webhooks、workflow、metadata、diff、migrate

应用构建器

通过自然语言构建完整的多平台 Apple 应用。

> 一个带食材清单、分步操作说明和计时器的菜谱应用

  ✓ 已分析：RecipeBook
  ✓ 计划就绪（16 个文件，4 个模型）
  ✓ 构建完成 — 16 个文件
  ✓ RecipeBook 已就绪！

工作原理

描述  →  分析  →  规划  →  构建  →  修复  →  运行
 ↑         │        │       │        │       │
提示词   应用名   文件   Swift   xcode-   iOS
         功能    模型    代码    build   模拟器

阶段	发生了什么
分析	从描述中提取应用名称、功能和核心流程
规划	生成包含模型、导航和依赖包的文件级构建计划
构建	生成 Swift 源码、资源目录和 Xcode 项目
修复	使用 `xcodebuild` 编译并自动修复，直到通过
运行	启动模拟器并运行应用

命令

命令	说明
`appledev build`	交互模式
`appledev build chat`	编辑现有项目
`appledev build fix`	自动修复编译错误
`appledev build run`	构建并在模拟器中启动
`appledev build open`	在 Xcode 中打开
`appledev build setup`	安装前置依赖

交互命令

命令	说明
`/run`	构建并在模拟器中启动
`/fix`	自动修复编译错误
`/ask <问题>`	查询项目信息（只读）
`/open`	在 Xcode 中打开
`/model <名称>`	切换 AI 模型
`/info`	显示项目信息
`/usage`	Token 用量与费用

生命周期钩子

跨 4 个分类共 42 个事件。可通过 Telegram 接收通知、自动分发到 TestFlight、为发布打 Git 标签，并将操作串联成流水线。

# 使用模板初始化钩子
bash scripts/hook-init.sh --template indie

# 手动触发钩子
bash scripts/hook-runner.sh build.done STATUS=success APP_NAME=MyApp

# 演练运行
bash scripts/hook-runner.sh --dry-run build.done STATUS=success

模板

模板	适用场景
`indie`	独立开发者 — Telegram 通知、自动发布到 TestFlight
`team`	团队 — Slack + Telegram、Git 标签、变更日志
`ci`	CI/CD — 日志记录、运行测试、无交互通知
`feishu`	飞书/Lark — 面向中国开发团队的 Webhook 通知

内置脚本

脚本	用途
`notify-telegram.sh`	发送 Telegram 通知
`notify-feishu.sh`	发送飞书/Lark 通知
`git-tag-release.sh`	创建并推送 Git 标签
`run-swift-tests.sh`	运行 Swift 测试
`generate-changelog.sh`	从 Git 历史生成变更日志

配置示例

version: 1
notifiers:
  telegram:
    enabled: true
    bot_token_keychain: "my-bot-token"
    chat_id: "123456"
  feishu:
    enabled: true
    webhook_url_env: "FEISHU_WEBHOOK_URL"

hooks:
  build.done:
    - name: notify-build
      notify: telegram
      template: "{{if eq .STATUS \"success\"}}✅{{else}}❌{{end}} {{.APP_NAME}} 构建"
    - name: notify-build-feishu
      notify: feishu
      template: "{{if eq .STATUS \"success\"}}✅{{else}}❌{{end}} {{.APP_NAME}} 构建"

  store.review.approved:
    - name: tag-release
      run: "git tag v{{.VERSION}} && git push origin v{{.VERSION}}"

配置文件位置：

全局： ~/.appledev/hooks.yaml
项目： .appledev/hooks.yaml

AI Agent 参考资料

52 个参考文件，助力 AI 辅助开发：

参考资料	数量	内容
`references/ios-rules/`	38	iOS 开发规范（无障碍、深色模式、本地化等）
`references/swiftui-guides/`	12	SwiftUI 最佳实践（液态玻璃、导航、状态管理等）
`references/app-store-connect.md`	1	完整 CLI 参考手册
`references/hooks-reference.md`	1	所有钩子事件及上下文变量

环境要求

功能	依赖
文档搜索	Node.js 18+
App Store Connect	API 密钥（.p8 文件）
应用构建器	Xcode + LLM API 密钥
生命周期钩子	无

许可证

MIT

_{由 Abdullah AlRashoudi 构建}

14 KiB Raw Permalink Blame History Unescape Escape