如何在 Raycast AI 中建立自訂 AI 指令與快速預設打造高效桌面工作流程

在日常開發與辦公過程中，頻繁於程式碼編輯器、終端機與瀏覽器 AI 對話介面之間來回切換，極易分散專注力。Raycast AI 透過 macOS 系統級啟動器的型態，將大型語言模型無縫融入桌面環境。使用者無需反覆複製文字、打開網頁、貼上提問再取回結果，僅需一組快捷鍵即可在前台任何應用程式中完成專屬的 AI 處理流程。

Raycast AI 針對不同使用情境提供兩大互補核心功能：

1. 自訂 AI 指令（Custom AI Commands）：單次觸發的提示詞動作，直接讀取反白選取的文字或剪貼簿內容，支援於懸浮視窗展示結果或直接就地取代選取文字。
2. AI 預設與智能體（AI Presets / Agents）：適用於多輪連續對話的系統提示詞範本與角色設定，整合指定模型、推理深度與權限受控的工具擴充套件。

本文將完整示範如何建立自訂 AI 指令、設定專屬預設智能體、活用動態預留位置以及配置全域快捷鍵，協助 macOS 使用者與開發者打造極速桌面 AI 效率環境。

一、建立自訂 AI 指令（AI Commands）

自訂 AI 指令非常適合輸入與輸出目標明確的單一步驟工作，例如程式碼重構、格式轉換、語法潤飾與錯誤除錯。

詳細建立步驟

1. 按下 ⌥ Space（或你自訂的 Raycast 啟動快捷鍵）開啟啟動器。
2. 在搜尋框中輸入 Create AI Command 並按 Enter。（亦可在 Search AI Commands 列表中選取內建指令，按下 ⌘D 複製後微調）。
3. 填寫指令設定表單：
   • Name & Icon（名稱與圖示）：命名清晰易讀的識別名稱（例如 Refactor to TypeScript 或 Explain SQL Query），並選取相應圖示。
   • Prompt（提示詞指令）：撰寫交給模型的具體指令。輸入 { 可插入動態預留位置，輸入 @ 可調用擴充工具。
   • Model（模型）：指定運作該指令的模型（如 Claude 3.5 Sonnet、GPT-4o 或具備深入推導能力的 o1/o3-mini）。若未特別指定，將自動沿用全域預設（Settings → AI → Models & Providers）。
   • Creativity（隨機發散度）：提供 None、Low、Medium、High 與 Maximum 五個等級。針對程式碼重構或 JSON 結構解析等嚴謹任務，建議設定為 None 或 Low。
   • Reasoning Effort（推理深度）：若選用具備推理算力調節的模型，可設定思考時間預算。
   • Output Behavior（輸出模式）：
     • Open in Raycast：在獨立的 Raycast 懸浮視窗中檢視結果，方便閱讀與複製，亦可按 ⌘J 攜帶上下文無縫轉入完整 AI Chat 繼續對話。
     • Replace Selection：執行後直接在當前編輯器或文字框中，以生成結果覆蓋原本選取的文字，極為適合原地重構與文案編修。
   • Highlight Editing Changes（高亮顯示修改）：搭配就地取代功能使用，直觀標示變更內容。
4. 按下 ⌘ Enter 儲存，該指令即可立刻於根搜尋列中檢索並執行。

二、靈活運用動態預留位置（Dynamic Placeholders）

Raycast 具備強大的動態預留位置機制，能自動帶入桌面當前環境的即時上下文，省去手動複製貼上的繁瑣動作。

管道修飾符（Modifiers）

可透過管道語法串接修飾符對輸入內容進行格式化：

• {clipboard | trim}：去除剪貼簿文字前後的多餘空格與換行。
• {selection | lowercase} 或 {selection | uppercase}：統整文字大小寫。
• {selection | json-stringify}：將文字轉義為合規字串，安全嵌入 JSON 結構。
• {clipboard | raw}：停用系統預設附加的外層引號。

開發者實用指令範例

範例 1：就地推導 TypeScript 型別與 JSDoc 文件

• 輸出模式：Replace Selection
• Creativity：Low
• Prompt 內容：

Analyze the following code selection:
{selection}

Add strict TypeScript types, explicit interface definitions, and JSDoc documentation. Return only the updated code block without surrounding explanations or markdown wrappers.

範例 2：互動式 Git Commit 訊息產生器

• 輸出模式：Open in Raycast
• Prompt 內容：

Write a concise, conventional git commit message based on the following diff or staged summary:
{clipboard}

Focus on type: {argument name="Commit Type" default="feat"}.
Format as:
<type>(<scope>): <summary>

- Optional body explaining the why behind the change.

三、配置 AI 預設（Presets）與專屬智能體（Agents）

單發式的 AI 指令適用於局部獨立任務，而面對架構設計或深度除錯等情境，開發者通常需要固定的系統角色設定、架構準則與受限的工具存取權。

在 Raycast v1 中，此功能稱為 AI Chat Presets；在 Raycast v2 中，該模組進一步昇華並命名為 Agents（智能體），同時全面相容現有的預設設定檔與社群 Preset Explorer。

建立自訂 Agent / 預設

1. 開啟 Settings → AI → Agents（或在主畫面輸入 Search Agents 並選取 Create Agent）。
2. 設定智能體屬性：
   • Name & Icon：設定明確角色識別（例如 PostgreSQL 調校顧問 或 API 架構分析師）。
   • Model：指定特定模型，或選取 Inherit 繼承目前對話視窗所採用的模型。
   • Instructions（系統提示詞）：定義長效 System Prompt，規範其專業範疇、程式規範與輸出格式。
   • AI Extensions（工具擴充）：勾選該 Agent 獲准使用的系統或第三方外掛（例如 @calendar、@github 等）。
3. 按下 ⌘ Enter 完成儲存。

叫出與切換智能體

• 對話介面中快速切換：在 AI Chat 輸入框鍵入 / 叫出快速切換清單，或按下 ⌘K → Change Agent。
• 由啟動器直接呼叫：在主搜尋列直接輸入 Agent 名稱，按下 Enter 即可啟動已載入該角色的專屬對話視窗。
• 社群資源匯入：前往 presets.ray.so 探索豐富的開源預設範本，一鍵匯入個人 Raycast。

四、全域快捷鍵與 Quick Fix 即時修復整合

將高頻指令與智能體綁定至系統快捷鍵，能徹底消弭操作中斷：

1. 設定獨立全域 Hotkey：

   • 前往 Settings → Extensions → AI（或在任一指令上按下 ⌘K → Configure Command）。
   • 在該指令或 Agent 的 Hotkey 欄位中錄製按鍵組合（例如為 Commit 產生器設定 ⌃⌥C，為原地重構設定 ⌃⌥R）。
   • 完成後，於 VS Code 或 Xcode 中圈選文字，直接按下 ⌃⌥R 即可原地完成轉換，無須開啟主啟動器搜尋。

2. 啟用 Quick Fix 原地校對：

   • Raycast 內建專為輸入文字校對設計的 Quick Fix 功能。
   • 預設連按兩下 右側 Shift 鍵（Double Right Shift），即可對當前輸入框或反白文字進行語法與拼字修正。
   • 於 Settings → AI → Quick Fix 中啟用 Preserve Formatting，可在 Notion 或 Slack 等應用中修復文字時，保留粗體、超連結與特定樣式。

五、系統權限、收費機制與模型整合須知

輔助使用權限授權

Replace Selection（原地取代選取內容）與 Quick Fix 需透過系統輔助使用 API 進行按鍵模擬。初次使用請至：

• 系統設定 → 隱私權與安全性 → 輔助使用（macOS 27 及後續版本為「裝置控制與資料存取」）。
• 確認已賦予 Raycast 完整的控制權限。

訂閱機制與 BYOK（自備 API 金鑰）

• Raycast 免費版：提供核心啟動器工具（計算機、剪貼簿歷史、快捷文字片段與外掛商店）。
• Raycast Pro（每月 10 美元 或 每年 96 美元）：解鎖 Raycast AI，包含每月固定額度的 AI 點數（AI Credits）、雲端同步與自訂 AI 指令支援。
• Pro+ 與 Max 方案：為重度開發需求提供更龐大的點數額度與頂級模型存取權。
• BYOK 與外部訂閱串接：Pro 等級以上訂閱用戶支援串接 OpenAI、Anthropic、Google 及 OpenRouter 的 API Key，亦可直接連動既有的 ChatGPT / Claude 個人訂閱方案，在享受 Raycast 本地原生快捷介面的同時，彈性控制模型開銷。

結合輕量快速的單發自訂指令與深度互動的專屬預設角色，macOS 使用者能夠將 AI 算力融入敲擊鍵盤的每一個瞬間，大幅提升桌面工作產能。

參考資料

• AI Commands | Raycast Manual
• Dynamic Placeholders | Raycast Manual
• Agents | Raycast Manual
• AI Chat | Raycast Manual