目次を表示する

Raycast：キーボード統合プラットフォーム

第6章 ベストプラクティス ── Raycastを最大限活用するパターン

第6章 ベストプラクティス ── Raycastを最大限活用するパターン

実践者の知見から

RaycastのコミュニティはReddit・Hacker News・Xに豊富な知見を蓄積している。「インストールしたが使いこなせていない」という体験から「これが効いた」という発見までが並んでいる。本章ではその中から繰り返し言及されるパターンを整理する。

ベストプラクティス1：まず「Spotlight の代わり」として使い始める

Raycastで最もよく聞く失敗は「インストールしたが何をすればいいか分からなかった」だ。

正しい始め方：

Week 1: Spotlight を完全にオフにして Raycast に移行
  → まず「アプリ起動・ファイル検索」だけ使う
  → この段階でUIと検索精度に慣れる

Week 2: 最も使うツールの拡張機能を1〜2個インストール
  → エンジニアなら GitHub + Linear
  → PMなら Notion + Linear
  → デザイナーなら Figma + Color Picker

Week 3: クリップボード履歴を使い始める
  → ⌘ + Shift + V のショートカットを設定して呼び出す
  → 1週間でなくてはならない機能になる

Month 2: スニペットを作り始める
  → 繰り返し打っている文章に気づいたらすぐスニペットにする

「全機能を最初から使おうとしない」 ことが最大のベストプラクティスだ。

ベストプラクティス2：ホットキーを意味のある体系で設計する

Raycastのショートカットを無秩序に設定すると、すぐに覚えられなくなる。

体系的なホットキー設計の例

接頭辞 ⌃ + ⌥ + キー：ウィンドウ管理
  ⌃ ⌥ ← → 左半分
  ⌃ ⌥ → → 右半分
  ⌃ ⌥ ↑ → フルスクリーン
  ⌃ ⌥ ↓ → 元のサイズに戻す

接頭辞 ⌃ + ⌥ + 数字：よく使うアプリ
  ⌃ ⌥ 1 → VS Code
  ⌃ ⌥ 2 → Browser（Chrome/Arc）
  ⌃ ⌥ 3 → Slack
  ⌃ ⌥ 4 → Linear

⌃ ⌥ H：クリップボード履歴（History の H）
⌃ ⌥ N：浮動ノート（Note の N）

「何でもいいからショートカットを設定する」ではなく「記憶できる体系を作る」ことが重要だ。

ベストプラクティス3：スニペットを「使い捨てメモ」ではなく「永続的な資産」として扱う

スニペットの効果を実感するのに時間がかかるのは、「どこに使うか意識していない」からだ。

スニペット棚卸しの方法：

1週間、自分の入力を観察する
「同じ文章を2回以上打ったら」→ スニペット化のサイン

例：
・毎朝のスタンドアップテンプレート
・よく使うAPIエンドポイントのベースURL
・メールの署名
・よく使うコードパターン（import文、try-catch骨格など）
・会議の議事録テンプレート
スニペット設計のルール

1. 略称は「! + 覚えやすい略語」にする
   !standup, !sig, !lgtm, !wip

2. 動的変数を使う（{date}, {clipboard}）
   !mtg → "本日（{date}）の会議について..."

3. チームと共有できるものはTeamsプランで共有
   チームの全員が同じ定型文を使える

ベストプラクティス4：クリップボード履歴を「一時メモリ」として意識する

クリップボード履歴の使い方が変わるのは「コピーしたものが全部残っている」という前提で行動し始めたときだ。

活用パターン：情報収集 → 後でまとめる

調査中：
  → 重要な文章・数字・URLをコピーしまくる
  → 「後で使うかも」と思ったものを全部コピー

まとめるとき：
  → Raycast → Clipboard History を開く
  → ⌘ + K で全履歴を検索
  → 必要なものを選んで貼り付け

「さっきコピーしたURL、どこに行った？」
「あの数字、もう一度取ってこないと」
──このような時間ロスがなくなる

ベストプラクティス5：AIは「一往復で終わる仕事」に使う

Raycastのクイック操作の文脈では、AIとの長い会話は向いていない。

Quick AI が向いているタスク（30秒以内）：

✅ 適切
  「このコードのエラーメッセージを説明して」（コード貼り付け）
  「○○の英語表現は？」
  「HEX #1F2937 は何色？」
  「UNIX timestamp 1706780400 を人間が読める時刻に変換」

❌ 適切でない（AI Chatの方が向く）
  「このドキュメント全体をレビューして」
  「このコードをリファクタリングして、理由も説明して」
  「この提案書のフィードバックを詳しく」

AI Commandsは「文章の磨き込み」に特に効果的だ。書いた文章を全選択→ “Improve Writing” → 出力を確認→採用か修正かを判断。Raycastを閉じずに完結する。

ベストプラクティス6：拡張機能は「使わないものはアンインストール」する

「後で使うかも」で溜め込まないことが重要だ。

月に1回の拡張機能レビュー

確認する：
  先月使ったコマンドの一覧（Raycast → Raycast Settings → Commands）

基準：
  先月1回も使わなかった → アンインストール
  週1回以上使っている → ショートカットを設定する

理由：
  コマンドが多すぎるとRaycastの検索ノイズが増える
  よく使うコマンドが埋もれて見つけにくくなる

ベストプラクティス7：スクリプトランナーで「繰り返し手順」をコマンド化する

「これを実行するたびにターミナルを開く」という作業を見つけたら、スクリプト化のチャンスだ。

#!/bin/bash
# @raycast.schemaVersion 1
# @raycast.title 週次レポート準備
# @raycast.mode fullOutput
# @raycast.icon 📊

# 先週のGitコミット数を集計
echo "=== 先週のコミット ==="
git log --since="1 week ago" --author="$(git config user.email)" \
  --oneline | wc -l

# LinearのIssueをAPI経由で取得（要：環境変数設定）
echo ""
echo "=== 完了したIssue ==="
curl -s -H "Authorization: $LINEAR_API_KEY" \
  "https://api.linear.app/graphql" \
  -d '{"query":"{ issues(filter:{completedAt:{gte:\""$(date -d \"7 days ago\" +%Y-%m-%d)\""}}){nodes{title}}}"}' \
  | jq -r '.data.issues.nodes[].title'

ベストプラクティス8：チームにRaycastを導入するときは「Teamsプランで共有セット」から始める

個人で使えるようになったら、チームへの展開を検討する。

チーム導入のステップ

Step 1: 共有クイックリンクを整備する
  - ステージング環境URL
  - 本番モニタリングダッシュボード
  - 社内ドキュメントのトップページ
  - よく使うJiraフィルター

Step 2: 共有スニペットを作る
  - チーム全員が使う定型文
  - 顧客対応のテンプレート
  - 社内手続きの連絡テンプレート

Step 3: チーム共有の拡張機能セット（推奨）を伝える
  - 「このチームでは最低限これを入れてほしい」リスト
  - 新メンバーのオンボーディング資料に含める

ベストプラクティス一覧

#プラクティス効果対象ユーザー
1Spotlightから段階的に移行学習曲線を緩やかに初心者
2ホットキーを体系的に設計記憶しやすく・素早く全員
3スニペットを永続的資産として構築繰り返し入力ゼロ全員
4クリップボード履歴を一時メモリとして使う情報収集効率向上全員
5AIは「一往復タスク」に絞るAI活用効果最大化AI活用者
6拡張機能は月次レビューで整理検索精度の維持全員
7繰り返し手順をスクリプト化オペレーション自動化エンジニア
8チームはTeamsプランから展開組織全体の効率向上チームリード