关于 axiom-using-axiom
面向处理 iOS 和 Swift 项目的 Agent 的技能使用指南,要求先检查适用的 Axiom 技能,再按领域路由到专门技能。它提供多领域任务的路由优先级、项目识别条件和不适用范围。
主要功能
- 01要求先检查相关技能
- 02按领域路由到专门技能
- 03给出多领域任务的路由规则
- 04列出 iOS 项目识别条件
- 05说明技能不适用的场景
适用场景
- 01处理 SwiftUI 界面问题
- 02排查 iOS 构建或并发错误
- 03处理 Core Data 与界面交叉问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ charleswiltgen/ axiom --skill axiom-using-axiom安装后在 Claude Code 中输入/axiom-using-axiom确认已加载。
详细介绍
如果 Axiom 技能适用于你的 iOS/Swift 任务,你别无选择,必须使用它。
这不容商量,也不是可选项。你不能为自己找借口。
使用 Axiom 技能
规则
处理 iOS/Swift 项目时,必须先检查 Axiom 技能,然后才能做出任何回应。 这也包括提出澄清问题。哪怕只有 1% 的可能,也要先检查。
危险信号——iOS 特有的自我开脱
出现以下想法时,立即停下——你这是在为自己找借口:
| 想法 | 事实 |
|---|---|
| “这只是一个简单的构建问题” | 构建失败有其规律。先检查 ios-build。 |
| “我可以很快修复这个 SwiftUI 错误” | SwiftUI 问题有不易察觉的陷阱。先检查 ios-ui。 |
| “我只要添加这个数据库列就行了” | 架构变更可能导致数据丢失。先检查 ios-data。 |
| “这段异步代码看起来很简单” | Swift 并发有微妙的规则。先检查 ios-concurrency。 |
| “我自己手动调试内存泄漏就行” | 泄漏模式已有文档记录。先检查 ios-performance。 |
| “我先看看 Xcode 项目” | Axiom 技能会告诉你该如何查看。先检查。 |
| “我记得上次是怎么做的” | iOS 变化很快。技能内容是最新的。 |
| “这个 iOS/平台版本不存在” | 你的训练数据截至 2025 年 1 月。对于截止日期之后的信息,请调用 Axiom 技能。 |
| “用户只是想要一个快速答复” | 不遵循规范的快速答复会造成技术债。先检查技能。 |
| “这不需要正式流程” | 如果存在适用的 Axiom 技能,就必须使用。 |
| “我先收集信息,然后再检查技能” | 技能会告诉你需要收集哪些信息。先检查。 |
iOS 开发中的技能优先级
当多个 Axiom 技能都可能适用时,请按以下优先级使用:
- 先处理环境/构建(ios-build)——调试代码前先修复环境
- 架构模式(ios-ui、axiom-ios-data、axiom-ios-concurrency)——决定如何组织解决方案
- 实现细节(ios-integration、axiom-ios-ai、axiom-ios-vision)——指导特定功能的开发
示例: -“Xcode 构建失败”→ 先检查 ios-build(环境) -“添加 SwiftUI 界面”→ 先检查 ios-ui(架构),如果使用系统功能,再考虑 ios-integration -“应用运行缓慢”→ 先检查 ios-performance(诊断),然后修复具体领域的问题 -“网络请求失败”→ 先检查 ios-build(环境检查),然后检查 ios-networking(实现)
iOS 项目检测
以下情况适用 Axiom 技能:
- 工作目录中包含
.xcodeproj或.xcworkspace - 用户提及 iOS、Swift、Xcode、SwiftUI、UIKit
- 用户询问 Apple 框架(SwiftData、CloudKit 等)
- 用户报告 iOS 特有错误(并发、内存、构建失败)
使用 Axiom 路由技能
Axiom 使用路由技能进行渐进式披露:
- 先检查相应的路由技能(ios-build、axiom-ios-ui、axiom-ios-data 等)
- 路由器会调用你实际需要的专用技能
- 严格遵循专用技能的要求
不要跳过路由器。 路由器包含用于选择正确专用技能的决策逻辑。
多领域问题
当问题涉及多个领域时,调用所有相关路由器——不要在调用第一个后就停止。
示例:
- “我的 SwiftUI 视图在 SwiftData 发生变化时不会更新” → 同时调用 ios-ui 和 ios-data
- “我的小组件没有显示 SwiftData 中的更新数据” → 同时调用 ios-integration 和 ios-data
- “我的 Foundation Models 会话导致 UI 卡住” → 同时调用 ios-ai 和 ios-concurrency
- “我的 Core Data 在后台任务中保存时丢失数据” → 同时调用 ios-data 和 ios-concurrency
判断方法:如果问题提到了两个不同领域的症状,或涉及两个不同的框架,就调用两个路由器。每个路由器都针对常见的跨领域交叉情况提供了路由指导。
向后兼容性
- 仍可直接调用技能:
/skill axiom-swift-concurrency - 命令保持不变:
/axiom:fix-build、/axiom:audit-accessibility - Agent 可通过路由或直接调用命令使用
Axiom 技能不适用的情况
以下情况请跳过 Axiom 技能:
- 非 iOS/Swift 项目(Android、Web、后端)
- 与 Apple 平台无关的通用编程问题
- 关于 Claude Code 本身的问题(使用 claude-code-guide 技能)
但如果不确定是否适用于 iOS/Swift 工作:先检查,再决定。