10 種 MD 檔,你看懂幾個?AGENTS.md 別再塞滿了
一次看懂 AI 專案常見的 10 種 MD 檔,學會把 AGENTS.md 當目錄,讓 AI 每次開工都更快進入狀況。
10 種 MD 檔一次看懂
用 AI 做專案時,常會看到一堆 .md 結尾的檔案。MD 是 Markdown 的縮寫,就是用 # 當標題、- 當清單的純文字筆記,人和 AI 都好讀。
| 檔案 | 用途 |
|---|---|
| AGENTS.md | 專案的工作說明書,寫整個專案的大綱。每次開新對話,AI 都會先讀它。 |
| CLAUDE.md | Claude 專屬的工作說明書,作用和 AGENTS.md 一樣。 |
| SKILL.md | AI 的技能操作手冊,例如製作簡報、剪輯影片。 |
| PRD.md | 產品需求書,定義 App 要有哪些功能。 |
| DESIGN.md | 設計規格書,定義網站的視覺與互動方式。 |
| WORKFLOW.md | 工作流程書,規定 AI 從開發到上線的完整步驟。 |
| MEMORY.md | 記錄 AI 需要長期記住的重要資訊。 |
| PROMPTS.md | 保存可以重複使用的指令。 |
| PLANS.md | 規劃複雜任務要怎麼執行、分成哪些階段。 |
| TASKS.md | 任務清單,追蹤工作進度。 |
AGENTS.md 當目錄,不要塞滿
很多人把所有規則、需求、資訊,密密麻麻都寫進 AGENTS.md。但 AGENTS.md 每次開新對話都會被 AI 讀一次,AI 一次能記住的內容有限,新對話才剛開始,空間就被說明書佔滿了,真正要做的事反而容易被忽略。 • AGENTS.md 當目錄:只寫專案簡介、必守規則,和每個任務該看哪份文件。 • 細節放進專門的檔案:設計寫在 DESIGN.md,需求寫在 PRD.md。 • AI 需要時再去讀:改畫面才讀 DESIGN.md,不用每次全部讀完。
# 專案說明 這是海豚 AI 學院的官網。
## 做事前先看 - 改畫面:看 DESIGN.md - 加新功能:看 PRD.md - 開發與上線步驟:看 WORKFLOW.md - 目前進度:看 TASKS.md
## 一定要遵守 - 改完先給我看,確認後再上線
這是 AGENTS.md 的範例,換成你自己的專案和文件名稱就能用。
一句指令,幫你整理 AGENTS.md
已經寫了一大份 AGENTS.md?讓 AI 幫你拆開整理。
操作步驟
- 在 Codex 或 Claude Code 開啟你的專案。
- 貼上下面的指令。
- 看完 AI 列出的調整計畫,沒問題再回覆「確認」。
範例指令
幫我整理 AGENTS.md: 1. 只留專案簡介、必守規則和文件目錄 2. 其他內容依主題搬到 DESIGN.md、PRD.md、WORKFLOW.md 等檔案 3. 在目錄寫清楚什麼任務要看哪個檔案 先列出調整計畫給我看,確認後再修改。
說明書寫得精簡,AI 每次開工都能更快進入狀況,把空間留給真正要做的事。