Back to Details

axiom-getting-started

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Getting Started with Axiom

Axiom 入门指南

Welcome! This skill helps new users discover the most relevant Axiom skills for their situation.
欢迎！该技能可帮助新用户找到与自身场景最匹配的Axiom技能。

How This Skill Works

该技能的工作原理

  1. Ask the user 2-3 targeted questions about their project
  2. Provide personalized skill recommendations (3-5 skills max)
  3. Show example prompts they can try immediately
  4. Include a complete skill reference for browsing
  1. 向用户询问2-3个关于其项目的针对性问题
  2. 提供个性化的技能推荐（最多3-5个技能）
  3. 展示可立即尝试的示例提示词
  4. 包含完整的技能参考供浏览

Step 1: Ask Questions

步骤1：询问问题

Use the AskUserQuestion tool to gather context:
使用AskUserQuestion工具收集上下文信息：

Question 1: Current Focus

问题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
问题："你今天使用Axiom的目的是什么？"
标题："关注点"
选项：
- "调试问题" → 优先推荐诊断类技能
- "优化性能" → 优先推荐性能分析类技能
- "添加新功能" → 优先推荐参考类技能
- "代码审查/质量检查" → 优先推荐审计命令
- "只是探索" → 展示技能概览

Question 2: Tech Stack

问题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
问题："你的主要技术栈是什么？"
标题："技术栈"
选项：
- "SwiftUI (iOS 16+)" → 优先推荐SwiftUI相关技能
- "UIKit" → 优先推荐UIKit相关技能
- "SwiftUI + UIKit 混合" → 两者都推荐
- "启动新项目" → 优先推荐最佳实践类技能

Question 3: Pain Points (Optional, Multi-Select)

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

Only ask if "Debugging an issue" was selected:
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"
仅当用户选择了"调试问题"时才询问：
问题："你正在哪些方面遇到困难？"
标题："痛点"
多选：是
选项：
- "Xcode/构建问题"
- "内存泄漏"
- "UI/动画问题"
- "数据库/持久化"
- "网络"
- "并发/异步"
- "无障碍访问"

Step 2: Provide Personalized Recommendations

步骤2：提供个性化推荐

Based on answers, recommend 3-5 skills using this matrix:
根据用户的回答，使用以下矩阵推荐3-5个技能：

If "Debugging an issue"

如果用户选择"调试问题"

Always recommend: axiom:xcode-debugging (universal starting point)
Then add based on pain points:
  • Xcode/build → xcode-debugging, axiom-build-debugging
  • Memory leaks → memory-debugging, axiom-objc-block-retain-cycles
  • UI/animation (SwiftUI) → swiftui-debugging, axiom-swiftui-performance
  • UI/animation (UIKit) → uikit-animation-debugging, axiom-auto-layout-debugging
  • Database → database-migration, axiom-sqlitedata-migration (decision guide)
  • Networking → networking, axiom-networking-diag
  • Concurrency → swift-concurrency
  • Accessibility → accessibility-diag
必推荐：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

If "Optimizing performance"

如果用户选择"优化性能"

SwiftUI stack:
  1. performance-profiling (decision trees for tools)
  2. swiftui-performance (SwiftUI Instrument)
  3. swiftui-debugging (view update issues)
UIKit/Mixed:
  1. performance-profiling (Instruments guide)
  2. memory-debugging (leak detection)
  3. uikit-animation-debugging (CAAnimation issues)
SwiftUI 技术栈：
  1. performance-profiling（工具决策树）
  2. swiftui-performance（SwiftUI 性能分析工具）
  3. swiftui-debugging（视图更新问题排查）
UIKit/混合技术栈：
  1. performance-profiling（Instruments 指南）
  2. memory-debugging（泄漏检测）
  3. uikit-animation-debugging（CAAnimation 问题排查）

If "Adding new features"

如果用户选择"添加新功能"

Design decisions:
  • hig (quick design decisions, checklists)
  • hig-ref (comprehensive HIG reference)
iOS 26+ features:
  • liquid-glass (material design system)
  • foundation-models (on-device AI)
  • swiftui-26-ref (complete iOS 26 guide)
Navigation patterns:
  • swiftui-nav (iOS 18+ Tab/Sidebar, deep linking)
  • swiftui-nav-ref (comprehensive API reference)
Integrations:
  • app-intents-ref (Siri, Shortcuts, Spotlight)
  • networking (Network.framework modern patterns)
Data persistence:
  • Ask: "Which persistence framework?" → swiftdata, axiom-sqlitedata, or grdb
  • Migration: axiom-sqlitedata-migration, axiom-realm-migration-ref
设计决策：
  • hig（快速设计决策、检查清单）
  • hig-ref（全面的HIG参考）
iOS 26+ 功能：
  • liquid-glass（材质设计系统）
  • foundation-models（设备端AI）
  • swiftui-26-ref（完整的iOS 26指南）
导航模式：
  • swiftui-nav（iOS 18+ 标签栏/侧边栏、深度链接）
  • swiftui-nav-ref（全面的API参考）
集成：
  • app-intents-ref（Siri、快捷指令、聚焦搜索）
  • networking（Network.framework 现代模式）
数据持久化：
  • 询问："使用哪个持久化框架？" → swiftdata, axiom-sqlitedata, 或 grdb
  • 迁移：axiom-sqlitedata-migration, axiom-realm-migration-ref

If "Code review / quality check"

如果用户选择"代码审查/质量检查"

Start with audit commands (quick wins):
  1. /axiom:audit-accessibility
    — WCAG compliance
  2. /axiom:audit-concurrency
    — Swift 6 violations
  3. /axiom:audit-memory
    — Leak patterns
  4. /axiom:audit-core-data
    — Migration safety
  5. /axiom:audit-networking
    — Deprecated APIs
Then suggest:
  • Review skills based on what audits find
从审计命令开始（快速见效）：
  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检查
然后推荐：
  • 根据审计结果推荐对应技能

If "Just exploring"

如果用户选择"只是探索"

Show the complete skill index (see below) and explain categories.
展示完整的技能索引（见下文）并解释分类。

Step 3: Output Format

步骤3：输出格式

After gathering answers, output:
markdown
undefined
收集完回答后，按以下格式输出：
markdown
undefined

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]
axiom:[技能名称] — [一句话描述]
尝试："[可立即使用的示例提示词]"
[重复3-5个技能]

Quick Wins

快速见效方案

Run these audit commands to find issues automatically:
  • /axiom:audit-[name]
    — [What it finds]
运行以下审计命令自动发现问题：
  • /axiom:audit-[名称]
    — [检查内容]

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]
undefined
  1. 尝试上述示例提示词 — 复制粘贴即可体验技能功能
  2. 运行审计命令 — 立即获取可执行的洞察
  3. 描述你的问题 — 我会为你推荐合适的技能
  4. 浏览下方完整索引 — 探索全部34个技能
[下方附上完整技能参考]
undefined

Complete Skill Reference

完整技能参考

Include this reference section in every response for browsing:
每次回复都需包含以下参考部分供浏览：

Debugging & Troubleshooting

调试与故障排查

Environment & Build Issues
  • xcode-debugging — BUILD FAILED, simulator hangs, zombie processes, environment-first diagnostics
  • build-debugging — Dependency conflicts, CocoaPods/SPM failures, Multiple commands produce
Memory & Performance
  • memory-debugging — Memory growth, retain cycles, leak diagnosis with Instruments
  • performance-profiling — Decision trees for Instruments (Time Profiler, Allocations, Core Data, Energy)
  • objc-block-retain-cycles — Objective-C block memory leaks, weak-strong pattern
UI Debugging
  • swiftui-debugging — View update issues, struct mutation, binding identity, view recreation
  • swiftui-performance — SwiftUI Instrument (iOS 26), long view bodies, Cause & Effect Graph
  • uikit-animation-debugging — CAAnimation completion, spring physics, gesture+animation jank
  • auto-layout-debugging — Auto Layout conflicts, constraint debugging (not yet in manifest)
环境与构建问题
  • xcode-debugging — 构建失败、模拟器卡顿、僵尸进程、环境优先诊断
  • build-debugging — 依赖冲突、CocoaPods/SPM 失败、多命令重复输出
内存与性能
  • memory-debugging — 内存增长、引用循环、使用Instruments诊断泄漏
  • performance-profiling — Instruments决策树（时间分析器、内存分配、Core Data、能耗）
  • objc-block-retain-cycles — Objective-C 块内存泄漏、weak-strong 模式
UI调试
  • swiftui-debugging — 视图更新问题、结构体突变、绑定标识、视图重建
  • swiftui-performance — SwiftUI Instrument（iOS 26）、长视图体、因果图
  • uikit-animation-debugging — CAAnimation 完成回调、弹簧物理、手势+动画卡顿
  • auto-layout-debugging — 自动布局冲突、约束调试（暂未在清单中）

Concurrency & Async

并发与异步

  • swift-concurrency — Swift 6 strict concurrency, @concurrent, actor isolation, Sendable, data races
  • swift-concurrency — Swift 6 严格并发、@concurrent、Actor隔离、Sendable、数据竞争

UI & Design (iOS 26+)

UI 与设计（iOS 26+）

Liquid Glass (Material Design)
  • liquid-glass — Implementation, Regular vs Clear variants, design review defense
  • liquid-glass-ref — Complete app-wide adoption guide (icons, controls, navigation, windows)
Layout & Navigation
  • swiftui-layout — ViewThatFits vs AnyLayout vs onGeometryChange, decision trees, iOS 26 free-form windows
  • swiftui-layout-ref — Complete layout API reference
  • swiftui-nav — NavigationStack vs NavigationSplitView, deep links, coordinator patterns, iOS 18+ Tab/Sidebar
  • swiftui-nav-ref — Comprehensive navigation API reference
  • swiftui-nav-diag — Navigation not responding, unexpected pops, deep link failures, state loss
Liquid Glass（材质设计）
  • liquid-glass — 实现方案、常规/透明变体、设计评审辩护
  • liquid-glass-ref — 全应用适配完整指南（图标、控件、导航、窗口）
布局与导航
  • swiftui-layout — ViewThatFits vs AnyLayout vs onGeometryChange、决策树、iOS 26 自由形式窗口
  • swiftui-layout-ref — 完整的布局API参考
  • swiftui-nav — NavigationStack vs NavigationSplitView、深度链接、协调器模式、iOS 18+ 标签栏/侧边栏
  • swiftui-nav-ref — 全面的导航API参考
  • swiftui-nav-diag — 导航无响应、意外返回、深度链接失败、状态丢失

Testing

测试

  • ui-testing — Recording UI Automation (Xcode 26), condition-based waiting, accessibility-first patterns
  • ui-testing — 录制UI自动化（Xcode 26）、基于条件的等待、无障碍优先模式

Persistence

持久化

Frameworks
  • swiftdata — @Model, @Query, @Relationship, CloudKit, iOS 26 features, Swift 6 concurrency
  • sqlitedata — Point-Free SQLiteData, @Table, FTS5, CTEs, JSON aggregation, CloudKit sync
  • grdb — Raw SQL, complex joins, ValueObservation, DatabaseMigrator, performance
  • database-migration — Safe schema evolution for SQLite/GRDB, additive migrations, prevents data loss
Migration Guides
  • sqlitedata-migration — Decision guide, pattern equivalents, performance benchmarks
  • realm-migration-ref — Realm → SwiftData migration (Realm Device Sync sunset Sept 2025)
框架
  • swiftdata — @Model、@Query、@Relationship、CloudKit、iOS 26 功能、Swift 6 并发
  • sqlitedata — Point-Free SQLiteData、@Table、FTS5、CTEs、JSON聚合、CloudKit同步
  • grdb — 原生SQL、复杂连接、ValueObservation、DatabaseMigrator、性能
  • database-migration — SQLite/GRDB 安全模式演进、增量迁移、防止数据丢失
迁移指南
  • sqlitedata-migration — 决策指南、模式等效性、性能基准
  • realm-migration-ref — Realm → SwiftData 迁移（Realm Device Sync 将于2025年9月停止服务）

Networking

网络

  • networking — Network.framework (iOS 12-26), NetworkConnection (iOS 26), structured concurrency
  • networking-diag — Connection timeouts, TLS failures, data not arriving, performance issues
  • network-framework-ref — Complete API reference, TLV framing, Coder protocol, Wi-Fi Aware
  • networking — Network.framework（iOS 12-26）、NetworkConnection（iOS 26）、结构化并发
  • networking-diag — 连接超时、TLS失败、数据未到达、性能问题
  • network-framework-ref — 完整的API参考、TLV帧、Coder协议、Wi-Fi感知

Apple Intelligence (iOS 26+)

Apple Intelligence（iOS 26+）

  • foundation-models — On-device AI, LanguageModelSession, @Generable, streaming, tool calling
  • foundation-models-diag — Context exceeded, guardrails, slow generation, availability issues
  • foundation-models-ref — Complete API reference, all 26 WWDC examples
  • foundation-models — 设备端AI、LanguageModelSession、@Generable、流式传输、工具调用
  • foundation-models-diag — 上下文超出限制、防护机制、生成缓慢、可用性问题
  • foundation-models-ref — 完整的API参考、WWDC 26全部示例

Design & UI Guidelines

设计与UI指南

  • hig — Quick design decisions, color/background/typography choices, HIG compliance checklists
  • hig-ref — Comprehensive Human Interface Guidelines reference with code examples
  • hig — 快速设计决策、颜色/背景/排版选择、HIG合规性检查清单
  • hig-ref — 包含代码示例的全面人机界面指南参考

Integrations

集成

  • app-intents-ref — Siri, Apple Intelligence, Shortcuts, Spotlight (iOS 16+)
  • swiftui-26-ref — iOS 26 SwiftUI features, @Animatable, 3D layout, WebView, AttributedString
  • avfoundation-ref — Audio APIs, bit-perfect DAC, iOS 26 spatial audio, ASAF/APAC
  • app-intents-ref — Siri、Apple Intelligence、快捷指令、聚焦搜索（iOS 16+）
  • swiftui-26-ref — iOS 26 SwiftUI功能、@Animatable、3D布局、WebView、AttributedString
  • avfoundation-ref — 音频API、比特完美DAC、iOS 26空间音频、ASAF/APAC

Diagnostics (Systematic Troubleshooting)

诊断（系统性故障排查）

  • accessibility-diag — VoiceOver, Dynamic Type, color contrast, WCAG compliance, App Store defense
  • core-data-diag — Schema migration crashes, thread-confinement, N+1 queries
  • accessibility-diag — VoiceOver、动态字体、颜色对比度、WCAG合规性、App Store申诉
  • core-data-diag — 模式迁移崩溃、线程限制、N+1查询

Audit Commands (Quick Scans)

审计命令（快速扫描）

  • /axiom:audit-accessibility
    — VoiceOver labels, Dynamic Type, contrast, touch targets
  • /axiom:audit-concurrency
    — Swift 6 violations, unsafe tasks, missing @MainActor
  • /axiom:audit-memory
    — Timer leaks, observer leaks, closure captures, delegate cycles
  • /axiom:audit-core-data
    — Migration risks, thread violations, N+1 queries
  • /axiom:audit-networking
    — Deprecated APIs (SCNetworkReachability, CFSocket), anti-patterns
  • /axiom:audit-liquid-glass
    — Glass adoption opportunities, toolbar improvements, blur migration
  • /axiom:audit-accessibility
    — VoiceOver标签、动态字体、对比度、触摸目标
  • /axiom:audit-concurrency
    — Swift 6违规、不安全任务、缺失@MainActor
  • /axiom:audit-memory
    — 定时器泄漏、观察者泄漏、闭包捕获、代理循环
  • /axiom:audit-core-data
    — 迁移风险、线程违规、N+1查询
  • /axiom:audit-networking
    — 废弃API（SCNetworkReachability、CFSocket）、反模式
  • /axiom:audit-liquid-glass
    — Glass适配机会、工具栏改进、模糊效果迁移

Skill Categories Explained

技能分类说明

  • Discipline skills (no suffix) — Step-by-step workflows with pressure scenarios, TDD-tested
  • Diagnostic skills (-diag suffix) — Systematic troubleshooting with production crisis defense
  • Reference skills (-ref suffix) — Comprehensive API guides with WWDC examples
  • 专业技能（无后缀）—— 包含压力场景的分步工作流，经过TDD测试
  • 诊断技能（-diag后缀）—— 包含生产危机应对的系统性故障排查
  • 参考技能（-ref后缀）—— 包含WWDC示例的全面API指南

Quick Decision Trees

快速决策树

"My build is failing" → Start: axiom:xcode-debugging → If dependency issue: axiom:build-debugging
"App is slow" → Start: axiom:performance-profiling (decision trees) → If SwiftUI: axiom:swiftui-performance → If memory grows: axiom:memory-debugging
"Memory leak" → Start: axiom:memory-debugging → If Objective-C blocks: axiom:objc-block-retain-cycles
"SwiftUI view issues" → Start: axiom:swiftui-debugging → If performance: axiom:swiftui-performance
"Navigation problems" → Start: axiom:swiftui-nav-diag (troubleshooting) → For patterns: axiom:swiftui-nav
"Which database?" → Decision guide: axiom:sqlitedata-migration → Then: axiom:swiftdata, axiom:sqlitedata, or axiom:grdb
"iOS 26 design" → Start: axiom:liquid-glass → Complete guide: axiom:liquid-glass-ref
"Code quality check" → Run: 
/axiom:audit-accessibility
, 
/axiom:audit-concurrency
, 
/axiom:audit-memory
→ Fix issues with relevant skills
"我的构建失败了" → 从 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
→ 根据问题使用对应技能修复

Tips

小贴士

  • Describe your problem — Claude will suggest the right skill
  • Run audits first — Quick wins with automated scans
  • Start with diagnostic skills — When troubleshooting specific issues
  • Use reference skills — When implementing new features
  • All skills are searchable — Just describe what you need
Total: 50 skills, 12 audit commands, covering the complete iOS development lifecycle from design to deployment
  • 描述你的问题 — Claude会为你推荐合适的技能
  • 先运行审计命令 — 通过自动扫描快速找到问题
  • 从诊断技能开始 — 排查特定问题时
  • 使用参考技能 — 实现新功能时
  • 所有技能都可搜索 — 只需描述你的需求
总计：50个技能，12条审计命令，覆盖从设计到部署的完整iOS开发生命周期