CharlesWiltgen/Axiom

Axiom – 面向 Apple 平台开发的 AI 驱动助手

它是什么

• 一组 技能、代理 和命令行工具，可插入 AI 编码助手（Claude、Cursor、Gemini 等），为其提供现代 Apple 开发的深入知识——Swift 6、SwiftUI、即将推出的 Liquid Glass UI 框架，以及 Apple Intelligence API。
• 该仓库附带预编写的提示（技能）和自主代理，可自动扫描 Xcode 项目中的常见问题，如内存泄漏、数据竞争违规或构建系统失败。
• 它还捆绑了一些小型实用工具（xclog、xcsym、xcui、xcprof），可将模拟器/设备日志、崩溃符号化、UI 自动化和性能追踪数据暴露给 AI 助手。

关键组件

组件	用途
技能（约 280 个）	提示模板，教 AI 如何回答有关 UI、网络、并发、性能、可访问性等问题。
代理（约 42 个）	后台工作器，可由 AI 调用以运行审计——例如内存泄漏检测、并发检查、构建失败诊断。
命令（约 17 个）	/axiom:* 命令行风格命令，可在聊天中键入以触发内置工具（日志捕获、崩溃符号化、健康检查等）。
xclog	流式传输模拟器/设备控制台输出，使 AI 能实时读取日志。
xcsym	通过自动定位正确的 dSYM，对 Apple 崩溃文件（.ips、MetricKit、旧版 .crash）进行符号化。
xcui	通过可访问性 ID 驱动模拟器 UI，转储可访问性树，并验证 VoiceOver/动态类型支持。
xcprof	运行 xctrace 追踪，并返回简洁的性能报告，无需打开 Instruments。

如何使用

1. 安装插件 到您偏好的 AI IDE（Claude Code、Cursor、VS Code MCP、Pi 终端代理或 Xcode 集成）——README 为每个平台提供了一行命令。
2. 向助手提问 自然语言问题（例如，“如何修复 Swift 6 并发错误？”）或调用命令（/axiom:fix-build）。AI 加载相关技能/代理，运行底层工具，并返回具体答案或修复方案。
3. 运行审计（/axiom:audit memory、/axiom:health-check），让代理自动扫描项目并在问题到达用户之前发现它们。

目标受众

• 已经使用 AI 编码助手并希望这些助手理解 Apple 特定工具和 API 细微差别的 iOS/macOS 开发者。
• 希望减少构建失败、内存泄漏检测和崩溃分析调试时间的团队。

文档与社区

• 完整文档、技能目录和安装指南托管在 charleswiltgen.github.io/Axiom。
• 社区讨论在 Reddit（r/axiomdev）和 GitHub Issues/Discussions 上进行。

状态

• 积极跟踪 Apple OS 27 测试版（仓库位于 27.x 分支）。对 OS 26 及更早版本的现有支持稳定。

---

以上所有细节均直接取自仓库的 README。