setup-macbook-productivity

MacBook の生産性設定

概要

このスキルを使用すると、再現可能なセットアップと検証を重視し、macOS でユーザーの確認が必要な場合に該当する「システム設定」パネルを開きながら、ローカルの macOS の生産性に関する環境設定を設定できます。

対応するワークフロー：

• Control キーを 2 回押すショートカットを使った音声入力／音声入力機能。
• Google Drive が正常に動作している一方、Raycast からの起動では UI が再度開かない Mac 向けの、Raycast で使いやすい Google Drive ランチャー。

音声入力ワークフロー

1. ホストが macOS であることを確認します。

sw_vers

2. 同梱のセットアップスクリプトを実行します。

python3 "$CODEX_HOME/skills/setup-macbook-productivity/scripts/setup_voice_typing.py"

CODEX_HOME が設定されていない場合は、次を使用します。

python3 "$HOME/.codex/skills/setup-macbook-productivity/scripts/setup_voice_typing.py"

3. macOS で音声入力のプライバシー確認やダウンロードのプロンプトが一度だけ表示される場合があることをユーザーに伝えます。表示された場合は、有効にするをクリックしてもらいます。Apple のオーディオ共有については、ユーザーが録音の共有を明示的に希望しない限り、今はしないを推奨します。

4. 任意のテキストフィールドで Control キーを 2 回押してテストするようユーザーに依頼します。音声入力は Esc キーを押すか、同じショートカットをもう一度押すと停止できます。

音声入力スクリプトの動作

• 既知の音声入力環境設定フラグを有効にします。
• 音声入力のシンボリックホットキー（AppleSymbolicHotKeys の ID 164）を、動作する Control キーを 2 回押す修飾キーショートカットに設定します。
• macOS が変更を認識するよう、環境設定サービスを再起動します。
• 必要なプロンプトをユーザーが承認し、音声入力の設定を確認できるよう、システム設定 > キーボードを開きます。
• 検証用に、設定後の音声入力とショートカットの状態を出力します。

音声入力の検証

defaults read com.apple.HIToolbox AppleDictationAutoEnable 2>/dev/null
defaults read com.apple.assistant.support "Dictation Enabled" 2>/dev/null
defaults read com.apple.symbolichotkeys AppleSymbolicHotKeys | sed -n '/164 =/,/};/p'

期待される結果：

• 最初の 2 つのコマンドが 1 を返します。
• ホットキー 164 の enabled = 1、type = modifier となり、パラメーターが Control キーを 2 回押す設定と一致します。

音声入力が開始されない場合は、システム設定 > キーボード > 音声入力を開き、音声入力がオンになっていることを確認します。ショートカットをControl キーを 2 回押すに設定し、使用するマイクソースを選択します。

Google Drive + Raycast ワークフロー

以下のすべてに当てはまる場合は、このワークフローを使用します。

• Google Drive for Desktop がインストールされ、ファイルがマウントされているか、ほかの方法でアクセスできる。
• Finder から Google Drive.app を直接開くと、Drive の UI が正常に再度開く。
• Drive がバックグラウンド／メニューバーアプリとしてすでに実行されているため、Raycast から Google Drive を起動しても何も起きないように見える。
• ユーザーがターミナルコマンドではなく、通常の Raycast／⌘ Space ワークフローを希望している。

次を実行します。

python3 "$CODEX_HOME/skills/setup-macbook-productivity/scripts/setup_google_drive_raycast_launcher.py"

CODEX_HOME が設定されていない場合は、現在のハーネスに対応する同等のインストール済みスキルパスを使用します。

Google Drive ランチャースクリプトの動作

スクリプトは次を作成します。

~/Applications/Google Drive Launcher.app

ランチャーは次の処理を行います。

• 独自のバンドル識別子を持ち、macOS と Raycast が別のアプリとしてインデックスできるようにします。
• 使用可能な場合は Google Drive のアイコンを使用します。
• macOS LaunchServices を呼び出して /Applications/Google Drive.app を再度開きます。
• Raycast の独自形式の内部データベースは変更しません。
• ユーザーの日常的な操作をすべてグラフィカルに行えるようにします。Raycast で Google Drive Launcher を検索し、Enter キーを押します。

このスクリプトは冪等です。再実行すると、同じランチャーバンドルをその場で再作成します。

Google Drive の検証

セットアップ後、macOS がランチャーを解決できることを確認します。

open -Ra "Google Drive Launcher"

次に、ランチャーを一度起動します。

open "$HOME/Applications/Google Drive Launcher.app"

より確実な動作確認を行うには、Google Drive の最新のログを調べ、再度開くイベントがあることを確認します。

tail -80 "$HOME/Library/Application Support/Google/DriveFS/Logs/drive_fs.txt" \
  | grep 'applicationShouldHandleReopen'

正常に実行されると、最近のログに applicationShouldHandleReopen／Got double launch のエントリーが記録され、Finder から開いたときと同じ Drive の UI が再度開きます。

macOS によるランチャーのインデックス作成後も Raycast に Google Drive Launcher がすぐに表示されない場合は、Raycast を再起動します。

診断メモ

Google Drive のメニューバーアイコンが表示されないからといって、Drive 自体が故障していると決めつけないでください。まず、次の状況を区別してください。

1. Drive のプロセスが動作しており、マウントされたファイルも機能している。
2. Finder からアプリを再度開くと機能する。
3. Raycast からの起動だけが失敗する。

この3つの条件が当てはまる場合は、Drive の再インストールや Raycast のデータベースへのパッチ適用よりも、上記のランチャーによる回避策を優先してください。

TCC によってコントロールセンターの状態が保護されている macOS バージョンでは、プライバシー制御を回避して、保護されたメニューバーレジストリを調査したり変更したりしないでください。画面収録またはアクセシビリティの権限がない場合、それは保護の境界として扱い、Drive が破損している証拠とは見なさないでください。

境界事項

macOS のプライバシーに関する確認を回避しようとしないでください。「設定」を開き、人による選択が必要な確認はユーザーに許可してもらってください。

ユーザーが音声による Mac の操作を希望しない限り、音声コントロールを有効にしないでください。有効になっている間は、通常の音声入力の動作が置き換えられます。

サポートされているインデックス済みアプリまたはスクリプトコマンドの仕組みで同じ結果が得られる場合は、Raycast 独自のデータベースを直接編集しないでください。