免費 AI Coding Agent 設定檢查清單

2. 你的檢查清單（可直接勾選，或用瀏覽器列印存成 PDF）

一次性：讓專案準備好給 Agent（約 30 分鐘）

• 在專案根目錄放 AGENTS.md，寫上確切的安裝、測試、lint、型別檢查與建置指令
• 在乾淨的 checkout 上實際跑過每一條指令
• 提供並記錄「只跑單一測試」的指令，讓回饋更快
• CLAUDE.md 用 @AGENTS.md 引用，不要重複內容
• 寫一段「禁止事項」：新增依賴、改 lockfile、migration、密鑰、刪測試、force-push
• .env.example 列出所有環境變數，真正的 .env 加入 gitignore
• 用 pre-commit 或 CI 自動跑 lint 與測試，Agent 才不會「忘記」
• 安全指令加入允許清單，危險指令需要手動核准

每次任務前（1 分鐘）

• 工作區乾淨，開新分支或 worktree
• 把目標寫成可觀察的結果，並說明如何驗證
• 備好相關路徑、錯誤訊息或 issue 連結
• 講清楚限制（不加依賴、API 不變等）
• 改動超過 3 個檔案或需求不明確時，先規劃再動手
• 開新的 session，避免舊上下文干擾

合併前

• 讀完整個 diff，不只看摘要
• git diff --stat 只出現預期中的檔案
• CI 上型別檢查、lint 與完整測試通過，而不是 Agent 說「本機通過」
• 新行為有測試，沒有測試被刪除、跳過或放寬
• 親手跑過一次功能
• 沒有密鑰、除錯輸出或被註解掉的程式碼

想要完整版？

$19 設定包包含三種技術棧的 AGENTS.md / CLAUDE.md / Cursor 規則範本、6 個提示詞、工作流程指南、完整檢查清單與實例。