AI Vibe Coding 時代，別再讓 Agent 瞎子摸象。透過配置 .agent 資料夾，將開發經驗「資產化」，讓 IDE 從對話者進化為專案架構師。
list文章目錄expand_more
list文章目錄
為什麼你的 AI Agent 總是「聽不懂人話」？#
如果你跟我一樣，日常工作流程都讓伴隨著 AI，你一定遇過這種狀況：AI 的產出能符合你的需求，但是表現浮動，常常不符合你的專案架構；或是它一直反覆犯同樣的錯誤，即便你已經糾正過好幾次。
這不是 AI 的智力問題，而是 「上下文貧血（Context Anemia）」 的問題。
在 【入門】Git 與 GitHub：版本控制與協作神器 中我提過，理解工具流程是馴服野馬的第一步。
我們需要一套「工作區層級（Workspace-level）」的配置，管理 Agent 處理專案時能明確遵循特定邏輯。
這就是建立 .agent 資料夾的核心意義。
一、 .agent 的核心架構：Skills, Rules, Workflows#
為了讓 Agent 精準運作，我們不能直接丟一串落落長的 System Prompt。
正確的做法是要把知識和規範進行拆解，讓它按照情況「隨選載入」。在根目錄建立以下結構：
1. Skills：賦予 Agent 原子化的能力#
這是整個配置最靈魂的部分。不要試圖寫一個「做所有事」的指令，而是建立 原子化技能（Atomic Skills）。
skills/：每個子資料夾代表一個獨立技能（如：git-commit/、sql-migration/）。SKILL.md：定義技能名稱、觸發場景（讓 Agent 判斷何時調用）及具體步驟。scripts/：存放 Python 或 Bash 腳本。遇到複雜任務（如資料庫遷移、環境部署）時，Agent 會直接執行這些腳本，而非一直問你下一步。resources/：放範本（Template）或參考文件。
2. Rules：設定不可逾越的開發紅線#
這裡存放的是專案的規範。當 Agent 生成或修改代碼時，必須強制參考這裡的規則：
rules/code-style.md：定義命名規範、縮排、或是「所有 Python 函式必須包含 Docstring」。rules/tech-stack.md：明確告知技術版本（例如：我們用 Next.js 15，別給 Pages Router 的寫法）。rules/security.md：禁止寫死 API Key 或規定必須進行輸入驗證。
3. Workflows：標準化的指令流水線#
這裡存放自定義的「儲存提示詞（Saved Prompts）」。
workflows/：你可以設定特定的觸發關鍵字。例如透過/test快速觸發單元測試產生器，或透過/review讓 Agent 檢查當前的 Git Diff 是否符合規範。
二、 如何透過配置提升開發效率？#
從「對話者」轉向「架構師」，只需要多做這三件事：
1. 複雜動作腳本化#
將繁瑣的 CLI 指令封裝在 skills/*/scripts/ 中，這樣可以明確控制 AI 的產出結果，避免 AI 表現不穩定。
舉例來說，當需要部署到測試環境時，只需要對 Agent 說一句話，它會自動調用你寫好的腳本，實現真正的自動化，而非手動複製貼上指令。
2. 減少指令疲勞#
相較於把所有規則塞進一個巨大的 .cursorrules，資料夾化的「隨選載入」能顯著 節省 Context 空間 。Agent 只有在需要時才讀取對應的 SKILL.md，這不僅能降低延遲（Latency），還能防止 AI 因為指令過多而產生幻覺。
3. 自動化 Review 流程#
在 rules/ 中定好規範，Agent 在寫程式碼的當下就已經完成了「自我校對」。這就像是有一個 24 小時在線的資深工程師在旁盯梢，省去事後手動調整或是再請 AI 做整體 code review 的時間。
三、 核心價值：將開發經驗「資產化」#
為什麼我們非得這麼麻煩建資料夾不可？因為這關乎到 「知識資產化」。
- 知識不隨對話消失 ：你在開發某個冷門 API 時累積的呼叫經驗，被固化為一個
SKILL.md。這代表即使你開啟新的對話視窗，Agent 依然維持同樣的高水準。（舉例來說，IBKR 的 API 就是出了名的難用，開發一次留存下來的經驗可以被複用，對開發者來說就是一種複利資產。） - 資料主權與團隊共享 ：
.agent資料夾可以跟著 Git 進入版本控制。這符合我一直強調的「Clean Data」概念 —— 開發邏輯不鎖在別人的伺服器裡，而是存在自己的 Repo 中。 - 跨團隊無縫同步 ：新成員只要
git pull，他們的 IDE 就能立刻學會專案的所有規矩與技能，達成真正的開發一致性。
從寫代碼到定義規則#
開發者的價值正在從「寫代碼」轉移到「定義規則」。
透過 .agent 資料夾，你不再是被動地與 AI 聊天，而是主動建構一個能理解你意圖的數位助手。
這不僅是為了好管理，更是為了在未來的開發競速中，擁有一套能不斷進化的個人管理體系。
以上。
