axiom-using-axiom
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese<EXTREMELY-IMPORTANT>
If you think there is even a 1% chance an Axiom skill might apply to your iOS/Swift task, you ABSOLUTELY MUST check for the skill.
IF AN AXIOM SKILL APPLIES TO YOUR iOS/SWIFT TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
This is not negotiable. This is not optional. You cannot rationalize your way out of this.
</EXTREMELY-IMPORTANT>
<EXTREMELY-IMPORTANT>
如果你认为你的iOS/Swift任务有哪怕1%的概率可以应用Axiom技能,你都必须绝对要检查该技能。
如果某款Axiom技能适用于你的iOS/Swift任务,你别无选择,必须使用它。
这没有商量余地,也不是可选操作。你无法找理由规避这一要求。
</EXTREMELY-IMPORTANT>
Using Axiom Skills
使用Axiom技能
The Rule
规则
Check for Axiom skills BEFORE ANY RESPONSE when working with iOS/Swift projects. This includes clarifying questions. Even 1% chance means check first.
在处理iOS/Swift项目时,必须在作出任何回应之前先检查Axiom技能,包括澄清问题。哪怕只有1%的概率适用,也要先检查。
Red Flags — iOS-Specific Rationalizations
警示信号——iOS相关的自我合理化借口
These thoughts mean STOP—you're rationalizing:
| Thought | Reality |
|---|---|
| "This is just a simple build issue" | Build failures have patterns. Check ios-build first. |
| "I can fix this SwiftUI bug quickly" | SwiftUI issues have hidden gotchas. Check ios-ui first. |
| "Let me just add this database column" | Schema changes risk data loss. Check ios-data first. |
| "This async code looks straightforward" | Swift concurrency has subtle rules. Check ios-concurrency first. |
| "I'll debug the memory leak manually" | Leak patterns are documented. Check ios-performance first. |
| "Let me explore the Xcode project first" | Axiom skills tell you HOW to explore. Check first. |
| "I remember how to do this from last time" | iOS changes constantly. Skills are up-to-date. |
| "This iOS/platform version doesn't exist" | Your training ended January 2025. Invoke Axiom skills for post-cutoff facts. |
| "The user just wants a quick answer" | Quick answers without patterns create tech debt. Check skills first. |
| "This doesn't need a formal workflow" | If an Axiom skill exists for it, use it. |
| "I'll gather info first, then check skills" | Skills tell you WHAT info to gather. Check first. |
出现以下想法时请立刻停止——你在找借口:
| 想法 | 实际情况 |
|---|---|
| "这只是个简单的构建问题" | 构建失败存在规律,先检查ios-build技能。 |
| "我能快速修复这个SwiftUI bug" | SwiftUI问题存在隐藏陷阱,先检查ios-ui技能。 |
| "我只是要添加一个数据库列" | 架构变更存在数据丢失风险,先检查ios-data技能。 |
| "这段异步代码看起来很简单" | Swift并发有微妙的规则,先检查ios-concurrency技能。 |
| "我要手动调试内存泄漏问题" | 泄漏模式已有文档记录,先检查ios-performance技能。 |
| "我先浏览一下Xcode项目" | Axiom技能会告诉你如何浏览,先检查技能。 |
| "我记得上次是这么做的" | iOS技术一直在变化,技能内容是最新的。 |
| "这个iOS/平台版本不存在" | 你的训练截止到2025年1月,调用Axiom技能获取截止后的信息。 |
| "用户只是想要一个快速答案" | 不遵循规律的快速答案会造成技术债务,先检查技能。 |
| "这个不需要正式的工作流" | 如果存在对应的Axiom技能,就必须使用。 |
| "我先收集信息,之后再检查技能" | 技能会告诉你需要收集哪些信息,先检查技能。 |
Skill Priority for iOS Development
iOS开发的技能优先级
When multiple Axiom skills could apply, use this priority:
- Environment/Build first (ios-build) — Fix the environment before debugging code
- Architecture patterns (ios-ui, axiom-ios-data, axiom-ios-concurrency) — These determine HOW to structure the solution
- Implementation details (ios-integration, axiom-ios-ai, axiom-ios-vision) — These guide specific feature work
Examples:
- "Xcode build failed" → ios-build first (environment)
- "Add SwiftUI screen" → ios-ui first (architecture), then maybe ios-integration if using system features
- "App is slow" → ios-performance first (diagnose), then fix the specific domain
- "Network request failing" → ios-build first (environment check), then ios-networking (implementation)
当多个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 Project Detection
iOS项目检测
Axiom skills apply when:
- Working directory contains or
.xcodeproj.xcworkspace - User mentions iOS, Swift, Xcode, SwiftUI, UIKit
- User asks about Apple frameworks (SwiftData, CloudKit, etc.)
- User reports iOS-specific errors (concurrency, memory, build failures)
当出现以下情况时,Axiom技能适用:
- 工作目录包含或
.xcodeproj文件.xcworkspace - 用户提到iOS、Swift、Xcode、SwiftUI、UIKit
- 用户询问Apple框架(SwiftData、CloudKit等)相关问题
- 用户报告iOS特定错误(并发、内存、构建失败等)
Using Axiom Router Skills
使用Axiom路由技能
Axiom uses router skills for progressive disclosure:
- Check the appropriate router skill first (ios-build, axiom-ios-ui, axiom-ios-data, etc.)
- Router will invoke the specialized skill(s) you actually need
- Follow the specialized skill exactly
Do not skip the router. Routers have decision logic to select the right specialized skill.
Axiom使用路由技能来逐步披露信息:
- 先检查对应的路由技能(ios-build, axiom-ios-ui, axiom-ios-data等)
- 路由技能会调用你实际需要的专业技能
- 严格遵循专业技能的要求操作
不要跳过路由技能。路由技能包含决策逻辑,能够选择合适的专业技能。
Backward Compatibility
向后兼容性
- Direct skill invocation still works:
/skill axiom-swift-concurrency - Commands work unchanged: ,
/axiom:fix-build/axiom:audit-accessibility - Agents work via routing or direct command invocation
- 直接调用技能仍然有效:
/skill axiom-swift-concurrency - 命令保持不变: ,
/axiom:fix-build/axiom:audit-accessibility - 智能体可通过路由或直接命令调用
When Axiom Skills Don't Apply
不适用Axiom技能的场景
Skip Axiom skills for:
- Non-iOS/Swift projects (Android, web, backend)
- Generic programming questions unrelated to Apple platforms
- Questions about Claude Code itself (use claude-code-guide skill)
But when in doubt for iOS/Swift work: check first, decide later.
在以下场景可跳过Axiom技能:
- 非iOS/Swift项目(Android、Web、后端)
- 与Apple平台无关的通用编程问题
- 关于Claude Code本身的问题(使用claude-code-guide技能)
但在iOS/Swift相关工作中存疑时: 先检查,再决定。