AGENTS.md 是什麼？寫法、範例與設定教學

AGENTS.md 是放在專案資料夾裡、提供 AI 工作指示的 Markdown 文字檔。以 Codex 為例，你可以在裡面寫清楚資料放哪裡、怎麼整理、成果要存在哪裡，讓它開始工作時有一份可讀取的專案說明。

如果你常常請 AI 整理文件，應該很熟悉這種情況：每開一個新任務，就得重新交代「用繁體中文」「不要編造沒提到的事情」「原始檔不要改」。把會重複的要求寫進檔案，就能減少每次從頭說明的負擔。

這篇會用「整理會議紀錄」當例子，帶你建立第一份指示檔，再用一個小任務確認它有讀到、做出的成果也符合規則。即使你沒有程式背景，也能照著做。

AGENTS.md 是什麼？先看它替你記住哪些事

AGENTS.md 官方網站把這個檔案定位為給 AI agent 閱讀的專案指示。Agent 指能接受任務、使用工具執行工作的 AI 助理；在文件專案裡，它需要知道的可能是資料位置、整理方式與交付格式。

你可以把它想成新同事接手時讀的工作說明書。新同事知道要整理會議紀錄，還需要知道哪份是原稿、公司習慣用什麼格式，以及不確定的內容要怎麼處理。AI 也需要這些具體資訊。

例如，只寫「請整理得專業一點」，每次的結果可能很不同。改成「依序整理會議主題、已決定事項、待辦事項；沒寫負責人的待辦標示待確認」，你就有明確的要求，也能拿成果逐項核對。

副檔名 .md 代表 Markdown。它是能用一般文字編輯器修改的純文字格式，常用 # 表示標題、- 表示清單。檔案內容可以直接寫中文，不需要先學會寫程式。

如果還不清楚 Codex 能做哪些工作，可以先看Codex 完整介紹。本文接著聚焦在如何把你的固定要求存下來，讓同一個專案更容易接續。

AGENTS.md 放哪裡？先從一個專案資料夾開始

第一次練習，先把檔案放在這個專案的最外層資料夾。例如，建立一個叫 meeting-notes-practice 的資料夾，之後讓 Codex 在這個位置工作，會議原稿、指示檔與成果都放在裡面。

依 OpenAI 的 Codex 指示檔說明，Codex 會沿著專案根目錄到目前工作目錄讀取指示；找不到專案根目錄時，則只檢查目前目錄。因此，第一個練習把工作位置與指示檔放在同一層，比先分很多子資料夾容易確認。

檔名請完整寫成 AGENTS.md，有大寫的 AGENTS、複數 S，再接 .md。如果存成 agent.md 或 AGENTS.md.txt，就不是這個標準檔名；存檔後要查看完整名稱，不能只看圖示。

還沒完成安裝或選工作資料夾，可以先照Codex 安裝教學開始。能讓 Codex 在你指定的位置建立檔案後，再接下面的練習。

建立第一份 AGENTS.md：用會議紀錄練習

這個練習只需要一個資料夾與兩份文字檔。先用下面的虛構資料測試；確定整理方式符合預期後，再換成你有權使用的正式會議內容。

1. 建立資料夾，放入會議原稿

在電腦建立 meeting-notes-practice，用文字編輯器新增 meeting.txt，把以下內容存進去。完成後，打開資料夾，確認找得到這份檔案，而且內容和範例相同。

會議主題：十月電子報
小安：主題確定用「新手如何整理會議紀錄」。
小林：我負責寫初稿，10 月 8 日前完成。
小安：寄出日期還沒決定，下次再討論。
有人提議加一張流程圖，但還沒決定由誰製作。

這份原稿故意留下兩個缺口：寄出日期尚未決定，流程圖的負責人也不明確。等一下就能用它們檢查 AI 會不會把空缺補成看似完整、實際上不存在的資訊。

2. 把固定要求寫進 AGENTS.md

在同一個資料夾新增指示檔，貼入下面的範例並存檔。你也可以請 Codex 依照這段文字建立檔案；完成後仍要打開查看，確認內容真的寫進去。

# 會議紀錄整理專案

## 資料範圍
- meeting.txt 是會議原稿，僅供讀取，不修改原文。
- 整理時只使用原稿提供的資訊。

## 整理方式
- 使用繁體中文。
- 依序列出：會議主題、已決定事項、待辦事項、待確認事項。
- 待辦事項寫明工作內容、負責人與期限。
- 原稿未提供負責人或期限時，標示「待確認」，不要推測。
- 尚在討論或提議的內容，放在待確認事項，不當成已決定事項。

## 成果與檢查
- 將成果存成 meeting-summary-v01.md。
- 如果該檔案已存在，使用下一個未占用版本名，不覆寫。
- 完成後提供實際檔案位置，並列出仍待確認的資訊。

這份範例把要求分成三件事：使用哪些資料、怎麼處理、交出什麼成果。之後換成文章、企劃或研究專案，也可以從這三個問題開始，不需要第一次就寫成很長的規則大全。

工商時間

如果你想要更系統化、更輕鬆的學好 SEO 與 AI SEO，歡迎參考我與知識衛星合作的 SEO 線上課程：《SEO 排名攻略學》、《AI SEO 流量變革》。

透過《SEO 排名攻略學》獲得穩定的 SEO 流量與實戰經驗。
再搭配《AI SEO 流量變革》看懂 AI 搜尋趨勢，搶佔 AI 搜尋紅利。

3. 開始新任務，請 Codex 說明讀到的規則

存好後，在這個資料夾開始新的 Codex 任務。先確認工作位置是 meeting-notes-practice，再送出下面這段話，暫時不要請它直接整理。

請先列出這次已載入的指示檔與適用規則，說明這個專案的資料來源、整理格式、缺漏處理方式與輸出檔名。先不要修改或建立成果檔。

你應該看見它指出這個專案的指示檔，並說出不修改原稿、缺漏標示待確認、使用指定格式等要求。這一步能先找出讀錯位置的問題；它說「有讀到」之後，還要接著檢查實際成果。

怎麼確認有效？看指示來源，也看實際成果

確認規則後，接著請它執行：「請依本專案規則整理 meeting.txt，實際建立成果檔，完成後告訴我檔案位置。」這次的訊息只交代要做哪個任務，固定格式已經放在指示檔裡。

完成後，打開成果檔核對以下三件事。不要只看聊天裡的完成通知，也不要因為版面整齊就直接接受。

1. 檔案有建立：資料夾裡找得到 meeting-summary-v01.md；原本的 meeting.txt 內容沒有被改掉。
2. 資訊有對上：已決定的主題、初稿負責人小林、10 月 8 日期限，都能回到原稿找到。
3. 缺漏有留下：寄出日期仍列為待確認；流程圖仍是提議，沒有被寫成已決定、也沒有憑空指定負責人。

例如，合格的內容可以寫成「待辦：電子報初稿；負責人：小林；期限：10 月 8 日」，並在待確認事項寫「寄出日期未定；流程圖是否製作及負責人未定」。具體措辭可以不同，但不能改變原稿的意思。

如果它把流程圖寫成已決定事項，就先指出這個錯誤，請它修正成果。接著確認 AGENTS.md 裡的相關規則是否清楚；若原本只寫「不要亂猜」，可以補成「提議與未定事項不得列為已決定」。再用同一段原稿測一次，看錯誤是否消失。

聊天指令、AGENTS.md 與 Skill 怎麼分工？

開始使用後，常見的問題是：規則到底要放進聊天，還是存成檔案？可以先看這個要求會用多久、在哪些工作中重複出現。

• 聊天指令：交代當次任務，例如「今天整理這份會議原稿」「這次另加一段給主管看的摘要」。
• AGENTS.md：保存這個專案會反覆用到的共同要求，例如不改原稿、缺漏不推測、成果另存版本。
• Skill：保存特定工作的可重用做法，例如一整套會議紀錄整理步驟，搭配範本或檢查工具。

OpenAI 的 Skill 說明指出，Skill 可以包含指示、資源與選用的腳本，主要說明放在 SKILL.md。它適合封裝一項固定工作流程；第一個文件專案還不需要急著建立 Skill。

你可以先讓專案規則保持簡短，每次在聊天裡說清楚要處理的檔案與成果。等到同一套步驟會在多個專案反覆使用，再考慮整理成 Skill。如何描述當次需求，可以搭配Codex 新手問法與工作流程閱讀。

AGENTS.md 沒生效時，先檢查位置與衝突

如果成果明顯沒有照規則做，先檢查它是否讀到正確檔案，再檢查文字是否清楚。這會比不斷新增「務必遵守」更有幫助。

工商時間

如果你想要更系統化、更輕鬆的學好 SEO 與 AI SEO，歡迎參考我與知識衛星合作的 SEO 線上課程：《SEO 排名攻略學》、《AI SEO 流量變革》。

透過《SEO 排名攻略學》獲得穩定的 SEO 流量與實戰經驗。
再搭配《AI SEO 流量變革》看懂 AI 搜尋趨勢，搶佔 AI 搜尋紅利。

• 看完整檔名：確認複數 S、大小寫與副檔名正確，沒有多出 .txt。
• 看工作位置：請 Codex 說明目前資料夾的完整位置，確認與你存檔的位置相同。
• 看其他指示檔：同一目錄若有 AGENTS.override.md，Codex 會優先選它，每個目錄最多採用一份指示檔；不會把同層兩份一起讀。
• 換新任務再確認：存檔修改後，在目標資料夾重新開始一次，請它列出適用規則，不假設進行中的任務會立刻重讀。

Codex 也有個人與專案層的指示。專案內由根目錄往目前目錄合併，愈靠近目前工作目錄的指示，會覆蓋較上層的衝突要求。第一次先用一份專案檔即可；開始分子專案後，再依 OpenAI 的層級說明處理不同目錄的規則。

之後怎麼維護？把真正會重複的要求留下來

AGENTS.md 可以隨專案修改。每次遇到問題，先判斷它是一次性的要求，還是以後都需要遵守的做法。只有後者才放進檔案，避免把每次聊天的補充全部累積進去。

例如，這次想多一段主管摘要，可以先留在聊天。若每份會議紀錄都要保留未定事項，就適合成為固定規則。把「做得更仔細」改成「負責人、期限缺漏時標示待確認」，也比加重語氣更容易檢查。

這份檔案提供的是工作指示，工具能讀寫哪些位置、何時需要核准，仍由執行環境的權限設定控制。在文字裡寫「不要修改原稿」有助於交代要求，但重要原始檔仍要保留備份；可以接著看Codex 檔案結構與備份教學。

AGENTS.md 也不保證每次都產生正確成果。先從一份短規則、一段可核對的資料開始，確認檔案位置、規則與輸出都對得上，再逐步換成正式工作。你就有一份能持續維護、接續使用的專案說明書。

參考資料

• AGENTS.md 官方網站
• OpenAI：Codex 自訂指示檔
• OpenAI：建立 Skill