用途:在需要 Apple 官方 API 签名、行为说明或 Swift 编译器诊断解释时,直接读取 Xcode 内置的 for-LLM Markdown 文档,而非依赖模型记忆。
主要能力:提供两类文档的路由。一是 AdditionalDocumentation 指南(20 个文件),覆盖 SwiftUI/UIKit/AppKit/WidgetKit 的 Liquid Glass 设计、工具栏、样式化文本编辑、WebKit 集成、AlarmKit、Swift Charts 3D、AttributedString、SwiftData 类继承、Swift 并发、InlineArray 与 Span、Foundation Models 端侧 LLM、App Intents、StoreKit、MapKit GeoToolbox、visionOS 小组件、辅助功能与视觉智能等。二是 Swift 编译器诊断(46 个文件),涵盖并发、类型系统、构建与迁移、语言特性等诊断说明。
使用方式:以文件方式读取。默认 Xcode 路径下,指南位于 /Applications/Xcode.app/Contents/PlugIns/IDEIntelligenceChat.framework/Versions/A/Resources/AdditionalDocumentation/,诊断位于 /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/share/doc/swift/diagnostics/。会话上下文会给出实际 Xcode 路径;无上下文时可用 AXIOM_XCODE_PATH,或运行 xcode-select -p 推导。诊断文件名按短名小写连字符命名,未列出时可先 ls 诊断目录。
适用场景:查询具体 Apple 框架特性、需要官方 API 细节、解释编译器报错或警告。Axiom 技能提供决策树与反模式等观点性指导,Apple 文档提供权威 API 细节,二者配合使用。
限制:路径假设默认安装,需以会话上下文为准。若 Xcode 无该文档目录(旧版或仅装 Command Line Tools),可回退到 sosumi.ai、WebFetch developer.apple.com 或建议安装最新 Xcode;不应静默失败,需告知用户所用回退方式。使用 axiom-mcp 的客户端也可通过 axiom_read_skill 以旧 ID 调用同一内容。