Alter Actions

​

Alter Action とは

• AI 指示 — AI の振る舞いを定義するシステムプロンプト
• トリガー — 音声コマンド、ホットキー、条件付き実行
• コンテキスト — 選択テキスト、ファイル、アクティブなアプリケーションへのアクセス
• ツール — Mac および 2000 以上の外部サービスとの連携設定
• 出力 — 結果の表示方法（マークダウン、コード、インライン挿入）

​

マイアクションを開く

​

方法 1: キーボードショートカット（最速）

​

方法 2: ウィンドウメニュー

1. 任意の Alter ウィンドウ（Hub、QuickHub、または ツールとアクション）を開く
2. ウィンドウ → マイアクション を選択

​

方法 3: ツールとアクションのサイドバー

1. ⌘⇧T（Command + Shift + T）を押して ツールとアクション を開く
2. サイドバーで マイアクション を選択

​

マイアクションのレイアウト

​

アクション一覧

• 検索 — ⌘F でアクション名とインデックス済みリソースプロパティ（ツール、ゲートウェイ、クイックアクション、類似のリンク済みリソース）を検索
• フィルター — フィルターアイコンで、バックグラウンドジョブ、スケジュール、警告、変更済みアクション、公開済みリスト、無効アクション、特定フォルダで絞り込み
• フォルダの 折りたたみ・展開、フォルダの 名前変更、アクションのドラッグ によるフォルダ間移動
• 複数アクションの選択 による一括エクスポート、移動、有効化/無効化、削除
• ツールバーから フォルダを作成 し、ドラッグ＆ドロップまたは行のコンテキストメニューからアクションを追加

• アイコンと名前 — 名前をダブルクリック（または 1 行選択して Return）でアクションドキュメントを開く
• 音声フレーズが設定されている場合の 音声トリガー インジケーター
• 組み込みアクションをカスタマイズした場合の Modified by you バッジ
• バックグラウンドジョブ インジケーター
• リストから取得したアクションの Marketplace インジケーター
• 診断で構成問題が見つかった場合の 警告 インジケーター

​

インライン行操作

​

行のコンテキストメニュー

​

エディタチャット

​

チャットでできること

• 説明から 新しいアクションを作成（「毎朝 9 時に実行するデイリースタンドアップ要約アクションを作って」）
• 選択中アクションのプロンプト、パラメーター、表示設定、モデル、ツール、スケジュール、ゲートウェイを 編集
• グローバルまたは 1 つのアクション単位でツールを 有効化またはスコープ設定
• クイックアクション の構成 — Alter が webhook、AppleScript/JXA、ショートカットなどの設定フォームをレビュー付きで開く
• Connected Applications と MCP サーバー をネイティブ承認シート経由で 接続
• Skills の インストールまたは有効化
• 1 つのアクションの 警告を診断、またはライブラリ全体を スキャン
• 名前、説明、リンク済みリソースで アクションを検索（「Discord ゲートウェイを使っているアクションはどれ？」）
• 自動化用の コールバック URL をコピー

​

承認と機密設定

​

提案用のプロフィールコンテキスト

​

アクションドキュメント

• 一覧でアクション名をダブルクリック
• 1 つのアクションを選択して Return
• 右クリック → 編集
• 別の Alter ウィンドウから、現在のアクションに Edit in Action Editor が表示されている場合はそれを使用

​

1. General

• Enabled — アクションのオン/オフ
• Mode — Hub 入力エリアで選択可能なモードとして表示
• プロフィールを含める — AI コンテキストにユーザープロフィール情報を含める
• Save to History — このアクションの会話を History に保存し、後から再開・検索できるようにする
• Name、Description、Category、Icon
• Workspace — このアクション実行時に常に workspace をコンテキストに追加
• Global Keyboard Shortcut — Mac 上のどこからでもこのアクションを起動
• Voice Triggers — ディクテーション中にこのアクションを実行するフレーズ

• Show only when running — 選択したアプリが実行中の場合のみアクションを表示
• Show only when active — 選択したアプリがフォーカスされている場合のみアクションを表示
• Workspace context — このアクションを表示する workspace を制限

​

2. システムプロンプト

# IDENTITY AND PURPOSE
You are an expert software engineer who explains code clearly
and accessibly to developers of all skill levels.

# STEPS
1. Analyze the provided code
2. Identify its purpose and key components
3. Explain each section in simple terms

# OUTPUT INSTRUCTIONS
- Use markdown formatting
- Include code examples where helpful
- Keep language clear and non-technical

​

3. ユーザープロンプト

Please explain this code:

{{ textSelection }}

Explanation detail: {{ detailLevel }};

• {{ textSelection }} — 現在選択中のテキスト
• {{ filePath }} — 選択中ファイルのパス
• {{ clipboard }} — クリップボードの内容
• システムプロンプトで定義したカスタムパラメーター

​

4. 表示するタイミング

• Installed Applications — 特定のアプリ（VSCode、Xcode、Safari など）でのみアクションを表示
• Application is running — アプリが実行中である必要がある
• Application has focus — アプリが前面にある場合のみ動作
• Web browser tab contains — 特定ドメインを閲覧中にアクションを表示
• Has content — コンテキストが利用可能な場合のみアクションを表示

​

5. Automation

• Background Job — UI を表示せずバックグラウンドでアクションを実行
• Background markdown rendering — バックグラウンドモードで貼り付け時にマークダウンを HTML にレンダリング
• Send a system notification — バックグラウンドジョブ完了後に通知
• Schedules — 特定時刻にアクションを実行（例: 「毎週月曜 9:00」）
• Quick Action — 最初のアシスタント応答後にリンク済みクイックアクションを自動実行

​

6. Tools

• Disable Tools — オフの場合、選択したツールのみ利用可能。オンの場合、ツールアクセスが制限される
• ツールアクセスが有効で選択が空の場合: グローバルで有効化されたすべてのツールが利用可能
• 構成済みの場合: 選択したツールのみ利用可能

• AI の判断負荷を減らす（関連ツールに集中）
• アクション実行を高速化
• セキュリティ向上（アクションがアクセスできる範囲を制限）

​

7. Model

• Model — Current、Favorites、Other models にグループ化された検索可能ピッカー。空のままにするとユーザーのデフォルトモデル設定を使用し、特定モデルを固定することも可能。
  • 各行にコンテキスト長、ビジョン対応、お気に入りを表示
  • モデルが対応している場合、Thinking effort（Low、Balanced、Max）をインラインで調整
• Temperature — 創造性と精度のバランス
  • 0.0 — 決定論的（一貫性、予測可能）
  • 0.5 — バランス（デフォルト）
  • 1.0 — 創造的（予測不能、探索的）

​

8. Gateways

​

診断と警告

• 行またはセクションの警告バッジをクリックして詳細と推奨修正を確認
• 一覧を Warnings でフィルターし、要対応アクションを監査
• エディタチャットに「このアクションの警告を修正して」や「すべてのアクションの問題をスキャンして」と依頼

​

ベストプラクティス

​

よくあるアクション例

​

例 1: Code Explainer

• Name: Explain Code
• Category: code
• Installed Apps: VSCode, Xcode
• システムプロンプト: You are an expert programmer who explains code clearly
• ユーザープロンプト: Please explain this code:\n\n{{ textSelection }}
• Consumer: markdown
• Temperature: 0.5

​

例 2: Email Draft Creator

• Name: Draft Email
• Category: productivity
• 表示するタイミング: Mail app active
• システムプロンプト: You are a professional business communicator
• ユーザープロンプト: Transform this into a professional email:\n\n{{ textSelection }}
• Tools: Enable only Mail
• Consumer: in-place
• Temperature: 0.6

​

例 3: Scheduled Daily Brief

• Name: Daily Brief
• Category: productivity
• Automation: Schedule for 9:00 AM daily
• Background Job: Enabled
• システムプロンプト: Generate a daily brief of priorities

​

音声トリガー

​

x-callback-url 連携

​

x-callback-url とは

• Inbound — 他アプリ（Shortcuts、Notes、Safari など）から Alter アクションを起動
• Outbound — Alter 内で他アプリ（Bear、OmniFocus、Drafts など）を開くリンクを作成

​

アクションのコールバック URL を取得

alter://action/{action-id}?input=VALUE&param2=VALUE

​

他アプリから Alter アクションを起動

alter://action/ask-web?input=What+is+Alter+MacOS

alter://action/explain-code?input=const+hello+%3D+%28%29+%3D%3E+%7B%7D

1. 新しい Shortcut を作成
2. 「Open URL」アクションを追加
3. alter:// URL を貼り付け
4. Shortcut を実行してアクションを起動

​

ユースケース

​

キーボードショートカット

​

グローバル

​

マイアクション（ツールとアクション ウィンドウ、マイアクション選択時）

​

アクションドキュメントウィンドウ

​

トラブルシューティング

​

関連ガイド

• 再利用可能なアクションを作成 — 数分で最初のアクション
• ツールを管理 — アクションで使う連携を接続
• Tools & Integrations — アクションで使えるツール
• URL Callbacks — x-callback-url 自動化の詳細
• Voice & Dictation — 音声トリガーの設定
• Settings — グローバルモデルと音声設定