axiom-macos について
macOS 開発向けの Axiom スキルで、ウィンドウ、メニュー、サンドボックス、配布、AppKit 連携をタスク別に案内します。macOS 固有の課題と共通の SwiftUI 領域を区別する際に役立ちます。
主な機能
- 01ウィンドウとシーン管理のガイド
- 02メニュー、コマンド、ショートカットの資料
- 03macOS SwiftUI の差分解説
- 04サンドボックスとファイルアクセスのガイド
- 05AppKit 連携の資料
- 06画面キャプチャと録画のガイド
活用シーン
- 01macOS のウィンドウやメニュー動作の実装
- 02サンドボックスのファイルアクセス問題の調査
- 03AppKit と SwiftUI の連携
- 04画面キャプチャや録画の設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ charleswiltgen/ axiom --skill axiom-macosインストール後、Claude Code で/axiom-macosを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
skills/appkit-interop.mdappkit-modernization.mddirect-distribution.mdios-apps-on-mac.mdmenus-and-commands.mdsandbox-and-file-access.mdscreencapturekit-ref.mdscreencapturekit.mdsettings.mdswiftui-differences.mdwindows.md詳細
macOS 開発
ウインドウ、メニュー、サンドボックス化、配布、AppKit とのブリッジ、macOS における SwiftUI の違いなど、macOS 固有の開発には必ずこのスキルを使用してください。
クイックリファレンス
| 症状/タスク | リファレンス |
|---|---|
| ウインドウ管理(WindowGroup、Window、MenuBarExtra、DocumentGroup) | skills/windows.md を参照 |
| メニューバー、コマンド、キーボードショートカット | skills/menus-and-commands.md を参照 |
| テーブル、インスペクタ、NavigationSplitView、フォーカス | skills/swiftui-differences.md を参照 |
| App Sandbox、ファイルアクセス、セキュリティスコープブックマーク | skills/sandbox-and-file-access.md を参照 |
プロンプトが表示されずに別のチームのアプリまたはアプリグループコンテナへのアクセスが拒否される(OS27) | skills/sandbox-and-file-access.md を参照 |
| Developer ID、公証、Sparkle の自動アップデート | skills/direct-distribution.md を参照 |
| NSViewRepresentable、NSHostingController、AppKit とのブリッジ、AppKit における @Observable、NSHostingMenu、AppKit からの SwiftUI シーン | skills/appkit-interop.md を参照 |
AppKit のモダナイズ:mouseDown の置き換え、コントロールイベント、ステータス項目のセッション、状態の復元、同心円状の角、タッチ(OS27) | skills/appkit-modernization.md を参照 |
| 画面録画、共有、またはキャプチャ(ScreenCaptureKit) | skills/screencapturekit.md を参照 |
SCStream/SCContentFilter/スクリーンショット/ファイル録画 API、クリップのバッファリング、録画エディタ(OS27) | skills/screencapturekit-ref.md を参照 |
| iOS アプリを Mac に導入する:Catalyst の採用、iPad 用に設計、Mac 対応のオプトアウト | skills/ios-apps-on-mac.md を参照 |
| Mac/Catalyst での Apple Pay | axiom-payments/skills/apple-pay.md(Catalyst のセクション)を参照 |
スイート間の参照先
これらのトピックは macOS 開発と関連しますが、別のスイートにあります。
SwiftUI(iOS/macOS 共通)
- ビューの状態、データフロー、@Observable → axiom-swiftui を参照
- ナビゲーション(NavigationStack の基本)→ axiom-swiftui(skills/nav.md)を参照
- レイアウト(ViewThatFits、AnyLayout)→ axiom-swiftui(skills/layout.md)を参照
- アニメーション → axiom-swiftui(skills/animation-ref.md)を参照
データと永続化
- SwiftData、Core Data、GRDB → axiom-data を参照
- CloudKit の同期 → axiom-data を参照
並行処理
- Swift 6 の並行処理、アクター、Sendable → axiom-concurrency を参照
その他
- アクセシビリティ(VoiceOver、Dynamic Type)→ axiom-accessibility を参照
- ネットワーキング(URLSession、Network.framework)→ axiom-networking を参照
- セキュリティ(Keychain、パスキー、暗号化)→ axiom-security を参照
競合の解決
axiom-macos と axiom-swiftui:macOS の SwiftUI アプリを開発する場合:
- macOS のみの事項には axiom-macos を使用:ウインドウ、メニュー、コマンド、サンドボックス化、配布、Table、Inspector、AppKit とのブリッジ
- クロスプラットフォームの SwiftUI には axiom-swiftui を使用:ナビゲーション、レイアウト、状態管理、アニメーション
- 両方が適用される場合があります:Table を含む NavigationSplitView を使用する macOS アプリでは、Table 固有の内容に axiom-macos を、NavigationSplitView の基本に axiom-swiftui を使用します
axiom-macos と axiom-security:サンドボックス化とコード署名について:
- macOS の App Sandbox、セキュリティスコープブックマーク、ファイルアクセスのエンタイトルメント、Developer ID 署名には axiom-macos を使用
- Keychain への保存、暗号化、パスキー、証明書管理には axiom-security を使用
判断フロー
digraph macos {
start [label="macOS development task" shape=ellipse];
what [label="What area?" shape=diamond];
start -> what;
what -> "skills/windows.md" [label="windows/scenes"];
what -> "skills/menus-and-commands.md" [label="menus/commands/shortcuts"];
what -> "skills/swiftui-differences.md" [label="Table/Inspector/focus/macOS SwiftUI"];
what -> "skills/sandbox-and-file-access.md" [label="sandbox/file access"];
what -> "skills/direct-distribution.md" [label="distribution/notarization/updates"];
what -> "skills/appkit-interop.md" [label="AppKit bridging"];
what -> "skills/appkit-modernization.md" [label="modernize AppKit\n(input/restoration/27 look)"];
what -> "skills/ios-apps-on-mac.md" [label="iOS app to Mac\n(Catalyst / Designed for iPad)"];
what -> "skills/screencapturekit.md" [label="screen capture/\nrecording/sharing"];
what -> "axiom-swiftui" [label="cross-platform SwiftUI"];
what -> "axiom-security" [label="Keychain/encryption"];
}
iOS の画面キャプチャですか? ScreenCaptureKit は macOS 専用です。iOS の画面録画には ReplayKit を使用してください — axiom-media を参照。
リソース
WWDC:2021-10062、2022-10061、2022-10075、2023-10148、2024-10149、2026-272、2026-289
ドキュメント:/security/app-sandbox、/swiftui/windowgroup、/swiftui/table
スキル:axiom-swiftui、axiom-security、axiom-concurrency、axiom-uikit
コメント
Markdown 対応