跳到主要內容
CAMP 04找觀念›一份技能三家工具用:AGENTS.md 與 /import
第四架構:流程自動化與技能模組|第 6 篇

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

換工具最怕重寫一遍。2026 年這變得好做多了:常駐規則有 AGENTS.md 這個二十幾家都讀的公版,技能有 Anthropic 開放的 SKILL.md 格式(Codex 錄製出來的也是它),Claude Code 的 /import 能把 Codex、Gemini CLI、Cursor 的設定搬過來。搬不動的是各家的 hook 與權限設定。

2026-09-07 發布 · 2026-09-16 更新 · 作者整理:Lucas

用 AI 工具用到一定程度,手上會累積三種東西:常駐規則(CLAUDE.md 那類)、技能(SKILL.md 那類),還有一堆連接器和權限設定。然後某天你想換工具,或團隊裡有人用 Codex、有人用 Cursor,麻煩就來了,這些要重寫幾份?

2026 年的答案是多數不用。常駐規則有 AGENTS.md,技能有開放的 SKILL.md,搬設定有 Claude Code 的 /import。真正搬不動的是 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 專用的,這樣改規則只要改一個地方。規則如果只寫在 CLAUDE.md,用 Codex 的那位同事,他的 AI 是讀不到的。

技能: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 看載入了什麼,然後把搬進來的規則讀一遍,砍掉針對舊工具的防呆。

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

把 @AGENTS.md 這一行放進 CLAUDE.md 的第一行,存檔,開一場新對話打 /context,引進來的那份就會列在載入清單裡。

站內延伸

來源: 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)。

第四架構 · 第 6 篇 · 換工具

換工具時要重做的,
大概只有三樣

什麼時候看這張:團隊有人用別家的程式助手,你擔心同一套規則和技能要寫好幾份。

常駐規則寫一份公版,其他指向它技能開放格式,複製資料夾就能用設定有指令能搬,搬完要讀一遍
  • 規則寫一份公版,各家專用的檔案只留一行引入
  • 技能資料夾多半能整個複製到別家的技能目錄
  • 攔截設定、權限、連接器登入,只能各家各做

第一個動作把常駐規則拆成兩份:各家都適用的公版一份,這家專用的只留幾行。CLAUDE.md 首行寫 @AGENTS.md;/import 搬設定

2026-09-16 查證稜線 Ridgeline
← 看更多找觀念文章
取得 AI 實戰工具與更新

之後會不定期整理:新方法、指令包(Prompt Pack)、Checklist 與模板。免費、無廣告;送出後會收到一封確認信,點了連結才算訂閱成功,之後每封信都附一鍵退訂。