/ 目录 / 演练场 / Axiom (xOS Dev Skills)
← 全部服务器 ↗ GitHub
● 社区 CharlesWiltgen ⚡ 即开即用

Axiom (xOS Dev Skills)

作者 CharlesWiltgen · CharlesWiltgen/Axiom

与 Swift 6 和谐共处的 Apple 平台开发——涵盖 SwiftUI、结构化并发、@Observable 和现代构建工具的专项 skill。

Axiom 是面向 iOS/iPadOS/watchOS/tvOS 生产应用的 Claude Code skill 套件，强制执行现代规范：SwiftUI 优先、@Observable 替代 ObservableObject、async/await 替代 completion handler、值类型优先，以及 Swift 6 并发规则。包含无障碍检查、App Store 就绪清单和 Xcode 项目卫生检查。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

就绪

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： Axiom (xOS Dev Skills)

将 ViewModel 迁移到 @Observable

👤 面向 iOS 17+ 的 iOS 开发者 ⏱ ~45 min advanced

何时使用： App 已面向 iOS 17+，但 ViewModel 仍在使用 ObservableObject + @Published。

步骤
  1. 盘点
    Axiom：列出项目中所有 ObservableObject + @Published，标注哪些是叶节点，哪些是共享对象。✓ 已复制
    → 带结构和依赖提示的清单
  2. 迁移一个
    将 ProfileViewModel 重构为 @Observable，保持公开 API 稳定，更新 View 中的 binding 写法。✓ 已复制
    → ViewModel 已迁移；View 中使用 @Bindable；@Published 已全部移除
  3. 验证
    运行该 scheme 的 xcodebuild，报告所有警告。✓ 已复制
    → 构建干净；没有 Swift 6 警告

结果： 采用现代 @Observable 的代码库，View 层更简洁。

注意事项
  • 现有测试依赖 @Published 的投影写法（$name） — 测试需要重写；并非所有访问模式都能直接映射
搭配使用： filesystem · ios-simulator-mcp

修复 Swift 6 并发警告

👤 准备适配 Swift 6 严格并发的 iOS 开发者 ⏱ ~60 min advanced

何时使用： 构建输出一堆 Sendable / actor 警告。

步骤
  1. 分类
    Axiom concurrency-clean：将警告分为三类：(1) actor 隔离、(2) Sendable 一致性、(3) 数据竞争风险。✓ 已复制
    → 按类别分组的清单
  2. 修复 actor 隔离
    先处理第 1 类。提出最小化修复方案；UI 类型优先用 @MainActor，不要全局撒 @MainActor。✓ 已复制
    → 外科式修改；不是到处加 @MainActor 的暴力方案

结果： Swift 6 构建干净，并发边界设计有意识。

注意事项
  • 把 @MainActor 当「消除警告」的万能药 — Skill 会标记这种用法；应该做合理的 actor 设计

运行无障碍审计

👤 发版前的 iOS 团队 ⏱ ~60 min intermediate

何时使用： 即将提交 App Store，你想确保 VoiceOver/Dynamic Type 已覆盖。

步骤
  1. 扫描 View
    Axiom a11y：扫描 SwiftUI View，标记缺少 accessibilityLabel、硬编码字体大小、低对比度颜色用法。✓ 已复制
    → 逐 View 的问题列表
  2. 修复前 10 个问题
    应用前 10 个问题的修复，字体改用系统字体以支持 Dynamic Type。✓ 已复制
    → 补丁已应用；构建仍然正常

结果： App 能通过基本的 VoiceOver 走查。

注意事项
  • 自动生成的 label 与用户心智模型不符 — 用能表达意图的 label 手动覆盖
搭配使用： ios-simulator-mcp

组合

与其他 MCP 搭配，撬动十倍杠杆

axiom-xos-skill + ios-simulator-mcp

应用 skill 建议后在模拟器上冒烟测试

Axiom：迁移 ProfileVM。iOS-Simulator：启动，截取个人资料界面截图。✓ 已复制
axiom-xos-skill + filesystem

在项目中应用补丁

Axiom concurrency-clean：生成 src/ 的补丁，Filesystem：应用它们。✓ 已复制
axiom-xos-skill + xcodebuildmcp

重构后验证构建

迁移完成后，XcodeBuild：构建模拟器版本，报告警告。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
vm_migrate_observable viewmodel_path 逐个 ViewModel 迁移 0
concurrency_clean scope Swift 6 准备工作 0
a11y_scan scope 发版前 0
appstore_checklist （无） 提交前 0
xcode_hygiene project 定期清理 0

成本与限制

运行它的成本

API 配额
不适用
每次调用 Token 数
项目扫描 10k–40k token
费用
免费
提示
将审计范围限定在一个功能/文件夹；不要在大型 app 上全量扫描

安全

权限、密钥、影响范围

最小权限： filesystem-read filesystem-write
凭据存储： 无
数据出站： 无

故障排查

常见错误与修复

迁移破坏了 @Bindable 用法

部分 View 需要 @Bindable 包装；检查 skill 是否有遗漏

并发修复静默地改变了语义

迁移后始终跑测试；并发变更影响微妙

无障碍建议太模板化

Skill 遵循 Apple HIG；用你自己的 label 细化

替代方案

Axiom (xOS Dev Skills) 对比其他方案

替代方案何时用它替代权衡
AvdLee Swift Concurrency Skill你只需要并发功能，不需要整个套件范围更窄
Apple 官方 Swift Migrator你想要 Apple 官方认可的迁移工具交互性更弱；对项目感知度更低
twostraws SwiftUI Agent Skill只聚焦 SwiftUI不同的规范主张

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills