mcpField
A
apple-intelligence

apple-intelligence

github.com/rshankras開発838519 回インストール14 週間前に更新
リポジトリ

apple-intelligence について

アプリに Apple Intelligence の機能を追加する開発者向けのスキル集です。オンデバイス LLM、ビジュアルインテリジェンス、App Intents に加え、Siri、Shortcuts、Spotlight、構造化出力、モデルの安全性を扱います。

主な機能

  1. 01オンデバイスモデル統合とプロンプト設計
  2. 02構造化出力とツール呼び出し
  3. 03カメラベースのビジュアルインテリジェンス
  4. 04Siri・Shortcuts・Spotlight 向け App Intents
  5. 05モデルの利用可否と安全性の指針

活用シーン

  1. 01アプリへのオンデバイステキスト生成の追加
  2. 02Siri や Shortcuts を通じたアプリ操作の提供
  3. 03Spotlight で検索できるアプリコンテンツの作成
  4. 04カメラベースのビジュアル検索の構築

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/rshankras/claude-code-apple-skills --skill apple-intelligence

インストール後、Claude Code で/apple-intelligenceを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

app-intents/
advanced-features.md
entities-spotlight.md
intents-basics.md
foundation-models/
models-and-agents.md
safety-and-guardrails.md
utilities-package.md

詳細

Apple Intelligence スキル

オンデバイス LLM、視覚認識、App Intents との統合、インテリジェントアシスタントなど、Apple Intelligence の機能を実装するためのスキルです。

このスキルが有効になる場合

次のような場合にこのスキルを使用します。

  • アプリに AI／LLM 機能を追加したい
  • オンデバイスでのテキスト生成や理解が必要
  • Foundation Models や Apple Intelligence について質問している
  • 構造化された AI 出力を実装したい
  • プロンプトエンジニアリングのガイダンスが必要
  • カメラを使った視覚インテリジェンス機能を実装したい
  • App Intents を介して Siri、Shortcuts、Spotlight と統合したい
  • アプリのアクションやコンテンツをシステムに公開したい

利用可能なスキル

foundation-models/

プロンプトエンジニアリングのベストプラクティスを含む、オンデバイス LLM の統合です。

  • モデルの利用可否の確認
  • セッション管理
  • @Generable による構造化出力（プロパティ順序とスキーマ注入のルール）
  • ツール呼び出しのパターン
  • スナップショットストリーミング
  • プロンプトエンジニアリングの手法
  • safety-and-guardrails.md — モデルの制限、プロンプトより指示を優先する階層、ガードレールの処理、4 層の安全性スタック、評価
  • models-and-agents.md — Private Cloud Compute、LanguageModel プロトコル（サードパーティのバックエンド）、ビジョン入力、DynamicProfile エージェント、ツール呼び出しモード、KV キャッシュのルール
visual-intelligence/

カメラを使った検索のために、iOS の Visual Intelligence と統合します。

  • IntentValueQuery の実装
  • SemanticContentDescriptor の処理
  • 検索可能なコンテンツのための AppEntity
  • 表示表現
  • 検索結果からのディープリンク
app-intents/

Siri、Shortcuts、Spotlight、Apple Intelligence 向けの App Intents です。

  • AppIntent プロトコル、パラメーター、perform()
  • AppEntity とエンティティクエリ
  • 音声フレーズを使った App Shortcuts
  • IndexedEntity と Spotlight のインデックス作成
  • インテントのモード（バックグラウンド、フォアグラウンド）
  • SnippetIntent によるインタラクティブなスニペット
  • 視覚インテリジェンスとの統合
  • Siri／ChatGPT 向けのオンスクリーンエンティティ
  • 多肢選択 API
  • Swift パッケージのサポート

主な原則

1. プライバシーを最優先
  • デフォルトではオンデバイスで処理します。Private Cloud Compute はプロンプトを保存せずに処理能力を拡張します（アカウント／API キー不要 — WWDC26 241）
  • プライバシー保護がより弱いバックエンドにルーティングする場合は、まずコンテキストを削除または伏せ字にします（foundation-models/models-and-agents.md を参照）
2. 適切に機能を縮退させる
  • モデルの利用可否を必ず確認します
  • 対応していないデバイス向けにフォールバック UI を用意します
  • エラーを適切に処理します（ガードレール違反も含みます。先回りして実行する機能では通知せず、ユーザーが開始した操作では理由を説明します）
3. 効率的なプロンプト
  • プロンプトは焦点を絞り、具体的にします
  • 可能な場合は構造化出力を使用します
  • コンテキストウィンドウの制限を守ります。model.contextSize を照会し、値をハードコードしないでください（第 1 世代のオンデバイスモデルは 4,096、iOS 27 のオンデバイスモデルは 8,192、Private Cloud Compute は 32,000）

参考ドキュメント

  • Foundation Models
  • Visual Intelligence
  • App Intents
  • ローカルに保存したドキュメント（任意）：~/Downloads/docs/ に FoundationModels-Using-on-device-LLM-in-your-app.md、Implementing-Visual-Intelligence-in-iOS.md、または AppIntents-Updates.md がある場合は、詳細を確認するために読み込みます。見つからない場合は、何も表示せずにスキップします。

コメント

Markdown 対応