為您的專案自訂 AI
本指南將引導您在 Visual Studio Code 中為您的專案設定 AI 自訂功能。您將從基本的程式碼標準開始，逐步新增更具針對性的功能。
最後，您的專案將具備
- 適用於每個聊天請求的專案範圍程式碼標準
- 前端程式碼的檔案專屬指令
- 用於常見任務的可重複使用提示檔
- 具備受限工具的自訂代理人
- 具備專業能力的技能
先決條件
- 已安裝 VS Code
- GitHub Copilot 方案 (免費版、專業版、商業版或企業版)
- 已安裝 GitHub Copilot 擴充功能
- 在 VS Code 中開啟的工作區或資料夾
步驟 1：設定專案範圍的程式碼標準
首先，產生一個指令檔，其中包含您專案的程式碼標準。這些指令會自動包含在每個聊天請求中。
-
開啟聊天檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))。
-
輸入
/init並按下 Enter。/init -
VS Code 會分析您的專案結構，並產生一個專為您的程式碼基底量身打造的
.github/copilot-instructions.md檔案。 -
檢閱並自訂生成的檔案。例如，新增一條關於您偏好的匯入風格的規則
## Imports - Use named imports instead of default imports. - Group imports: external libraries first, then internal modules, then relative paths. -
儲存檔案。
驗證是否有效：要求 Copilot 產生一些程式碼 (例如，「建立一個用於日期格式化的工具函式」)。檢查回應是否符合您的程式碼標準。選取聊天回應中的「參考資料」區段，確認已包含 copilot-instructions.md。
若要深入了解常駐指令，請參閱使用自訂指令。
步驟 2：新增檔案專屬指令
當程式碼基底的不同部分遵循不同慣例時，請使用包含 applyTo 模式的指令檔來指定特定檔案類型。
-
開啟聊天檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))。
-
輸入
/create-instructions，接著輸入您要建立的指令描述，然後按下 Enter。/create-instructions React-specific coding standards -
回答關於指令的澄清問題，並檢閱生成的指令檔。
驗證是否有效：開啟一個 .tsx 檔案，並要求 Copilot「建立一個使用者個人資料卡片元件」。回應應該遵循您針對 React 專屬的慣例。檢查「參考資料」區段，確認已套用指令檔。
您可以為不同的檔案類型、框架或模組建立多個指令檔。若要深入了解，請參閱使用 .instructions.md 檔案。
步驟 3：建立可重複使用的提示檔
提示檔將常見任務編碼為您可以在聊天中叫用的斜線指令。為您經常執行的任務建立一個提示檔。
-
開啟聊天檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))。
-
輸入
/create-prompt，接著輸入您要建立的提示描述，然後按下 Enter。/create-prompt Scaffold a new React component with tests -
回答關於提示的澄清問題，並檢閱生成的提示檔。
驗證是否有效：在聊天檢視中，輸入 /<提示名稱> data table with sorting and filtering，然後按下 Enter。代理人應根據您的慣例建立元件和測試檔案。
在聊天中輸入 /create-prompt 以透過 AI 協助生成提示檔。您也可以透過詢問「將此工作流程儲存為提示」從正在進行的對話中提取可重複使用的提示。若要深入了解，請參閱使用提示檔。
步驟 4：建立自訂代理人
自訂代理人讓 AI 能夠以具備特定工具存取權的專業角色運作。建立一個只能讀取程式碼而不能修改程式碼的程式碼審閱代理人。
-
開啟聊天檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))。
-
輸入
/create-agent，接著輸入您要建立的代理人描述，然後按下 Enter。/create-agent A code reviewer that analyzes code for quality, security, and best practices without modifying files -
回答關於代理人的澄清問題，並檢閱生成的代理人檔案。
驗證是否有效：在聊天檢視中的代理人下拉選單中選取「審閱者」代理人，然後詢問「審閱驗證模組」。代理人應分析程式碼而不進行任何更改。
您可以為代理人新增 handoffs 以建立引導式工作流程。例如，從規劃代理人轉交給實作代理人。若要深入了解，請參閱自訂代理人。
步驟 5：建立具備專業能力的技能
技能是指令、指令碼和資源的資料夾，Copilot 會在執行專業任務時載入這些內容。與定義程式碼標準的指令檔不同，技能教導 Copilot 如何執行特定工作流程。
-
從命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 執行「Chat: Open Customizations」命令以開啟聊天自訂編輯器。
-
選取「技能」分頁，然後從下拉式選單中選取「新增技能 (工作區)」。
-
輸入技能名稱，例如
update-readme，然後按下 Enter。 -
將以下內容新增至
SKILL.md檔案--- name: update-readme description: Update the project README to reflect recent code changes. Whenever code changes are made, this skill reviews the changes and updates the README with new features, usage instructions, and API references. --- # Update README When updating the README: 1. Review recent code changes to identify new or modified features 2. Update the relevant sections (installation, usage, API reference) 3. Add entries for new commands, configuration options, or environment variables 4. Remove documentation for deleted or deprecated features 5. Keep the existing tone, structure, and formatting conventions
驗證是否有效：在聊天中，要求 Copilot 為您的專案新增功能 (例如，「新增一個健康檢查端點」)。當它生成程式碼時，也應自動使用新端點的文件更新 README。您也可以在聊天檢視中輸入 /update-readme 直接叫用技能。
在聊天中輸入 /create-skill 以透過 AI 協助生成技能。您也可以透過詢問「從我們剛剛執行的操作建立技能」從正在進行的對話中提取技能。若要深入了解，請參閱代理人技能。
您已建立的項目
您的專案現在已具備分層的 AI 自訂設定
your-project/
.github/
copilot-instructions.md # Project-wide coding standards (Step 1)
instructions/
react.instructions.md # React-specific conventions (Step 2)
prompts/
create-component.prompt.md # Reusable component scaffolding (Step 3)
agents/
reviewer.agent.md # Read-only code reviewer (Step 4)
skills/
update-readme/
SKILL.md # README updater workflow (Step 5)