project-root/ ├── ai_system_default.md ├── docs/ │ ├── B.md │ └── sub/ │ └── C.md └── other/ └── D.md
近期使用 AI開發過程中，為了讓AI更有邏輯和系統，
試著用 MD 檔案 規劃AI規格書。
這樣能讓AI回答的每一個需求和功能，都在系統範圍內。
用多個 md 檔案分工,核心概念就是:
1. 降低單次上下文負擔
每個檔案只聚焦一個功能/模組,AI 讀取時不用一次消化整個專案的邏輯,判斷力會更準。
2. 減少「跳針」(邏輯混淆)
如果所有規則塞在同一個超大檔案裡,AI 容易在不相關的段落之間產生錯誤關聯,或是新增內容時複寫掉舊邏輯。分開後,修改 A 功能不會不小心影響到 B 功能的敘述。
3. 可維護性提升
之後要調整某個功能邏輯時,直接開對應的 md 檔案改就好,不用在一份幾千行的文件裡找。
## 功能模組索引
- [使用者登入](docs/auth.md)
- [金流串接](docs/payment.md)
- [通知系統](docs/notification.md)- 每個功能檔案開頭寫「這個檔案的職責範圍」,明確告訴 AI「這裡只討論什麼」,避免它把不相關的內容也塞進來。
-
檔案之間的依賴關係也寫清楚,例如
payment.md依賴auth.md的使用者驗證邏輯,可以在開頭註明,AI 才知道何時該去讀取關聯檔案。
這樣做的具體好處
1. 修 bug / 調整邏輯不用重寫 prompt
發現 AI 某個功能做錯了,直接找到對應的 md 檔案改敘述、補充規則,下次執行就會照新的邏輯走,不用每次重新解釋一遍。
2. 版本可追蹤
md 檔案可以直接用 Git 管理,每次修改都有紀錄,可以看到「規則是什麼時候、為了什麼原因改的」,方便回溯問題。
3. 團隊協作友善
如果之後有其他人(或其他 AI agent)加入專案,直接看 md 檔案就能理解每個功能的規則,不用口頭交接或翻歷史對話紀錄。
4. 累積「錯誤修正紀錄」
可以養成習慣,在 md 檔案裡加一個小節,例如:
參考資料：
https://github.com/Fission-AI/openspec