axiom-getting-started

Axiom 入门

欢迎！此技能可帮助新用户根据自身情况找到最相关的 Axiom 技能。

此技能的工作方式

1. 向用户提出 2-3 个针对其项目的问题
2. 提供个性化技能推荐（最多 3-5 项）
3. 展示可立即尝试的示例提示词
4. 提供完整的技能参考，供用户浏览

步骤 1：提问

使用 AskUserQuestion 工具收集背景信息：

问题 1：当前重点

Question: "What brings you to Axiom today?"
Header: "Focus"
Options:
- "Debugging an issue" → Prioritize diagnostic skills
- "Optimizing performance" → Prioritize profiling skills
- "Adding new features" → Prioritize reference skills
- "Code review / quality check" → Prioritize audit commands
- "Just exploring" → Show overview

问题 2：技术栈

Question: "What's your primary tech stack?"
Header: "Stack"
Options:
- "SwiftUI (iOS 16+)" → SwiftUI-focused skills
- "UIKit" → UIKit-focused skills
- "Mixed SwiftUI + UIKit" → Both
- "Starting new project" → Best practices skills

问题 3：痛点（可选，多选）

仅当用户选择了“调试问题”时提问：

Question: "Which areas are you struggling with?"
Header: "Pain Points"
Multi-select: true
Options:
- "Xcode/build issues"
- "Memory leaks"
- "UI/animation problems"
- "Database/persistence"
- "Networking"
- "Concurrency/async"
- "Accessibility"

步骤 2：提供个性化推荐

根据回答，使用此矩阵推荐 3-5 项技能：

如果选择“调试问题”

始终推荐：axiom:xcode-debugging（通用入门选择）

然后根据痛点补充：

• Xcode/构建 → xcode-debugging、axiom-build-debugging
• 内存泄漏 → memory-debugging、axiom-objc-block-retain-cycles
• UI/动画（SwiftUI）→ swiftui-debugging、axiom-swiftui-performance
• UI/动画（UIKit）→ uikit-animation-debugging、axiom-auto-layout-debugging
• 数据库 → database-migration、axiom-sqlitedata-migration（决策指南）
• 网络 → networking、axiom-networking-diag
• 并发 → swift-concurrency
• 无障碍功能 → accessibility-diag

如果选择“优化性能”

SwiftUI 技术栈：

1. performance-profiling（工具决策树）
2. swiftui-performance（SwiftUI Instrument）
3. swiftui-debugging（视图更新问题）

UIKit/混合技术栈：

1. performance-profiling（Instruments 指南）
2. memory-debugging（泄漏检测）
3. uikit-animation-debugging（CAAnimation 问题）

如果选择“添加新功能”

设计决策：

• hig（快速设计决策、检查清单）
• hig-ref（全面的 HIG 参考）

iOS 26+ 功能：

• liquid-glass（材质设计系统）
• foundation-models（设备端 AI）
• swiftui-26-ref（完整的 iOS 26 指南）

导航模式：

• swiftui-nav（iOS 18+ Tab/Sidebar、深度链接）
• swiftui-nav-ref（全面的 API 参考）

集成：

• app-intents-ref（Siri、Shortcuts、Spotlight）
• networking（Network.framework 现代模式）

数据持久化：

• 询问：“使用哪种持久化框架？” → swiftdata、axiom-sqlitedata 或 grdb
• 迁移：axiom-sqlitedata-migration、axiom-realm-migration-ref

如果选择“代码审查/质量检查”

从审计命令开始（快速见效）：

1. /axiom:audit-accessibility — WCAG 合规性
2. /axiom:audit-concurrency — Swift 6 违规项
3. /axiom:audit-memory — 泄漏模式
4. /axiom:audit-core-data — 迁移安全性
5. /axiom:audit-networking — 已弃用的 API

然后建议：

• 根据审计结果推荐审查技能

如果选择“只是想探索”

展示完整的技能索引（见下文），并介绍各类别。

步骤 3：输出格式

收集回答后，输出：

## Your Recommended Skills

Based on your answers, here are the skills most relevant to you right now:

### [Icon] [Category Name]
**axiom:[skill-name]** — [One-line description]
> Try: "[Example prompt they can use immediately]"

[Repeat for 3-5 skills]

### Quick Wins
Run these audit commands to find issues automatically:
- `/axiom:audit-[name]` — [What it finds]

## What's Next

1. **Try the example prompts above** — Copy/paste to see how skills work
2. **Run an audit command** — Get immediate actionable insights
3. **Describe your problem** — I'll suggest the right skill
4. **Browse the complete index below** — Explore all 34 skills

---

[Include the Complete Skill Reference below]

完整技能参考

每次回复都包含此参考部分，供用户浏览：

调试与故障排除

环境与构建问题

• xcode-debugging — BUILD FAILED、模拟器卡死、僵尸进程、从环境入手的诊断
• build-debugging — 依赖冲突、CocoaPods/SPM 故障、Multiple commands produce

内存与性能

• memory-debugging — 内存增长、保留环、使用 Instruments 诊断泄漏
• performance-profiling — Instruments 决策树（Time Profiler、Allocations、Core Data、Energy）
• objc-block-retain-cycles — Objective-C 块内存泄漏、弱引用-强引用模式

UI 调试

• swiftui-debugging — 视图更新问题、结构体变更、绑定标识、视图重建
• swiftui-performance — SwiftUI Instrument（iOS 26）、过长的视图主体、Cause & Effect Graph
• uikit-animation-debugging — CAAnimation 完成回调、弹簧物理效果、手势与动画卡顿
• auto-layout-debugging — Auto Layout 冲突、约束调试（尚未纳入清单）

并发与异步

• swift-concurrency — Swift 6 严格并发、@concurrent、actor 隔离、Sendable、数据竞争

UI 与设计（iOS 26+）

Liquid Glass（Material Design）

• liquid-glass — 实现、Regular 与 Clear 变体、设计评审答辩
• liquid-glass-ref — 完整的全应用采用指南（图标、控件、导航、窗口）

布局与导航

• swiftui-layout — ViewThatFits 与 AnyLayout、onGeometryChange 的比较、决策树、iOS 26 自由形式窗口
• swiftui-layout-ref — 完整的布局 API 参考
• swiftui-nav — NavigationStack 与 NavigationSplitView 的比较、深度链接、协调器模式、iOS 18+ 标签栏/侧边栏
• swiftui-nav-ref — 全面的导航 API 参考
• swiftui-nav-diag — 导航无响应、意外返回、深度链接失败、状态丢失

测试

• ui-testing — 录制 UI 自动化（Xcode 26）、基于条件的等待、无障碍优先模式

持久化

框架

• swiftdata — @Model、@Query、@Relationship、CloudKit、iOS 26 功能、Swift 6 并发
• sqlitedata — Point-Free SQLiteData、@Table、FTS5、CTE、JSON 聚合、CloudKit 同步
• grdb — 原始 SQL、复杂联接、ValueObservation、DatabaseMigrator、性能
• database-migration — SQLite/GRDB 的安全模式演进、增量迁移、防止数据丢失

迁移指南

• sqlitedata-migration — 决策指南、模式对应关系、性能基准测试
• realm-migration-ref — Realm → SwiftData 迁移（Realm Device Sync 将于 2025 年 9 月停止服务）

网络

• networking — Network.framework（iOS 12-26）、NetworkConnection（iOS 26）、结构化并发
• networking-diag — 连接超时、TLS 故障、数据未到达、性能问题
• network-framework-ref — 完整 API 参考、TLV 帧格式、Coder 协议、Wi-Fi Aware

Apple Intelligence（iOS 26+）

• foundation-models — 设备端 AI、LanguageModelSession、@Generable、流式传输、工具调用
• foundation-models-diag — 上下文超限、护栏、生成缓慢、可用性问题
• foundation-models-ref — 完整 API 参考、全部 26 个 WWDC 示例

设计与 UI 指南

• hig — 快速设计决策、颜色/背景/排版选择、HIG 合规检查清单
• hig-ref — 全面的 Human Interface Guidelines 参考，附代码示例

集成

• app-intents-ref — Siri、Apple Intelligence、Shortcuts、Spotlight（iOS 16+）
• swiftui-26-ref — iOS 26 SwiftUI 功能、@Animatable、3D 布局、WebView、AttributedString
• avfoundation-ref — 音频 API、位完美 DAC、iOS 26 空间音频、ASAF/APAC

诊断（系统化故障排查）

• accessibility-diag — VoiceOver、动态字体、颜色对比度、WCAG 合规、App Store 答辩
• core-data-diag — 模式迁移崩溃、线程约束、N+1 查询

审计命令（快速扫描）

• /axiom:audit-accessibility — VoiceOver 标签、动态字体、对比度、触控目标
• /axiom:audit-concurrency — Swift 6 违规、不安全任务、缺少 @MainActor
• /axiom:audit-memory — Timer 泄漏、观察者泄漏、闭包捕获、代理循环
• /axiom:audit-core-data — 迁移风险、线程违规、N+1 查询
• /axiom:audit-networking — 已弃用 API（SCNetworkReachability、CFSocket）、反模式
• /axiom:audit-liquid-glass — Glass 采用机会、工具栏改进、模糊效果迁移

技能类别说明

• 规范类技能（无后缀）— 分步工作流，包含压力场景，并经过 TDD 测试
• 诊断类技能（-diag 后缀）— 系统化故障排查，包含生产事故应对
• 参考类技能（-ref 后缀）— 全面的 API 指南，附 WWDC 示例

快速决策树

“我的构建失败了” → 从 axiom:xcode-debugging 开始 → 如果是依赖项问题：axiom:build-debugging

“应用运行很慢” → 从 axiom:performance-profiling（决策树）开始 → 如果是 SwiftUI：axiom:swiftui-performance → 如果内存持续增长：axiom:memory-debugging

“内存泄漏” → 从 axiom:memory-debugging 开始 → 如果涉及 Objective-C 代码块：axiom:objc-block-retain-cycles

“SwiftUI 视图问题” → 从 axiom:swiftui-debugging 开始 → 如果是性能问题：axiom:swiftui-performance

“导航问题” → 从 axiom:swiftui-nav-diag（故障排查）开始 → 查看模式：axiom:swiftui-nav

“该选哪种数据库？” → 决策指南：axiom:sqlitedata-migration → 然后：axiom:swiftdata、axiom:sqlitedata 或 axiom:grdb

“iOS 26 设计” → 从 axiom:liquid-glass 开始 → 完整指南：axiom:liquid-glass-ref

“代码质量检查” → 运行：/axiom:audit-accessibility、/axiom:audit-concurrency、/axiom:audit-memory → 使用相关技能修复问题

技能的工作方式

Axiom 技能会自动加载——你无需记住名称或命令。

自动触发（最常见）：只需自然地描述问题。Claude 会检测适用的技能并加载。

• “我的 SwiftData CloudKit 同步无法正常工作” → 加载 cloud-sync-diag
• “我在 Swift 6 中遇到了 Sendable 错误” → 加载 swift-concurrency

显式调用：如果你知道技能名称，可以直接调用：

• /skill axiom-swift-concurrency
• /skill axiom-liquid-glass

审计命令：使用斜杠命令运行自动扫描：

• /axiom:audit-memory — 扫描内存泄漏模式
• /axiom:audit-concurrency — 扫描 Swift 6 违规项

要点：你无需知道技能名称。描述你正在处理的内容，Axiom 会自动将你引导至合适的技能。

提示

• 描述你的问题 — Claude 会推荐合适的技能
• 先运行审计 — 通过自动扫描快速发现可轻松修复的问题
• 从诊断技能入手 — 排查特定问题时
• 使用参考技能 — 实现新功能时
• 所有技能都可搜索 — 只需描述你的需求

---

总计：50 项技能、12 条审计命令，覆盖从设计到部署的完整 iOS 开发生命周期