如何寫出優秀的agents. md：來自2500+ 程式碼庫的經驗總結 核心理念傳統的"你是一個有用的程式設計助手" 這類模糊指令並不有效，真正起作用的是具體的角色定義，例如明確說明"你是一位測試工程師，專門為React 元件編寫測試，遵循特定範例，且絕不修改原始程式碼"。 agents. md 檔案的作用是定義智能體的完整工作手冊：角色定位、技術堆疊知識、專案文件結構、工作流程、可執行指令、程式碼風格範例，以及最重要的－明確的操作邊界。 五個關鍵要素透過分析發現，成功的agents. md 檔案普遍遵循以下實踐： 1. 指令前置將可執行指令放在檔案前部，包含完整的指令參數和選項，例如npm test、pytest -v，而不僅僅是工具名稱。 2. 用程式碼範例取代文字說明一個真實的程式碼片段比三段描述性文字更有效。直接展示期望的輸出樣式。 3. 設定清晰邊界明確告知AI 哪些內容絕對不能觸碰，如敏感資訊、vendor 目錄、生產配置等。 "永遠不要提交密鑰"是最常見的有效約束。 4. 具體說明技術堆疊應該寫"React 18 + TypeScript，使用Vite 和Tailwind CSS"，而非籠統的"React 項目"，需包含版本號和關鍵依賴。 5. 涵蓋六大核心領域命令、測試、專案結構、程式碼風格、Git 工作流程和操作邊界——涵蓋這些領域能讓你的設定檔進入頂級水平。 實戰範例提供了一個文檔智能體的完整配置範例，展示如何將上述原則應用到實際場景。此配置包括： · 明確角色定位：技術文件專家，精通Markdown 和TypeScript · 專案知識：具體的技術堆疊版本和檔案目錄結構· 可用指令：npm run docs:build 和npx markdownlint docs/ · 三級邊界系統：總是做什麼、需要先問什麼、絕對禁止什麼 幾種值得建構的專用智能體 @ docs-agent：讀取程式碼產生文檔，只寫入docs/ 目錄 @ test-agent：寫測試，不能刪除失敗的測試案例 @ lint-agent：修復程式碼格式，不改變邏輯 @ api-agent：建置API 端點，修改資料庫架構前需詢問 @ dev-deploy-agent：處理本機建置和部署，僅限開發環境 實施建議從簡單任務開始，不要試圖建構"通用助手"。選擇具體任務如編寫函數文件、新增單元測試或修復程式碼檢查錯誤。 最精簡的配置只需三個要素：智能體名稱、簡短描述、具體角色定位。你也可以讓Copilot 幫助產生初始配置，然後根據實際專案調整。 核心啟示最優秀的智能體配置是透過迭代逐步完善的，而非一次性規劃完成。從簡單配置開始，測試運行，當智能體出錯時再添加更多細節。成功的關鍵在於提供具體的角色定位和詳細的操作手冊，而不是模糊的提示詞。 部落格網址：
