← 返回部落格

AGENTS.md 與 CLAUDE.md：AI 程式設計智能體的新版 README

· Save Team
markdownaiagents-mdclaude-mdcodingdeveloper-tools

如果你最近使用過 AI 程式設計助手，你可能注意到了一件事：它們都需要一個 Markdown 檔案。

GitHub Copilot 讀取 .github/copilot-instructions.md，Cursor 讀取 .cursor/rules/，Claude Code 讀取 CLAUDE.md，Windsurf 讀取 .windsurf/rules，Google 的 Jules 讀取 JULES.md。而通用標準？AGENTS.md —— 現在已被超過 6 萬個開源儲存庫使用，由 Linux 基金會的 Agentic AI Foundation 管理。

Markdown 已從文件格式演變為 AI 程式設計智能體的作業系統。

什麼是 AGENTS.md？

AGENTS.md 是一個簡單的開放格式 Markdown 檔案，位於你的程式碼儲存庫中，作為 AI 程式設計智能體的簡報包。可以將其視為 README.md 的對應物：

  • README.md 是給人類的：快速入門、專案描述、徽章
  • AGENTS.md 是給 AI 智能體的：建置步驟、測試命令、編碼慣例、架構決策

智能體讀取目錄樹中最近的檔案，所以最近的檔案優先級最高。每個子專案都可以附帶客製化的指令。

什麼是 CLAUDE.md？

CLAUDE.md 專門用於 Anthropic 的 Claude Code。它在每次工作階段開始時自動讀取，包含你否則需要在每個提示中重複的專案特定指令。

一個好的 CLAUDE.md 通常包括：

  • 專案背景：一句話讓 Claude 了解專案是做什麼的
  • 程式碼風格：你的格式偏好、命名慣例、需要遵循的模式
  • 命令：如何執行測試、建置、lint 和部署
  • 架構說明：Claude 應該遵守的關鍵決策

推薦的做法：將共享指令放在 AGENTS.md 中（讓所有 AI 工具受益），然後在 CLAUDE.md 中添加 Claude 特有的功能。

AI 指令檔案的完整版圖

以下是每個主要 AI 程式設計工具及其 Markdown 慣例：

工具檔案格式
GitHub Copilot.github/copilot-instructions.mdMarkdown
Cursor.cursor/rules/*.mdMarkdown
Claude CodeCLAUDE.mdMarkdown
Windsurf.windsurf/rulesMarkdown
Google JulesJULES.mdMarkdown
通用AGENTS.mdMarkdown

注意規律了嗎？全都是 Markdown，無一例外。

為什麼 Markdown 勝出

Markdown 是 AI 指令檔案的完美格式，因為：

  1. LLM 原生理解 —— 它是訓練資料中最常見的格式
  2. 人類可讀 —— 開發者可以輕鬆審查和編輯指令
  3. 可版本控制 —— 與程式碼一起存放在 git 中
  4. 輕量級 —— 無解析開銷，無需特殊工具
  5. 通用性 —— 適用於每個 AI 工具、編輯器和平台

正如 Visual Studio Magazine 所說：在智能體 AI 中，一切都與 Markdown 有關。

撰寫智能體指令的最佳實踐

基於對數千個程式碼儲存庫的分析：

從簡單開始。 只在你注意到智能體反覆犯同樣錯誤時才添加規則。過於詳細的指令可能適得其反。

對命令要具體。 不要說「執行測試」——要說 pnpm test 或 pytest -x tests/。

記錄你的架構。 如果你的專案使用特定模式（比如內容腳本和 service worker 之間的訊息傳遞），請解釋清楚。智能體無法僅從程式碼推斷架構決策。

包含不該做什麼。 負面指令出奇地有效：「永遠不要直接修改資料庫 schema」或「不要使用類別元件，始終使用 hooks」。

Save 如何融入這個生態

如果你在建構智能體指令檔案，你可能也在從網路儲存參考資料：文件頁面、Stack Overflow 答案、GitHub README、API 參考。

Save 只需一鍵即可將這些網路資料轉換為乾淨的 Markdown —— 非常適合建構 AI 智能體所需的上下文。儲存一個文件頁面，將 Markdown 貼上到 AGENTS.md 或參考文件中，你的 AI 程式設計助手立即獲得了所需的上下文。

工作流：

  1. 在網路上找到有用的文件或程式碼範例
  2. 點擊 Save 轉換為 Markdown
  3. 在智能體指令檔案中引用或包含
  4. 你的 AI 程式設計助手隨著每次儲存變得更強大

未來：Markdown 作為 AI 的控制介面

微軟和 GitHub 現在將 Markdown 視為 AI 行為的穩定、可稽核的控制介面。它不再只是文件——它是人類意圖與 AI 執行之間的介面。

我們看到 Markdown 檔案扮演著三個不同的角色：

  1. 文件：向人類解釋系統
  2. 指令：約束和引導 AI 行為
  3. 技能：將指令與資源捆綁，使智能體可以重複工作流

這一趨勢只會加速。隨著 AI 程式設計助手能力不斷增強，引導它們的 Markdown 檔案變得越來越重要。

Save 只需一鍵即可將任何網頁轉換為乾淨的 Markdown。非常適合建構參考資料庫、捕獲文件和為 AI 程式設計工作流建立上下文。免費試用 Save。