OpenAI Codex：AGENTS.md 與 Skills
OpenAI Codex（Codex CLI 與 ChatGPT 內的 Codex）用 AGENTS.md 做「一直生效」的專案說明，另外用 SKILL.md 技能包做「需要時才載入」的工作流程。Codex 採用的技能包格式跟 Claude 一致，都遵循 Agent Skills 開放標準，兩邊的 SKILL.md 資料夾可以直接互相搬用。
檔案放哪裡
AGENTS.md（一直生效，可跨層疊加）
- 全域：
~/.codex/AGENTS.md（或~/.codex/AGENTS.override.md做臨時覆寫）。 - 專案：從 Git 根目錄往下，一路檢查到目前工作目錄，每一層資料夾各自最多算一份
AGENTS.md。 - Codex 每次執行都會重新組合這條「指令鏈」：全域檔案最先套用，接著是專案根目錄到目前目錄，越接近目前工作目錄的內容優先權越高（後蓋前）。改完檔案立即生效，不需要清快取。
- 在 Codex CLI 對話裡打
/init，可以自動幫目前目錄產生一份初稿。
Skills（需要時才載入）
- 個人：
$HOME/.agents/skills，跨專案通用。 - 專案：
$REPO_ROOT/.agents/skills（或目前工作目錄下的.agents/skills）。 - 系統層：
/etc/codex/skills，給整台機器共用的預設技能。 - ChatGPT 桌面版可以在側邊欄的「Skills」直接瀏覽目前工作區可用的技能。
撰寫格式
AGENTS.md 沒有固定格式要求，就是一般 Markdown，用標題分段即可：
## Working agreements
所有 PR 標題請用「type: 說明」格式，type 只能是 feat/fix/chore/docs。
## Repository expectations
後端在 `server/`，前端在 `web/`；改動後端記得跑 `pytest`。
SKILL.md 則跟 Claude 一樣，需要 YAML frontmatter，name 與 description 為必填：
---
name: release-checklist
description: 執行版本發布前的檢查清單。當使用者要求「準備發版」「release checklist」時使用。
---
1. 確認 CHANGELOG.md 已更新。
2. 執行 `npm run test` 與 `npm run build`，確認都通過。
3. 打 tag 前先跟使用者確認版本號。
實際應用
.agents/
└── skills/
└── release-checklist/
├── SKILL.md # 必要：frontmatter + 指示
├── scripts/ # 選用：可執行腳本
├── references/ # 選用：詳細文件
└── agents/
└── openai.yaml # 選用：顯示名稱、圖示等 UI 中繼資料
在 ChatGPT 裡打 @、在 Codex CLI 裡打 $，可以直接列出並手動選擇要用哪個技能；不手動選的話，Codex 會依 description 自動比對目前任務。
推薦影音
使用 AGENTS.md 檔案
簡述：OpenAI Codex 教學系列第 6 集，示範如何撰寫 AGENTS.md、Codex 怎麼讀取它來理解專案慣例，適合剛開始用 Codex CLI 的讀者。
開始使用 Codex 的 Agent Skills
簡述：說明 Codex 的 Skills 功能怎麼打包腳本與提示、跟 AGENTS.md 如何分工，並實際示範建立一個技能。
相關資料
- 跟其他工具的差異：〈五大工具怎麼選、怎麼寫〉
- 為什麼要有這些機制：〈核心概念〉