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 以降のタブ／サイドバー、ディープリンク）
• 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 — ビューの更新に関する問題、構造体の変更、バインディングの ID、ビューの再生成
• swiftui-performance — SwiftUI Instrument（iOS 26）、長いビュー本体、Cause & Effect Graph
• uikit-animation-debugging — CAAnimation の完了、スプリング物理、ジェスチャーとアニメーションのカクつき
• auto-layout-debugging — Auto Layout の競合、制約のデバッグ（マニフェストにはまだ未掲載）

並行処理と非同期処理

• swift-concurrency — Swift 6 の厳格な並行処理、@concurrent、アクター分離、Sendable、データ競合

UI とデザイン（iOS 26 以降）

Liquid Glass（マテリアルデザイン）

• 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 Automation の記録（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 リファレンス、WWDC の全 26 個の例

デザインと 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、Dynamic Type、色のコントラスト、WCAG 準拠、App Store 審査への対応
• core-data-diag — スキーママイグレーションのクラッシュ、スレッド制約、N+1 クエリ

監査コマンド（クイックスキャン）

• /axiom:audit-accessibility — VoiceOver ラベル、Dynamic Type、コントラスト、タッチターゲット
• /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 の導入機会、ツールバーの改善、ぼかしの移行

スキルカテゴリの説明

• 分野別スキル（接尾辞なし） — プレッシャーのかかるシナリオを含むステップごとのワークフロー、TDD で検証済み
• 診断スキル（-diag 接尾辞） — 本番環境の危機への対応を含む体系的なトラブルシューティング
• リファレンススキル（-ref 接尾辞） — WWDC の例を含む包括的な API ガイド

クイック決定ツリー

「ビルドに失敗します」 → 開始：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 開発のライフサイクル全体をカバーします