在 VS Code 中使用提示詞檔案

提示詞檔案（也稱為斜線指令）讓您可以將常見任務編碼為獨立的 Markdown 檔案，直接在對話中調用，藉此簡化提示詞編寫流程。每個提示詞檔案都包含任務特定的上下文，以及關於應如何執行該任務的指導方針。

與自動套用的自訂指令 (Custom Instructions) 不同，您需要手動在對話中調用提示詞檔案。

使用提示詞檔案來

• 簡化常見任務的提示詞編寫，例如建構新元件、執行並修復測試，或是準備合併請求 (Pull Request)
• 覆蓋自訂代理 (Custom Agent) 的預設行為，例如建立最小化實作計畫或為 API 呼叫產生模擬資料

提示詞檔案位置

您可以為特定工作區或使用者層級定義提示詞檔案，後者可在您所有的工作區中使用。下表列出了根據範圍劃分的提示詞檔案預設位置。您可以透過 chat.promptFilesLocations 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定來配置工作區提示詞檔案的額外檔案位置。

若要建立使用者資料中的提示詞檔案，請使用「代理自訂編輯器 (Agent Customizations editor)」或使用 Chat: New Prompt File 指令。

提示詞檔案格式

提示詞檔案是副檔名為 .prompt.md 的 Markdown 檔案。選用的 YAML 前言標頭 (frontmatter) 可配置提示詞的行為：

主體包含 Markdown 格式的提示詞文字。請提供具體的指示、指導方針或任何您希望 AI 遵循的相關資訊。

您可以使用 Markdown 連結參考其他工作區檔案。請使用相對路徑來參照這些檔案，並確保路徑根據提示詞檔案的位置是正確的。

若要在主體文字中參照代理工具，請使用 #tool:<tool-name> 語法。例如，若要參照 browser 工具，請使用 #tool:browser。

下列範例示範了如何使用提示詞檔案。更多社群貢獻的範例，請參閱 Awesome Copilot 儲存庫。

---
agent: 'agent'
model: GPT-4o
tools: ['search/codebase', 'vscode/askQuestions']
description: 'Generate a new React form component'
---
Your goal is to generate a new React form component based on the templates in the Github repo contoso/react-templates.

Use the #tool:vscode/askQuestions to ask for the form name and fields if not provided.

Requirements for the form:
* Use form design system components: [design-system/Form.md](../docs/design-system/Form.md)
* Use `react-hook-form` for form state management:
* Always define TypeScript types for your form data
* Prefer *uncontrolled* components using register
* Use `defaultValues` to prevent unnecessary rerenders
* Use `yup` for validation:
* Create reusable validation schemas in separate files
* Use TypeScript types to ensure type safety
* Customize UX-friendly validation rules

---
agent: 'ask'
model: Claude Sonnet 4
description: 'Perform a REST API security review'
---
Perform a REST API security review and provide a TODO list of security issues to address.

* Ensure all endpoints are protected by authentication and authorization
* Validate all user inputs and sanitize data
* Implement rate limiting and throttling
* Implement logging and monitoring for security events

Return the TODO list in a Markdown format, grouped by priority and issue type.

建立提示詞檔案

建立提示詞檔案時，請選擇將其儲存在您的工作區或使用者設定檔中。工作區提示詞檔案僅適用於該工作區，而使用者提示詞檔案則可在多個工作區中使用。

建立提示詞檔案

1. 在對話視圖中，選擇配置對話（齒輪圖示）以開啟「代理自訂編輯器」，然後選擇提示詞 (Prompts) 分頁。

2. 根據您想要儲存提示詞檔案的位置，從下拉式選單中選擇新提示詞 (工作區) 或新提示詞 (使用者)。

   

   或者，從指令選擇區（⇧⌘P (Windows, Linux Ctrl+Shift+P)）使用 Chat: New Prompt File 或 Chat: New Untitled Prompt File 指令。

3. 選擇位置並為您的提示詞檔案輸入檔案名稱。這是在對話中輸入 / 時顯示的預設名稱。

4. 使用 Markdown 格式編寫對話提示詞。

   • 填寫檔案頂部的 YAML 前言，以配置提示詞的描述、代理、工具和其他設定。
   • 在檔案主體中加入提示詞的指示。

您可以透過在「代理自訂編輯器」中開啟現有的提示詞檔案來進行修改。

使用 AI 產生提示詞檔案

您可以利用 AI 根據任務描述來產生提示詞檔案。在對話中輸入 /create-prompt 並描述您想要自動化的任務（例如：「用於產生單元測試的提示詞」）。代理會詢問澄清問題，產生帶有適當前言和指示的 .prompt.md 檔案，並讓您選擇儲存在工作區或使用者層級。

您也可以從進行中的對話中提取可重複使用的提示詞。例如，在多輪對話之後，要求「將此轉換為可重複使用的提示詞」或「將此工作流程儲存為提示詞」，代理就會建立一個擷取該工作流程的提示詞檔案。

您也可以在「代理自訂編輯器」中選擇產生提示詞來產生提示詞檔案。

在對話中使用提示詞檔案

您有多種選項可以執行提示詞檔案

• 在對話視圖中，於輸入欄位中輸入 / 後接提示詞名稱。代理技能也會與提示詞檔案一起顯示為斜線指令。

  您可以在對話輸入欄位中加入額外資訊。例如，/create-react-form formName=MyForm 或 /create-api for listing customers。

• 從指令選擇區（⇧⌘P (Windows, Linux Ctrl+Shift+P)）執行 Chat: Run Prompt 指令，並從選取清單中選擇一個提示詞檔案。

• 在編輯器中開啟提示詞檔案，並按下編輯器標題區的播放按鈕。您可以選擇在目前對話中執行提示詞，或是開啟一個新的對話。

  此選項對於快速測試和迭代您的提示詞檔案非常有用。

工具列表優先順序

您可以透過 tools 中繼資料欄位為自訂代理和提示詞檔案指定可用工具列表。提示詞檔案也可以使用 agent 中繼資料欄位來參照自訂代理。

對話中可用工具的列表由以下優先順序決定：

1. 提示詞檔案中指定的工具（若有）
2. 提示詞檔案中參照的自訂代理所提供的工具（若有）
3. 所選代理的預設工具（若有）

跨裝置同步使用者提示詞檔案

VS Code 可以使用設定同步 (Settings Sync) 在多個裝置間同步您的使用者提示詞檔案。

若要同步您的使用者提示詞檔案，請啟用設定同步，並從指令選擇區（⇧⌘P (Windows, Linux Ctrl+Shift+P)）執行 Settings Sync: Configure。從要同步的設定列表中選擇 Prompts and Instructions。

編寫有效提示詞的技巧

• 清楚描述提示詞應達成什麼目標，以及期望的輸出格式。

• 提供預期輸入和輸出的範例，以引導 AI 的回應。

• 使用 Markdown 連結來參照自訂指令，而不是在每個提示詞中重複指導方針。

• 利用內建變數（如 ${selection}）和輸入變數，讓提示詞更具彈性。

• 使用編輯器播放按鈕來測試您的提示詞，並根據結果進行改進。

常見問題

如何知道提示詞檔案的來源？

提示詞檔案可能來自不同的來源：內建、您設定檔中定義的使用者提示詞、目前工作區定義的工作區提示詞，或擴充功能提供的提示詞。

若要識別提示詞檔案的來源：

1. 從指令選擇區（⇧⌘P (Windows, Linux Ctrl+Shift+P)）選擇 Chat: Configure Prompt Files。
2. 將滑鼠懸停在列表中的提示詞檔案上，來源位置會顯示在工具提示中。

相關資源

• 建立自訂指示
• 在對話中配置工具
• 社群貢獻的指令、提示詞和自訂代理