一份技能三家工具用：AGENTS.md 與 /import

用 AI 工具用到一定程度，你手上會有三種資產：常駐規則（CLAUDE.md 那類）、技能（SKILL.md 那類）、還有一堆連接器和權限設定。然後某天你想換工具，或團隊裡有人用 Codex、有人用 Cursor，問題就來了：這些東西要重寫幾份？

答案在 2026 年變成「多數不用」。三個層次各有一個能跨工具的做法，這篇講哪些能搬、怎麼搬、哪些搬不動。

常駐規則   AGENTS.md ← Codex、Cursor、Cline、Copilot…20 多家讀
           CLAUDE.md 一行 @AGENTS.md 引進來，Claude Code 也讀
技能       SKILL.md 開放格式 ← Claude、Codex（錄製出來的也是它）
搬設定     Claude Code /import ← 從 Codex、Gemini、Cursor 搬
搬不動     hook、權限設定、各家的連接器登入

常駐規則：一份 AGENTS.md，其他都指向它

AGENTS.md 是一個開放格式，官網列了二十多家支援的工具：Codex、Cursor、Cline、Gemini CLI、GitHub Copilot、Zed、Windsurf、JetBrains 等。它就是一份 markdown，內容是「新同事需要知道的事」，放在專案根目錄，子目錄可以有自己的，工具會讀離它最近的那份。

Claude Code 不讀 AGENTS.md，讀 CLAUDE.md。但你不用維護兩份：在 CLAUDE.md 裡寫一行 @AGENTS.md，它就把整份引進來，下面再加 Claude 專用的幾行。Windows 上不要用 symlink（要管理員權限），用 @ 引入就好。

所以團隊裡有人用 Claude Code、有人用 Codex 的做法是：規則寫在 AGENTS.md，CLAUDE.md 只留一行引入加幾條 Claude 專用的。改規則只改一個地方。

技能：SKILL.md 是開放格式

Anthropic 在 2025 年底把 Agent Skills 的格式開放出來：一個資料夾、一個 SKILL.md、可選的參考檔與腳本。Codex 6 月推出的錄製功能，錄出來的技能檔就是這個格式；Cursor、Cline 也開始讀它。9 月 Codex 的 CLI 加了「從遠端市集列出、安裝、移除 plugins」。

實務上的意思是：你在 Claude Code 寫的技能資料夾，多半可以整個複製到另一個工具的技能目錄裡用。要注意的是 frontmatter 裡各家專屬的欄位——Claude Code 的 disable-model-invocation、context: fork 這類，別家可能不認，會被忽略但不會壞。

有一個限制我要講：技能裡如果呼叫了某家工具才有的東西（例如 Claude Code 的子代理、特定的 MCP 工具名稱），搬過去會失效。寫技能時把「呼叫工具」的那幾行跟「心法」分開，搬的時候才好改。

搬設定：/import

Claude Code 的 /import 會把 Codex、Gemini CLI、Cursor 的設定搬進來：指令檔、MCP server、指令、子代理、技能。--dry-run 先看它會搬什麼，--yes 跳過逐項確認。/init 也會讀 Cursor 的 .cursor/rules/、.cursorrules 和 Copilot 的 .github/copilot-instructions.md，把相關的部分併進生出來的 CLAUDE.md。

搬過來之後要做一件事：讀一遍。別家的規則裡有些是針對那家工具的怪癖寫的防呆，到 Claude Code 這邊可能多餘或矛盾。

搬不動的

hook。Claude Code 的 PreToolUse 那套、Codex 的 interrupt hooks，格式各異，要各寫各的。權限設定也是。連接器的登入（OAuth）每家各自授權，不能搬。這三樣是你換工具時真正要重做的部分，其他多半是複製貼上。

動手做

團隊多工具的，把常駐規則收攏成一份：

我們團隊同時用 Claude Code 和 Codex（或 Cursor）。請幫我把下面的 CLAUDE.md 拆成兩份：
1. AGENTS.md：所有工具都適用的專案規範（建置、測試、架構、命名、不能碰的地方）。
2. CLAUDE.md：第一行 @AGENTS.md，然後只留 Claude Code 專用的內容（例如子代理用法、Claude 特有的指令）。
列出你判斷「只有 Claude 才懂」的條目，讓我確認。
我的 CLAUDE.md：（貼上）

從別家搬到 Claude Code 的，在專案裡打 /import --dry-run 看清單，再打 /import。搬完打 /context 看載入了什麼，然後把搬進來的規則讀一遍，砍掉針對舊工具的防呆。

技能要跨工具的，寫的時候把「呼叫工具的那幾行」集中在一段，搬過去只改那段。

做對了的樣子：專案規則只有一份原稿，其他檔案都指向它；改一條規則不用改三個地方；技能資料夾複製到另一個工具能直接觸發；你知道哪三樣（hook、權限、連接器登入）是換工具真的要重做的。

站內延伸

• 常駐檔是什麼、不是什麼 → 常駐檔是便條不是憲法
• 技能的格式與觸發 → 做第一個 Skill
• 錄製出來的技能 → 示範一次，讓它寫成技能

來源： agents.md（支援工具清單、最近檔案優先）；Claude Code：How Claude remembers your project — AGENTS.md（@AGENTS.md 引入、Windows 不用 symlink、/init 讀 Cursor／Copilot 規則）；Claude Code：Commands（/import 的來源與旗標）；Claude Code：Skills；OpenAI Codex changelog（0.153.0：CLI 可從遠端市集列出、安裝、移除 plugins）。

規則寫一份 AGENTS.md，其他檔案指向它；技能用開放的 SKILL.md 格式，呼叫工具的行集中好搬；設定用 /import 搬過來再讀一遍。換工具真的要重做的只有 hook、權限、連接器登入。