Macショートカット自動化：実践者のためのリファレンス（2026）

要約： Shortcuts は macOS Monterey（2021年）以降、すべての Mac に搭載されています。そして macOS Tahoe（26）でついに、Mac の自動化を手がけるユーザーが4年間待ち望んでいた機能が加わりました。フォルダの変更、外付けドライブ、Wi-Fi、ディスプレイ、アプリの起動などをトリガーとするパーソナルオートメーションです。³⁴ メニューバー、Spotlight、Finder の Quick Actions、キーボードショートカットに加え、本格的なコマンドラインツール（shortcuts run、list、view、sign）からショートカットを実行できます。¹² どのアプリでも App Intents フレームワークを通じてアクションを追加でき、これは Siri、Spotlight、Apple Intelligence から呼び出されるものと同じインターフェースです。¹³ スクリプトや AI エージェントからショートカットを操作する方法は3つあります。CLI、shortcuts:// URL scheme、そしてスクリプトから操作可能なバックグラウンドプロセス Shortcuts Events です。¹⁹¹¹ 最初に理解しておくべきなのは権限モデルです。アプリ上では見えない同意プロンプトが、無人実行を通知なく停止させることがあります。

Apple は WWDC 2021 で、開発者に対して「Shortcuts is the future of Mac automation」と宣言しました。⁵ その未来は2段階に分かれて到来しました。前半はすぐに実現しています。macOS Monterey には、iCloud 同期、Automator 移行ツール、エディタ内でのシェルスクリプトと AppleScript の完全なサポートを備えたネイティブ SwiftUI アプリが搭載されました。⁵ 後半の実現には、さらに4回の macOS リリースを要しました。macOS Tahoe より前の Mac では、ショートカットは何かから明示的に呼び出されたときにしか実行されませんでした。トリガーがなかったため、「自動化」といってもクリックを忘れないようにする必要があったのです。Tahoe は、Mac 向けに設計されたパーソナルオートメーション（フォルダと外付けドライブのトリガー）を、使い慣れた iOS のトリガー（時刻、Bluetooth）とともに導入し、この隔たりを解消しました。さらに、ショートカットのデータフローに Apple Intelligence を組み込む Use Model アクションも追加されています。³⁴

その結果、きちんと学ぶだけの価値があるシステムになりました。2026年の Mac における Shortcuts は、次の4つの役割を同時に担っています。

1. ノーコードエディタ：ファイル操作やウインドウ管理からオンデバイス AI まで、数百もの組み込みアクションを備えています
2. 自動化エンジン：macOS Tahoe で新たに追加されたシステムイベントのトリガーを利用できます
3. コマンドラインの一員：shortcuts run は、stdin、stdout、終了コード、パイプを備え、ほかの Unix ツールと同じように動作します¹
4. あらゆるアプリのアクションレジストリ：アプリが App Intents を通じて公開した機能はすべて、ほかのプラットフォームと同様に Mac の Shortcuts にも自動的に表示されます¹³⁴

基本的な使い方と高度な活用を分けるのは、5つの仕組みです。アクションカタログ（何ができるのか）、自動化トリガー（いつ実行するのか）、CLI とスクリプティングブリッジ（コードからどう呼び出すのか）、署名と共有（ショートカットをどう配布するのか）、そして権限モデル（なぜ無人実行が停止するのか）です。以下では、それぞれを個別に取り上げます。

このガイドの記述はすべて、Apple のドキュメント、WWDC セッション、または執筆に使用したマシン上の macOS 26.5（Shortcuts 7.0）を直接調査した結果に基づいています。オペレーティングシステム自体から確認した事実（shortcuts(1) の man ページ、Shortcuts Events のスクリプティング辞書、WorkflowKit フレームワークのアクション）については、その旨を引用に明記しています。

主なポイント

• 自動化が最大の目玉です。 macOS Tahoeでは、フォルダの変更、外部ドライブ、ディスプレイ、Wi-Fi、Bluetooth、Stage Manager、アプリの起動／終了、時刻などをトリガーにするパーソナル自動化がMacに導入されました。各自動化は即時実行または確認後に実行できます。³⁴
• CLIは実用的な機能であり、おもちゃではありません。 shortcuts run "Name" -i input -o output はstdin（-i -）、stdout（-o -）、Uniform Type Identifiersによる型付き出力をサポートし、成功時は0、エラー時は1で終了します。ほかのUnixツールと同じようにパイプできます。¹²
• スクリプトからの入口は3つ、ルールは1つです。 シェルやCIからはCLIを使い、shortcuts:// URL schemeはほかのアプリからのみ使います。アプリを開かずにスクリプト環境で結果を受け取りたい場合は、Shortcuts Events（AppleScript/ScriptingBridge）を使います。¹⁹¹¹
• 配布には署名が必要です。 .shortcut ファイルを配布するには署名が必要です。shortcuts sign -m anyone はiCloud経由で公証し、誰でも読み込めるようにします。デフォルトの people-who-know-me モードはローカルで署名し、Contactsに登録している人にのみ読み込みを制限します。²⁷
• App Intentsが開発者向けの接点です。 App Intentsを提供するアプリは、Mac向けのShortcuts actionsを追加作業なしで利用でき、それらのintentはSpotlightや自動化でも使われます。Apple silicon MacにインストールしたiOSアプリも対象です。⁴¹³
• 失敗しやすいのは同意です。 Shortcutsはショートカットごと、データタイプごとに「Allow Once」／「Always Allow」／「Don’t Allow」を確認します。スクリプト実行actionsは、グローバルの「Allow Running Scripts」スイッチの背後にあります。回答されていないプロンプトに遭遇したヘッドレス実行は、そのまま待機します。¹⁶⁸

このガイドの使い方

目次

第1部：基礎

1. MacのShortcutsとは
2. ショートカットを実行する方法
3. Shortcuts vs Automator vs AppleScript

第2部：Actions

1. Actionsを組み合わせる仕組み
2. Actionsカタログ
3. Scripting Actions
4. ウインドウ管理actions
5. Use Model action

第3部：自動化

1. macOSの自動化トリガー
2. 実用的な自動化パターン

第4部：コマンドラインとURL Schemes

1. shortcuts CLI
2. Shortcuts Eventsでアプリをスクリプト操作する
3. URL Schemes

第5部：共有と配布

1. 共有形式と署名

第6部：開発者向けの接点

1. App Intents：アプリがactionsを追加する仕組み
2. Spotlightと自動化でintentを実行する
3. スクリプトとエージェントからShortcutsを操作する

第7部：運用と参照

1. 権限と同意（TCC）
2. トラブルシューティング
3. クイックリファレンスカード
4. FAQ
5. 変更履歴
6. 参照

MacのShortcutsとは

ShortcutsはAppleの自動化アプリです。actions（単一目的のステップ）を連結して、shortcut（保存済みのワークフロー）を作成し、クリック、音声、キーストローク、トリガー、またはコマンドラインで実行します。Apple自身による定義は、設計全体を説明しているため覚えておく価値があります。「An action is the building block of a shortcut. Each shortcut comprises a series of actions, and each action is a single step that performs a particular function.」¹²

このアプリは2021年、macOS MontereyでiOSからMacへ導入されました。両プラットフォームで同じコードベースを使えるよう、ほぼ全面的にSwiftUIで書かれています。⁵ 初回リリース時の3つの設計判断は、2026年のMac体験にも引き続き影響しています。

• iCloud同期がデフォルトです。 新しいMacでShortcutsを開くと、iPhoneやiPadから同期された既存のライブラリが表示されます。1台のデバイスで作成したショートカットは、プラットフォーム固有のactionsを除き、ほかのデバイスでも実行できます。⁵¹²
• アプリがactionsを提供します。 「Like on iOS, any app on the Mac can provide actions to Shortcuts.」⁵ 2026年には、この仕組みを担う開発者向けフレームワークがApp Intentsです。第6部で扱います。
• スクリプトは第一級の機能です。 Montereyには「AppleScripts and Shell Scriptingの完全なサポート」と、「Shortcutsエディタ内で直接スクリプトを書いて実行できる、Shortcutsに組み込まれた新しいactions」が搭載されました。そのためShortcutsは、従来の自動化スタックを置き換えるのではなく包み込みます。⁵

Montereyで提供されなかったのはトリガーです。2021年から2024年まで、Macのショートカットは何かが呼び出したときにのみ実行されました。macOS Tahoe（26）は、デスクトップのワークフロー向けに設計されたトリガータイプ（フォルダ内容の変更、外部ドライブの接続）と、既存のiOS向けセットを備えたパーソナル自動化を2025年にMacへ導入し、これを変えました。³⁴ Tahoeでは、ショートカットの途中でデータをApple Intelligenceモデルに送るUse Model actionも追加されました。³⁴

バージョンごとの主な変更点：

このガイド全体で「macOS 26.5で検証済み」とは、執筆に使用したMac上のShortcuts 7.0で直接確認したことを意味します。

ショートカットを実行する方法

MacのShortcutsは、実行の入口が非常に豊富です。以下はすべて同じショートカットを呼び出します。異なるのは入力の取得元と出力先です。¹²¹⁰

後で時間を節約できるポイントが2つあります。まず、Quick ActionとServicesのエントリは現在の選択項目をショートカット入力として受け取ります。そのため、ファイル処理用ショートカットではテキストを前提にするのではなく、受け付ける入力タイプ（エディタの「Receive」設定）を宣言する必要があります。次に、最後の3行はプログラムから利用するための接点です。入出力の契約が異なるため、それぞれ専用の節で扱います。

Shortcuts vs Automator vs AppleScript

Appleの3つの自動化システムは、2026年現在もすべてmacOSに搭載されており（AutomatorはmacOS 26.5の/System/Applicationsに引き続き存在することを確認済み）、それぞれに役割があります。実態に即して整理すると、Shortcutsは統合レイヤー、AppleScriptはアプリ制御言語、シェルスクリプトは計算処理レイヤーです。Automatorはメンテナンス段階にあり、機能は維持されているものの変更はなく、後継がShortcutsであることも明示されています。⁵¹⁴

移行手段は実在しますが、細部では完全ではありません。 AppleはShortcutsに変換機能を組み込んでいます。.workflowファイルをアプリへドラッグするか、Controlキーを押しながらクリックして「Open With」→「Shortcuts」を選ぶと、「Shortcutsは、ほとんどのAutomatorワークフローを、同じ機能、イベント、自動化を実行するショートカットへ変換できます」。¹⁴¹⁵ 「ほとんど」はApple自身の表現です。実用上は、標準的なファイル、画像、テキストのアクションは問題なく変換できますが、利用例の少ないサードパーティ製AutomatorアクションやWatch Me Doの記録では変換品質が低下します。この互換性を保つ取り組みの一環として、Shortcutsの内部にはWatch Me Doというアクション名まで残っています（macOS 26.5のフレームワーク内にあるアクションテーブルで確認済み）。¹⁶

Shortcuts以外を使うべき場面。 アプリごとの詳細な制御（Mailメッセージの反復処理、Finderウインドウのプログラムによる操作、充実したスクリプティング辞書を備えたアプリの制御）は、今もAppleScriptの得意分野です。複雑なテキスト処理、APIのオーケストレーション、そして通常ならPythonやzshで記述する処理は、スクリプトに適しています。実践では、どれか1つに固執するのではなく、組み合わせることが重要です。トリガーから入力を収集するショートカットを用意し、負荷の高い処理をシェルスクリプトへ渡し、通知やファイル配置にはネイティブアクションを使えば、それぞれの長所を引き出せます。仕組みについては、スクリプティングアクションのセクションで説明します。

アクションを組み合わせる仕組み

すべてのショートカットはパイプラインです。各アクションは入力（多くの場合は直前のアクションの出力）を受け取り、1つの処理を行い、結果を出力します。このパイプラインに表現力を与える仕組みは3つあります。

• Magic variables。 各アクションの出力は、宣言しなくても変数として後続のアクションから自動的に利用できます。パラメータ欄をクリックしてSelect Magic Variableを選び、それより前にある任意のアクションの出力を指定します。明示的に名前を付けるためのSet VariableとGet Variable、リストへ追加していくためのAdd to Variableもあります（いずれも組み込みアクションであり、macOS 26.5で確認済み）。¹⁶
• 必要に応じて変換されるコンテンツタイプ。 アクションには、受け入れ可能なデータ（ファイル、画像、テキスト、URL、日付）が定義されています。出力と入力の型が異なる場合、Shortcutsは可能な範囲で自動変換します。たとえばWebページをテキストアクションへ渡すと、ページ内のテキストを取得できます。ショートカット上部にあるエディタの「Receive」設定では、ショートカット全体がQuick Actions、Services、またはCLIの--input-pathから受け入れるデータを指定します。
• アクションとしてのフロー制御。 If、Repeat、Repeat with Each、Choose from Menu、Wait to Return、Stop This Shortcut、Stop and Outputは、いずれも通常のアクションです。¹⁶ なかでもStop and Outputは、Macで特に重要です。ショートカットがコマンドライン、パイプ、または呼び出し元のスクリプトへ返す内容を定義します。¹

組み合わせの基本となるのがRun Shortcutです。入力を渡し、名前を指定して別のショートカットを呼び出せます。¹⁶ Appleも、ショートカットの入れ子にはURL schemeではなく、このアクションを使うよう明示しています。「あるショートカットから別のショートカットを実行する場合は、URL schemeではなくRun Shortcutアクションを使用してください」。⁹ ショートカットは関数のように扱いましょう。ファイル名を正規化する、webhookへ投稿する、サムネイル用にサイズを変更するといった、小さく単一目的のショートカットを調整役のショートカットで組み合わせる方が、60個のアクションを詰め込んだ1つの巨大なショートカットよりはるかに拡張しやすくなります。各要素はCLIから個別にテストすることも可能です。

アクションカタログ

組み込みライブラリは大規模です。Shortcutsを支えるプライベートフレームワークである、macOS 26.5のWorkflowKitフレームワーク内の英語文字列テーブルには、361個の異なるアクション名が記載されています。¹⁶ ただし、この数字はエディタに表示される数より多めです。テーブルにはiOS専用アクションや、Workflow時代から引き継がれた従来の連携機能も含まれています。以下では、実際に自動化を作成する際の用途別に、Macに関連するカタログを整理します。下記のアクション名はすべて、このテーブルに記載された表記をそのまま使用しており、macOS 26.5で確認済みです。¹⁶

ファイルとFinder

システムとアプリ

Webとデータ

Get Contents of URLとDictionaryアクションを組み合わせると、実用的なRESTクライアントになります。リクエストを送信し、JSONを解析して値を抽出するまで、コードなしで実行できます。ペイロードが複雑になったら、エディタ内で入れ子のDictionaryと格闘するより、curlとjqを使うシェルスクリプトへ処理を渡しましょう。

テキスト、画像、メディア

Calendar、Reminders、Contacts、Notes

Find Calendar Events、Add New Calendar、Edit Calendar Event、Find Reminders、New Reminder、Edit Reminder、Find Contacts、Edit Contact、Create New Note、Get Notes、Delete Notes、および対応するGet Details of…アクションにより、生産性向上アプリの操作をひと通り行えます。¹⁶ 基本パターンは、Find／FilterとGet Detailsの組み合わせです。コレクションを検索し、一致した項目からフィールドを抽出します。

Shortcuts、メタ操作、フロー

パート6に向けたメタ自動化の補足です。Get My ShortcutsとGet Details of Shortcutを使うと、ショートカットからライブラリを列挙できます。CLI側のshortcuts listと組み合わせれば、ショートカットのコレクションを扱うツールを構築できます。¹⁶²

スクリプティングアクション

5つのアクションがShortcutsと従来の自動化スタックを橋渡ししており、いずれも1つのグローバルスイッチで制御されます。Shortcuts → 設定 → 詳細で、これらを実行するには「スクリプトの実行を許可」をオンにする必要があります。アプリ自身の設定説明には、制御対象となるアクションが明記されています。「有効にすると、『Run AppleScript』、『Run Shell Script』、『Run JavaScript for Mac Automation』、『Run JavaScript on Web Page』、『Run Script Over SSH』アクションを実行できます」（macOS 26.5で確認）。⁸¹⁷ Appleのドキュメントでは、スクリプトを含むショートカットの実行はデータ損失につながる可能性があるとも警告されています。通常のアクションを保護するガードレールの外で、この5つのアクションがユーザー権限をフルに使って実行されるため、この設定が存在します。⁸

Run Shell Script

主力となるアクションです。シェルを選び、スクリプトを貼り付け、入力の渡し方を選択します。2つの入力モードはアクション自身のドキュメントで次のように説明されています。「to stdin: 入力はファイルに変換され、スクリプトのstdinパイプに渡されます。as arguments: 入力は文字列のリストに変換され、スクリプトの引数として渡されます。」¹⁷

この2つのモードがもたらす実務上の違いは次のとおりです。

• stdinモードはテキストと単一ファイルに適しています。pbpaste風の処理、jqを使ったJSONの処理、ストリームを読み取るあらゆる処理に向いています。
• argumentsモードは複数ファイルに適しています。各入力項目は"$@"に入り、for f in "$@"; do ... doneを使えば、スペースを含むFinderの選択項目も正しく処理できます。
• 出力はスクリプトがstdoutに書き出した内容であり、他の出力と同様に次のアクションへ渡されます。

Run AppleScript と Run JavaScript for Mac Automation

どちらも、on run {input, parameters}エントリポイント（AppleScript）またはrun(input, parameters)関数（JXA）を備えたOpen Scripting Architectureスクリプトを埋め込みます。別のアプリを操作する仕事、たとえばFinderウインドウの配置、Mailルール、スクリプティング辞書を持つあらゆる対象にはこちらを使います。戻り値がアクションの出力になります。

Run Script Over SSH

アクションでホスト、ポート、ユーザー、認証を設定し、リモートホスト上でシェルスクリプトを実行します。最大の用途はCLIと対になることです。オフィスにあるMacは、SSH経由で到達できるあらゆるマシンに対して繰り返し可能な操作を公開でき、ショートカットはShortcutsエディタを離れることなくLinuxマシンへ処理を送り出せます。

Run JavaScript on Web Page

現在のSafariページに対してJavaScriptを実行し、その結果を返します。任意のページコンテキストで実行されるJavaScriptはデータ流出の経路になり得るため、Appleはスクリプト用スイッチに加え、実行ごとの許可プロンプトも設けています。⁸

ウインドウ管理アクション

ShortcutsにはMac向けのネイティブなウインドウ操作機能として、Find Windows、Move Window、Resize Windowが用意されています。¹⁶ カタログ上では小さな項目に見えますが、サードパーティ製ツールなしでキーボード操作によるウインドウレイアウトを作るための基礎になります。

• Find Windowsは開いているウインドウを検索し（エディタで並べ替えやフィルタリングが可能）、ウインドウオブジェクトを出力します。
• Move Windowはウインドウと位置を受け取ります。パラメータの要約は「Move ⟨Window⟩ to ⟨Position⟩」で、任意のカスタムバリエーションとして「Move ⟨Window⟩ to ⟨Position⟩ ⟨X Coordinate⟩, ⟨Y Coordinate⟩」もあります（macOS 26.5で確認）。¹⁶
• Resize Windowはウインドウと対象を受け取ります。「Resize ⟨Window⟩ to ⟨Configuration⟩」であり、明示的な⟨Width⟩ × ⟨Height⟩を指定できるカスタムバリエーションもあります。¹⁶

フレームワークの文字列テーブルには、組み込みのウインドウ配置としてFull Screen、Left、Right、Top、Bottom、3分割（Left Third、Middle Third、Right Third）、コーナーバリエーション（Top/Bottom LeadingおよびTrailing）、カスタムのWindow Location and Size形式が定義されています（macOS 26.5で確認）。¹⁶ Find Windows（最前面ウインドウ）→ Resize Window（Left）をキーボードショートカットと組み合わせれば、1キーで実行できるウインドウコマンドになります。2つのアプリを扱うケースは、Split Screen Appsが1つのアクションで処理します。¹⁶

Use Modelアクション

macOS Tahoeで新たに追加され、Mac版の登場以降Appleが加えたアクションの中でも最も重要なものです。Use Modelはショートカットの途中でデータをApple Intelligenceモデルへ送り、応答を次のアクションに渡します。³⁴

Appleがこの機能について説明したWWDCセッションによると、モデルは3種類から選べます。Private Cloud Compute上の大規模なサーバーベースモデル、ネットワーク接続なしでの簡単なリクエスト向けオンデバイスモデル、そして「幅広い世界知識」向けのChatGPTです。⁴

出力形式も3種類あり、意図して選ぶことが重要です。⁴

1. テキスト（リッチテキストを含む）は、要約や書き換えに使います。
2. 辞書は構造化抽出に使います。Appleの例では、請求書からベンダー、金額、日付を取り出しています。辞書出力によってUse Modelは組み合わせ可能になります。後続アクションは文章を解析するのではなく、フィールドを読み取れます。
3. アプリエンティティは、App Intentsを通じて公開されるアプリ内のコンテンツオブジェクトです。Appleはこの関係を「App Intentsがアプリのアクション、つまり動詞なら、App Entitiesは名詞です」と説明しており、⁴ Use Modelはそれらの名詞を直接推論できます（これらのメモをフィルタする、関連するカレンダーイベントを選ぶ、など）。

Follow Upトグルを使うと、同じ実行内でモデルの応答を反復できます。⁴

エンジニアリング上の注意点が1つあります。モデル出力は非決定的であるため、同じ入力でも実行ごとに異なる結果になることがあります。自動化では、辞書出力形式（スキーマで制約されるもの）、小さく焦点を絞ったプロンプト、結果がファイルやメッセージに触れる前の検証ステップ（必須フィールドを確認するIfアクション）が有効です。Use Modelは不安定なネットワーク呼び出しのように扱いましょう。便利ですが、チェックで包む必要があります。

この機能を開発者の視点から見る場合、つまりUse Modelが推論できるようにアプリが何を公開すべきかについては、Part 6と、このサイトのApp Intents群をご覧ください。まずはApp Intents Are Apple’s New API to Your Appから読むのがおすすめです。

macOSの自動化トリガー

自動化とはトリガーが付いたショートカットです。「これが起きたら、これを実行する」をクリックなしで行えます。macOS TahoeでMacにも導入され、AppleはiOSの一覧をそのまま移植するのではなく、Mac固有のトリガーを作りました。「フォルダや外部ドライブの自動化など、Mac向けに特化して設計された新しい自動化タイプと、Time of DayやBluetoothなどiOSですでに馴染みのある自動化タイプをMacにも導入します。」⁴

ShortcutsアプリのAutomation領域から作成します。各自動化は1つのトリガーと一連のアクション、そして1つの実行ポリシーを組み合わせます。Run Immediately（操作不要で実行。これが自動化の本質です）またはRun After Confirmation（先に通知で確認を求めます）です。³¹⁸ 新しい自動化は、信頼できるようになるまで確認ありで開始し、その後すぐ実行へ切り替えましょう。

macOS Tahoeのトリガーカタログ：³⁴¹⁸

このデザインからは2つの変化が見えてきます。第一に、Macにはついに「このフォルダを監視して、そこに入ったものを処理する」ためのAppleネイティブな答えが生まれました。ほかのショートカットと同じように同期・編集できます（AutomatorのFolder Actionsは監視できましたが、それ以外はできませんでした）。第二に、自動化はショートカットを実行するため、このガイドの内容がすべて積み重なります。FolderトリガーはRun Shell Scriptへ渡せ、AppトリガーはUse Modelを呼び出せ、External DriveトリガーはSSHジョブを開始できます。

実用に耐える自動化パターン

すべてドキュメント化された機能だけで構成され、日常的に安定して使えるパターンです。

ホットフォルダ。 ~/Inbox のフォルダトリガー → Filter Files（拡張子が pdf）→ Extract Text from Image または Get Text from PDF → 辞書形式の出力（ベンダー、日付、合計金額）を指定した Use Model → Rename File で名前を変更し、Move File でアーカイブ階層へ移動します。Automator の定番ユースケースを、デバイス上での抽出とモデルによる命名で強化したものです。³⁴¹⁶

デスク環境のドック。 ディスプレイトリガー（外部ディスプレイの接続）→ 作業用アプリ一式を Open App で起動 → Move Window と Resize Window で所定のレイアウトに配置 → Set Focus で Work に設定します。切断時には逆の処理を実行します。1つのトリガーでデスク環境全体を再構築でき、手作業でウインドウを動かす必要はありません。³¹⁶

取り込み用ドライブ。 External Drive トリガー → カードの DCIM に対して Get Contents of Folder を実行 → 日付で Filter Files → 日付別フォルダへ Save File → 件数を Show Notification で通知します。ここでは確認モードを有効にするのが賢明です。意図せず接続されたドライブから、大量のファイルがコピーされるのを防げます。³¹⁸

実際のコードへ逃がす手段。 任意のトリガー → 入力を引数として Run Shell Script → 既存のスクリプト、という構成です。価値があるのはトリガーシステムであり、ロジックを Shortcuts のアクション内に置く必要はありません。トリガーとスクリプトだけの2アクション構成で、UI、同期、同意管理を備えた launchd 風のイベント処理を追加コストなしで実現できます。⁸¹⁷

会議に関連するコンテキスト。 Focus トリガー（Work Focus をオン）¹⁸ → Set Volume、気が散るアプリを Quit App、メモ用アプリを Open App で起動します。System Settings でデバイス間の Focus 共有を有効にしておけば、iPhone で Focus をオンにしたときにも Mac が反応します。

設計時には、次の制約を考慮してください。自動化は作成した Mac 上に存在するため、ショートカットライブラリ自体が同期されていても、MacBook で作成したフォルダ自動化が Mac mini で実行されることはありません（必要な各マシンでトリガーを設定してください）。また、トリガー一覧には「Web リクエストの受信」に相当する項目がありません（送信側から Run Script Over SSH を使うか、クラウド同期クライアントが監視するフォルダを介して連携します）。³¹⁸

shortcuts CLI

macOS には Monterey 以降、Shortcuts 用の本格的なコマンドラインインターフェース /usr/bin/shortcuts が搭載されています。shortcuts(1) と Apple のユーザーガイドに記載されており、4つのサブコマンドを備えています。¹² 以下の内容はすべて macOS 26.5 で検証しました。

shortcuts run <shortcut-name-or-identifier> [-i <input-path> ...] [-o <output-path>] [--output-type <UTI>]
shortcuts list [-f <folder-name>] [--folders] [--show-identifiers]
shortcuts view <shortcut-name>
shortcuts sign [-m <mode>] -i <input> -o <output>

shortcuts run

名前または識別子を指定してショートカットを実行します。「コマンドラインからのショートカット実行は、Shortcuts アプリから実行する場合と変わりません」¹。これは利点と注意点の両方を意味します。すべてのアクションを利用できる一方で、すべての権限プロンプトも表示されます（権限を参照）。

Apple の標準的な例では、JPEG が入ったフォルダに対して画像結合ショートカットを実行します。¹

shortcuts run "Combine Images" -i ~/Desktop/*.jpg -o ~/Desktop/combined.png

CLI は、入力側と出力側の両方で Unix の規約に従います。終了ステータスについては、「shortcuts コマンドは、正常に実行された場合は 0、エラー時は 1 で終了します」¹。ショートカットが出力で終わる場合、または Stop and Output を含む場合は、出力をパイプできます。¹

# Pipe shortcut output onward, typed as RTFD
shortcuts run "Make Meeting Notes" --output-type com.apple.rtfd | ...

# Feed stdin in, capture stdout out
echo "quarterly report" | shortcuts run "Slugify" -i - -o -

ドキュメントに記載された落とし穴が1つあります。shortcuts run へテキストをパイプすると、入力はテキストとして渡されます。「パイプを使用してファイルパスを渡すと、そのパスはテキストとして扱われます。入力をファイルパスとして確実に処理するには、-i フラグを使用してください」¹

そして、刻み込んでおく価値のある Apple の設計原則があります。「最も効率的なショートカットは、警告を表示せず、入力も求めないものです。ショートカットが入力を求めると、コマンドラインプロセスはユーザーの入力を待って一時停止します」¹。ヘッドレス実行では、この一時停止はハングと同じです。CLI から使うショートカットは、すべてのパラメーターを入力から受け取るように構築してください。

shortcuts list

ショートカット名を1行に1つずつ一覧表示します。--folders を指定すると、代わりにフォルダを一覧表示します。-f <folder> では対象をフォルダ内に限定でき、どのフォルダにも属さないショートカットには「none」を指定します。--show-identifiers は各ショートカットの UUID を追加表示します。² 自動化では識別子が重要です。名前は重複したり変更されたりしますが、UUID は変わりません。shortcuts run ではどちらも指定できます。²

shortcuts list --show-identifiers | grep "Deploy"

shortcuts view

指定したショートカットを Shortcuts エディタで開きます。² ツール処理の最後に便利です。たとえば、失敗したショートカットを検出したスクリプトから、そのままエディタを開けます。

shortcuts sign

配布用の .shortcut ファイルに署名します。共有形式とあわせてパート5で説明します。²

Shortcuts Events を使ったアプリのスクリプト操作

3つ目のプログラム操作手段は、スクリプティングインターフェースです。Mac の Shortcuts は、Shortcuts アプリ本体と、UI を持たないバックグラウンドヘルパーの Shortcuts Events（バンドル識別子 com.apple.shortcuts.events、macOS 26.5 で検証）の2つをスクリプト操作対象として登録します。¹¹ スクリプティング辞書には、この分離の理由が明記されています。「Shortcuts アプリを開かずにバックグラウンドでショートカットを実行するには、『Shortcuts』ではなく『Shortcuts Events』に指示します」¹¹

辞書は小規模で安定しています。ショートカットには、読み取り可能なプロパティとして name、subtitle、id、folder、color、icon、accepts input、action count があります。フォルダには name と id があり、唯一の動詞は run です。with input パラメーターは任意で、実行結果も返されます。¹¹

AppleScript：

tell application "Shortcuts Events"
    run shortcut "Slugify" with input "Quarterly Report Draft"
end tell

JXA：

const se = Application("Shortcuts Events");
const result = se.shortcuts.byName("Slugify").run({withInput: "Quarterly Report Draft"});

ScriptingBridge または py-applescript 経由の Python も同じインターフェースを対象とします。PyObjC の ScriptingBridge では、SBApplication.applicationWithBundleIdentifier_("com.apple.shortcuts.events") によりアプリオブジェクトが返され、その shortcuts() コレクションは上記の辞書を反映しています。¹¹

CLI より適しているのは、すでに AppleScript/JXA のコンテキスト内にいる場合、シリアライズされた stdout ではなくネイティブオブジェクトとしてショートカットの結果を取得したい場合、または Apple Events を送信できるアプリから実行し、シェルを呼び出したくない場合です。ホストプロセスが初めて Shortcuts Events に Apple Event を送信すると、macOS 標準の Automation 同意プロンプト（System Settings → Privacy & Security → Automation）が表示されます。無人運用を始める前に許可しておくべきプロンプトが、もう1つ増えることになります。⁶

辞書では整理に必要なアクセスも公開されています。フォルダとショートカットのメタデータは読み取り可能で、フォルダの割り当ては書き換えられます。そのため、UI に触れずにライブラリの管理作業（インベントリーレポートやフォルダ監査）をスクリプト化できます。¹¹

URL scheme

Shortcuts は shortcuts:// URL scheme を登録します。買収前のアプリに由来する旧式の workflow:// も利用できます（macOS 26.5 で検証）。¹⁹ URL は、ランチャー、リンク欄を持つメモアプリ、URL を開けるあらゆるアプリなど、ほかのアプリから連携するための手段です。Apple の説明は明快です。「URL でショートカットを実行するのは、Shortcuts の外部にある別のアプリから連携する場合に限ってください」⁹

ショートカットを実行：⁹

shortcuts://run-shortcut?name=[name]&input=[input]&text=[text]

• name（必須）：パーセントエンコードされたショートカット名です。
• input：text または clipboard を指定します。text の場合は text パラメーターの値がショートカットへの入力になります。clipboard の場合は「Clipboard の内容が使用され」、text は無視されます。⁹

shortcuts://run-shortcut?name=Lookup%20Goetta&input=text&text=goetta%20is%20great
shortcuts://run-shortcut?name=Add%20to%20Notes&input=clipboard

x-callback-url を使うと、往復処理のレスポンスを扱えます。²⁰

shortcuts://x-callback-url/run-shortcut?name=Calculate%20Tip&input=text&text=24.99&x-success=...&x-error=...&x-cancel=...

• x-success は成功時に開かれ、ショートカットのテキスト出力が result パラメーターとして追加されます。
• x-error は失敗時に開かれ、errorMessage パラメーターが渡されます。
• x-cancel はユーザーがキャンセルした場合に開かれ、出力は渡されません。²⁰

シェルからは open "shortcuts://run-shortcut?..." も使えますが、その場面では shortcuts run を推奨します。CLI なら、URL コールバックを経由せず、終了コードと出力を直接返せるためです。Mac におけるこの scheme の主な用途は、アプリ間連携とドキュメント内のリンクです。

共有形式と署名

Shortcutsの共有方法は2つあり、どちらも最終的には信頼するかどうかの判断につながります。⁷

iCloudリンク。 アプリで「共有」→「Copy iCloud Link」を選択します。リンクを受け取った人は誰でもショートカットを自分のライブラリに追加できるため、広く公開する際に最も手軽な方法です。リンクは送信した時点で公開情報として扱いましょう。⁷

ショートカットファイル。 「ファイル」→「書き出す」を選択すると、.shortcutファイル（UTI com.apple.shortcut、macOS 26.5で確認済み）が生成されます。¹⁹⁷ 書き出す際には、信頼範囲を必ず選択します。

• Anyone：「誰でもショートカットを実行できます」。検証のため、ショートカットのコピーがAppleに送信されます。⁷
• People Who Know Me：「連絡先にあなたを登録している人だけがショートカットを実行できます」。この確認に使用する連絡先情報がファイルに埋め込まれます。⁷

macOS 26.5のshortcuts(1)によると、CLIにも同じ2つのモードがあり、その仕組みも明記されています。people-who-know-meは「ローカルで署名されますが、そのショートカットを読み込めるのは、自分のデバイス、または連絡先に自分の連絡先情報を登録している人だけ」です。一方、anyoneは「iCloud経由で公証され、誰でもショートカットを読み込めるようになります」。²

shortcuts sign -m anyone -i "Deploy Notes.shortcut" -o "Deploy Notes-signed.shortcut"

このコマンドは、チームやCIでの配布に適した方法です。-m anyoneで署名した書き出し済みショートカットなら、面識がなく連絡先を交換したことのない受信者でも問題なく読み込めます。anyoneモードではiCloud経由で公証されるため、ビルドパイプラインへ組み込む前に、iCloudへサインイン済みのセッションとネットワーク接続を用意してください。²

読み込みはドラッグ＆ドロップで行えます。.shortcutファイルをダブルクリックするか、アプリまたはDockアイコンへドラッグします。.workflowファイルは、読み込み時にAutomatorから変換されます。¹⁵ Gallery以外で共有されたShortcutsについて、Appleは「非公開で共有されたショートカットの真正性や動作をAppleが検証することはできません」と明記しています。⁶ 企業で管理する多数のデバイスには別の方法があり、Apple Configuratorでは管理対象ワークフロー向けのShortcutsオートメーションを利用できます。²¹

「設定」→「詳細」には、非公開で共有されたショートカット（連絡先によって制限されたもの）の読み込みを管理するPrivate Sharingもあります。同じ画面に、「スクリプトの実行を許可」と「大量のデータの共有を許可」も用意されています。⁶⁸ 受け取ったショートカットを読み込めない場合、通常は未署名のファイル、連絡先に登録されていない相手から届いた連絡先制限付きファイル、またはPrivate Sharingが無効になっていることが原因です。

App Intents：アプリがアクションを追加する仕組み

ここまで紹介したカタログの内容は、すべてAppleが提供するものです。ライブラリの残り半分はインストール済みアプリから追加され、2022年以降、そのためのパイプラインはApp Intents（iOS 16、macOS 13）という1つのフレームワークに統一されています。¹³ アプリでは、AppIntentに準拠する型（動詞に相当し、パラメーターとperform()メソッドを持つもの）を定義します。必要に応じてAppEntity（名詞に相当し、識別子と表示表現を持つ、型付けされたアプリコンテンツ）も定義すれば、あとはシステムが処理します。同じ定義がShortcuts、Siri、Spotlight、ウィジェット、Apple Intelligenceに表示されます。つまり、Shortcutsはアプリのインテントスキーマを利用する場所の1つであり、個別の連携機能ではありません。¹³⁴

Mac上でのアプリの表示方法を理解するうえで、重要な導入レベルは2つあります。

• アクション：非表示に設定されていないインテントは、すべてShortcutsエディタ内のアプリ名の下にアクションとして表示され、このガイドで扱うあらゆる機能と組み合わせられます。
• App Shortcuts：AppShortcutsProviderでラップされたインテントは、アプリをインストールした時点で実行可能なショートカットとして提供されます。ユーザーが組み立てる必要はなく、Siriのトリガーフレーズも付属します。¹³

このフレームワークの対応範囲は、毎年拡大し続けています。ShortcutsとSpotlightを扱ったWWDC25セッションでは、現在のMac向け仕様が直接説明されています。「インテントがmacOSで利用できる限り、Mac上のオートメーションの一部として実行するために、Shortcutsでも利用できます。これには、macOSへインストールできるiOSアプリも含まれます」。⁴ AppleシリコンMacで動作するiPhoneアプリは、Mac固有のコードを1行も追加せずにMacのオートメーションへアクションを提供できます。

同じセッションで示されたAppleの導入ガイダンスを要約すると、コンテンツは「モデルが推論する際に必要となる主要なプロパティ」を持つエンティティとして公開し（Use Modelアクションがそれらを利用します）、クエリが機能するよう検索アクションを提供します。また、リッチテキストが適する場面では属性付き文字列を使用し、パラメーターの概要は読みやすく保ってください。⁴

実際のアプリへApp Intentsを導入した経験から、インテント作成者向けのデザイン指針をまとめると、次のようになります。

• インテントはAPIです。 名前、パラメーター、エンティティ識別子は契約として扱ってください。名前を変更すると、エンドポイントの改名でクライアントが壊れるのと同じように、ユーザーのショートカットも動かなくなります。
• フォアグラウンドよりバックグラウンドを優先します。 アプリを開かずに実行できるインテントはオートメーションへ組み込めますが、フォアグラウンドへの移行が必要なインテントは、ユーザーが行っていた作業を中断します。両者は意図的に分けてください。⁴
• 戻り値がパイプラインをつなぎます。 エンティティや値を返すインテントなら、Shortcutsのユーザーは後続の処理へつなげられます。何も返さないインテントは、処理グラフの行き止まりになります。

このサイトでは、開発者側の詳細をApp Intents関連の記事群で解説しています。App Intentsはアプリの新しいAPI（導入すべき理由と本番環境での実装手順）、iOS 26のApp Intents 2.0（Visual Intelligence、スニペット、遅延プロパティ）、iOS 27のApp Intents（長時間実行されるバックグラウンドインテント、同期可能なエンティティ、Spotlightの再インデックス）、App IntentsとMCPの比較（同じ機能をエージェントツールとしても提供すべき場面）をご覧ください。

Spotlightとオートメーションからインテントを実行する

macOS Tahoeではインテントを実行できる場所が拡張されました。新たに加わった2つの機能によって、Macで「App Intentsを導入する」ことの価値が変わります。⁴

Spotlightはインテントをその場で実行します。 「今年から、アプリのアクションをMacのSpotlightから直接実行できるようになりました。Shortcutsの場合と同じようにApp Intentsを導入すれば、アプリのアクションをSpotlightに表示できます」。⁴ 要件は具体的で、次の項目に沿って監査できます。

1. パラメーターの概要（「アプリインテントの処理内容を短い自然言語で表したもの」）には、「デフォルト値がない必須パラメーターをすべて含める必要があります」。⁴
2. インテントで検出を無効にしてはいけません。isDiscoverableがfalse、またはassistantOnlyがtrueの場合、Spotlightには表示されません。⁴
3. 候補と検索はエンティティ層から提供されます。ピッカーには候補エンティティまたは列挙可能なエンティティクエリを実装し、入力中の検索にはエンティティ文字列クエリまたはインデックス済みエンティティを使用します。⁴

オートメーションは無人でもインテントを実行します。 Tahoeのオートメーションはショートカットを実行し、そのショートカットからインテントを実行できるため、ユーザーがいない状態でも、フォルダの変更やドライブのマウントをきっかけにアプリのインテントを呼び出せるようになりました。⁴ インテント作成者には、前のセクションで示した基準をさらに高い水準で満たすことが求められます。フォアグラウンドのユーザーを前提とするインテント（UIを表示するものや確認を求めるもの）は、Run Immediatelyオートメーション内では気づかれないまま失敗します。画面を見ている人が誰もいないときに何が起きるのか、インテントごとに無人実行への対応を監査してください。

この2つを合わせると、Appleが示す静かなアーキテクチャ方針が見えてきます。Macにおける機能の単位は、アプリのウィンドウではなくインテントです。Spotlightは対話的な呼び出し元、オートメーションは無人の呼び出し元となり、その間をShortcutsが構成レイヤーとしてつなぎます。

スクリプトやエージェントから Shortcuts を操作する

エージェントやスクリプトのアーキテクチャにおいて、Shortcuts は独自の役割を担います。外部コードから Mac の機能を呼び出す方法のなかで、権限を最小限に抑えられ、ユーザー自身が最も確認しやすい仕組みです。シェルへアクセスできる AI エージェントなら、ほとんどの処理を直接実行できます。しかし、ショートカットを経由させると、生のシェルにはない特性が得られます。処理内容をユーザーが定義・編集でき、権限はショートカットごとに付与され、1クリックで取り消せます。さらに、影響範囲をエディタ上で確認できます。⁶ ショートカットのレイヤーは、人間が整備し、エージェントが呼び出す機能カタログと考えるとよいでしょう。

これらを動作させるには、1つの必須条件があります。CLI には、ログイン済みの GUI セッションが必要です。 list を含むすべての shortcuts サブコマンドは、ユーザーの Aqua セッション内にあるヘルパーアプリと通信します。セッションが存在しない場合は、「Couldn’t communicate with a helper application」というエラーで失敗します（macOS 26.5で確認済み）。SSH のみのセッション、ヘッドレス CI ランナー、launch daemon では、この制約に阻まれます。エージェントやスケジュール実行は、ログイン済みユーザーのセッション内、つまり daemon ではなく launchd agent で動かしてください。

エージェントの観点から見た呼び出し規約：¹²

構造化データはテキストとして境界を越えます。 実用的なパターンは、stdin/stdout 経由で JSON を受け渡す方法です。呼び出し側が JSON ドキュメントをパイプし（-i -）、ショートカット側では Get Dictionary from Input で解析して処理を行い、最後に Stop and Output から辞書をテキストとして返します。¹¹⁶ これにより、ショートカットはスキーマが文書化された型付き関数として扱えます。各ショートカットが想定する入出力の形式は、呼び出し元となるエージェント設定のそばに README として残しておきましょう。

タイムアウトの管理は呼び出し側の責任です。 アラートを表示するショートカットは CLI プロセスを無期限に停止させるため、¹ 無人実行する場合は必ず呼び出しにタイムアウトを設定し、期限切れを失敗として扱ってください。

# macOS ships no timeout(1); gtimeout comes from `brew install coreutils`
if ! output=$(gtimeout 120 shortcuts run "$UUID" -i - -o - <<<"$payload"); then
  echo "shortcut failed or timed out" >&2
fi
# no-Homebrew alternative using the system perl:
#   perl -e 'alarm shift; exec @ARGV' 120 shortcuts run "$UUID" -i - -o - <<<"$payload"

無人実行の前に権限を付与しておきます。 各ショートカットを対話形式で一度実行し、表示されるプロンプトでは Always Allow を選択してください。エージェントや launchd ジョブから呼び出す前に、ターミナルからプロンプトなしで実行できることも確認します。⁶¹ 事前に許可している内容については、権限のセクションで説明します。

呼び出し元の種類に応じてエントリーポイントを選びます。 シェルを利用できる呼び出し元（エージェント、CI、launchd agents、Makefiles。いずれもログイン済みセッション内）は CLI を使用します。Apple Event のコンテキスト（AppleScript アプリ、PyObjC daemons）では Shortcuts Events を使用し、ネイティブな戻り値を受け取れます。¹¹ サンドボックス化されたコンテキストや URL しか利用できないコンテキストでは、結果を受け取るために x-callback とともに shortcuts://run-shortcut を使用します。⁹²⁰ いずれも同じショートカットを実行し、異なるのは転送方法だけです。

逆方向の連携、つまりショートカットをエージェントのフロントエンドとして使うこともできます。キーボードショートカットやメニューバーから起動し、コンテキスト（選択範囲、クリップボード、最前面のアプリ）を収集して、Run Shell Script からエージェントの CLI を呼び出し、その結果を表示するショートカットを作成できます。これにより、OS の入力手段が、背後で動くあらゆるツールの UI となります。¹⁰¹⁷

権限と同意（TCC）

Shortcuts は、同意を優先する macOS のセキュリティモデルを継承しています。ロジックの不具合ではない自動化の失敗は、突き詰めるとすべてここに行き着きます。このモデルは4つのレイヤーで構成されています。どのレイヤーが許可を求めているのか把握すれば、機械的に対処できます。

1. ショートカット単位のデータ利用同意。 ショートカットが保護対象のリソースへ初めてアクセスすると、Shortcuts は次のように確認します。「If a Privacy dialog appears requesting access to data, choose Allow Once, Always Allow, or Don’t Allow.」Always Allow は、「次回そのショートカットを実行するとき、Shortcuts アプリはアクセス許可を求めない」という意味です。⁶ 許可はショートカットおよびリソースごとに付与され、確認も可能です。各ショートカットの詳細ペインには Privacy タブがあり、個別の許可を取り消せます。また、「To remove access to all data for this shortcut, click Reset Privacy.」と案内されています。⁶

2. スクリプトの実行制限。 5つのスクリプト action は、Settings → Advanced → Allow Running Scripts を有効にした場合のみ実行できます（上記の正確な一覧）。⁸ この設定はショートカット単位ではなく、全体に適用されます。1つのホットフォルダースクリプトのために有効化すると、インポートしたすべてのショートカットでもスクリプトを実行できるようになります。そのため、インポートしたショートカットは実行前に内容を確認してください。⁶

3. システムの TCC プロンプト。 OS の保護対象領域へアクセスする action（Files and Folders、ほかのアプリをスクリプトで操作するための Automation/Apple Events、入力制御のための Accessibility）は、System Settings → Privacy & Security で管理されるシステムレベルのダイアログを表示します。これらの許可は実行元プロセスに関連付けられます。そのため、同じショートカットでも、アプリ内、CLI、自動化からの実行では挙動が異なる場合があります。起動コンテキストが異なり、それぞれ個別に許可されるためです。⁶

4. 自動化の実行ポリシー。 各自動化の Run Immediately または Run After Confirmation の設定により、トリガー自体に人間の確認が必要かどうかが決まります。¹⁸

ここから導かれる運用ルールは次のとおりです。

• 誰も見ていない場所ではプロンプトを操作できません。 ヘッドレス環境（SSH セッション、CI ランナー、エージェント）にも、CLI セクションの第1のルールが当てはまります。応答されない同意ダイアログは、処理を無期限に停止させます。¹ 対話形式で事前に許可しておきましょう。
• Reset Privacy は、白紙状態からデバッグするための手段です。 編集後にショートカットが正しく動作しなくなった場合は、許可をリセットして対話形式で再実行すると、すべてのプロンプトが順番に再表示されます。⁶
• インポートしたショートカットは内容を確認する必要があります。 Apple は「Anyone」で署名されたショートカットを検証しますが、「cannot verify the authenticity or behavior of shortcuts shared privately.」⁶⁷ Privacy タブではショートカットに付与された権限を、エディタでは実行内容を確認できます。両方を確認しても1分ほどです。

トラブルシューティング

クイックリファレンスカード

# Run
shortcuts run "Name"                          # by name
shortcuts run 8F3A...-UUID                    # by identifier (stable)
shortcuts run "Name" -i file.jpg -o out.png   # file in, file out
echo data | shortcuts run "Name" -i - -o -    # stdin → stdout
shortcuts run "Name" --output-type public.plain-text | pbcopy

# Inspect
shortcuts list                                # names
shortcuts list --show-identifiers             # names + UUIDs
shortcuts list --folders                      # folders
shortcuts list -f "Folder"                    # scoped
shortcuts view "Name"                         # open in editor

# Distribute
shortcuts sign -m anyone -i in.shortcut -o out.shortcut
shortcuts sign -m people-who-know-me -i in.shortcut -o out.shortcut

# Exit codes: 0 success, 1 error

-- Background run with result (no app window)
tell application "Shortcuts Events" to run shortcut "Name" with input "payload"

shortcuts://run-shortcut?name=Name&input=text&text=payload
shortcuts://run-shortcut?name=Name&input=clipboard
shortcuts://x-callback-url/run-shortcut?name=Name&x-success=app://ok&x-error=app://fail

チェックリスト。 無人実行に対応したショートカット：アラートや Ask Each Time パラメータがないこと、Always Allow で事前に同意を付与していること、UUIDで呼び出すこと、呼び出し側でタイムアウトを適用すること、Stop and Output で終了すること。¹⁶ 配布可能なファイル：エクスポート済みであり、-m anyone で署名され、入力規約が文書化されていること。²⁷

よくある質問

TerminalからMacのショートカットを実行するには？ shortcuts run "Shortcut Name" を使います。入力ファイルには任意で -i（またはstdinには -）、出力には -o（またはstdoutには -）、Uniform Type Identifierには --output-type を指定できます。成功時は終了コード0、エラー時は1で終了するため、ほかのUnixツールと同様に &&、if、make と組み合わせられます。¹²

macOSにもついにiOSのようなShortcuts自動化が追加されましたか？ はい。macOS Tahoe（26）以降で利用できます。トリガーには、時刻、アラーム、メール、メッセージ、フォルダの変更、外部ドライブ、ディスプレイ、Wi-Fi、Bluetooth、バッテリー残量、充電器、アプリの起動／終了、Focus、Stage Managerがあります。それぞれ即時実行または確認後の実行を設定できます。³⁴¹⁸

shortcuts sign -m anyone は実際に何をしますか？ iCloudを通じてショートカットファイルを公証し、誰でも読み込めるようにします。デフォルトの people-who-know-me モードではローカルで署名され、読み込みは自分のデバイスと、Contactsに連絡先情報が登録されている人に限定されます。²

Mac向けアプリはどのように独自のShortcuts actionsを追加しますか？ App Intentsフレームワークを採用します。Intentsは自動的にShortcuts actionsとして表示され、AppShortcutsProvider により、設定不要のApp Shortcutsをアプリとともに提供できます。macOSで利用可能なIntentsは、SpotlightやTahoeの自動化内でも実行できます。Apple silicon MacにインストールされたiOSアプリのIntentsも含まれます。¹³⁴

スクリプトやAIエージェントからショートカットを呼び出すには？ CLI を使います。shortcuts list --show-identifiers で見つけ、UUIDで呼び出し、stdin経由で JSON を渡し、stdoutから結果を読み取ります。確認を求めるショートカットは永遠に停止するため、すべての呼び出しをタイムアウトで囲んでください（macOSには timeout(1) がないため、coreutilsの gtimeout または使用言語のプロセスタイムアウトを使います）。無人で使用する前に、各ショートカットの権限プロンプトを対話的に事前承認してください。AppleScriptのコンテキストからは、アプリを開かずに実行するため Shortcuts Events を対象にします。¹²¹¹

ShortcutsはAutomatorを置き換えられますか？ 大半のワークフローでは可能です。AppleはShortcutsをMac自動化の将来と位置づけており、ほとんどの .workflow ファイルを直接読み込めるコンバータも用意しています。Automatorは現在も同梱され、既存のワークフローも引き続き実行できるため、移行は期限ではなく選択肢です。⁵¹⁴¹⁵

変更履歴

参照