Agent Skills 推薦與使用指南：2026 怎麼安裝，Claude Code / Codex 該裝哪些技能

2026 年 9 月，Claude Code、Codex、Cursor 和一批開源 Coding Agent 已經共用同一套開放格式：一個目錄加 SKILL.md。技能不是「又一個外掛市場」，而是按需載入的流程說明書。很多人還在把發布清單、評審步驟、回滾口令寫進 CLAUDE.md 或 AGENTS.md，或者從 GitHub 一鍵裝幾十個社群包。真正該比的不是裝了多少，而是這段流程該不該每次進上下文、描述會不會誤觸發、目錄裡的 scripts/ 會不會在本機同權執行。本文不複述開放標準全文，只回答安裝與選型：Claude Code 和 Codex 該裝哪些技能、怎麼裝、怎麼驗收。

為什麼還在往全域提示詞裡塞流程，就已經選錯了

舊方式和新方式的衝突很具體。舊方式是提示詞優先：倉庫根目錄一份越寫越長的手冊，每次工作階段都整份送進模型。新方式是技能優先：穩定事實留在 CLAUDE.md / AGENTS.md，重複的多步流程做成 SKILL.md，Agent 先只看見名字和描述，真正用到才載入正文。同一條「幫我發這次版本」，舊方式每輪都付說明書；新方式只在發布任務上付。

這件事現在才變成排程優先級，有三個原因。第一，Claude Code 已經把自訂斜線命令並進 Skills：.claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都能變成 /deploy，舊命令檔繼續可用，但新能力（配套檔案、自動觸發、子 Agent）只在技能目錄上。第二，Codex 按開放標準掃 .agents/skills，並從當前目錄向上走到倉庫根；個人技能走 ~/.agents/skills，舊路徑 ~/.codex/skills 仍會被掃到——裝錯目錄會表現為「明明裝了卻調不出來」。第三，Vercel 的 npx skills 已經能把同一份技能寫進 Claude Code、Codex、Cursor 等幾十個 Agent 的目錄。跨工具複用成立的前提，是你沒有把技能寫成只認一家私有 frontmatter。

還有一層經常被漏掉：Skills 不是 MCP，也不是 Function Calling。MCP 和工具協議管的是「模型怎麼調一個活介面」；技能管的是「這段人類流程何時被載入」。協議層怎麼設計，見 Function Calling 是什麼。跨工作階段的動態狀態也不該塞進技能正文，那是記憶層的事，見 自建 Agent Memory vs SaaS。套件本身怎麼選，見 Pi vs Claude Code vs Codex。

Agent Skills 怎麼分類

把技能名攤平並列，收藏夾一定膨脹。按「誰維護、何時載入、有沒有副作用」分成三類，缺一類就只剩口碑。

Claude Code 的捆綁技能是提示詞編排，不是固定二進位：/code-review、/debug、/run、/verify、/run-skill-generator、/doctor。後三個從 v2.1.145 起能根據 README 或 package.json 推斷啟動方式；複雜專案應跑一次 /run-skill-generator，把安裝命令、環境變數和啟動腳本寫成倉庫內技能，避免每次重新發現。Codex 捆綁的是 skill-installer、skill-creator、review-agent、openai-docs 一類引導器。兩邊都遵循「先看見名字和描述，用到再讀正文」的漸進披露，所以描述欄位不是裝飾——太短不觸發，太寬亂觸發。

核心對比：入口、執行、上下文、人群

真正差異在於入口，而不是哪家實驗室的技能市場更大。三張牌必須用同一套欄名。

第二張表只補「你以為裝上了」的坑，欄名對齊，避免散文式空評。

# Claude Code — project skill (this repo only)
mkdir -p .claude/skills/review-change

# Codex — project skill (open .agents/ convention)
mkdir -p .agents/skills/review-change

# Personal skill, every repo on this machine
mkdir -p ~/.claude/skills/review-change
mkdir -p ~/.agents/skills/review-change

# Cross-agent package manager (Vercel skills CLI)
npx skills add vercel-labs/agent-skills --skill react-best-practices -a claude-code
npx skills add vercel-labs/agent-skills --skill react-best-practices -a codex

# Codex bundled installer (often writes ~/.codex/skills)
# Inside a Codex session:
# $skill-installer linear

最小可用的 SKILL.md 只需要開放標準裡的 name 和 description。下面這條夠用來驗收「會不會觸發、會不會讀正文」，先不要加 scripts/。

---
name: review-change
description: Reviews an uncommitted diff and lists risks. Use when the user asks what changed, wants a commit message, or asks to review the working tree. Do not use for greenfield feature design.
---

## Current changes

Run git diff HEAD and summarize in three bullets.
Flag missing tests, hardcoded secrets, and edits outside the named module.
If the diff is empty, say so and stop.

Claude Code / Codex 該裝哪些技能

推薦組合不是「官方商店 Top 10」，而是按副作用分層。捆綁技能預設留著；專案技能只留你們每週會重複的流程；跨倉庫規範只裝讀過正文的那幾個。

獨立開發者先做一條 review-change 和一條 release，再決定要不要 React 規範。小團隊把「開 PR 前必須跑的檢查」寫成專案技能，把個人偏好留在使用者級 CLAUDE.md，不要把客戶路徑寫進使用者級技能。企業把技能當程式碼：PR 審 SKILL.md 和 scripts/，不允許成員把未稽核包鏈到 ~/.agents/skills。

場景怎麼選

推薦組合

A — 獨立開發者、一條主 CLI： 捆綁技能保持開啟。倉庫裡只提交兩條專案技能：評審未提交 diff、按現有腳本發版。描述寫清「何時用 / 何時不用」。寫檔案和 bash 放到容器，或放到按工作階段隔離的遠端 Mac。節點月費和套餐對照見 Mac mini 定價。

B — 小型產品團隊、Claude Code + Codex 並存： 規範類技能用 npx skills 按 Agent 安裝 react-best-practices 或 web-design-guidelines，不要整庫通裝。發布和回滾只放專案目錄，隨 PR 審。個人口癖留在使用者級提示詞，不進技能。兩套 CLI 用同一條樣本發布任務驗收觸發，不要假設「一邊能調、另一邊也能調」。

C — 企業或高安全： 技能當程式碼：目錄、腳本、描述進 PR。禁止使用者級目錄鏈未稽核包。帶網路或金鑰的腳本只在可銷毀節點跑。帳號與交付邊界見 幫助中心；需要隔離工作區時從 Mac mini 租用 看節點，而不是把本機當試驗場。

常見誤區

1. 按收藏夾選技能： 「裝得越多 Agent 越能幹」。每條寬描述都是一次誤觸發預算。
2. 把流程寫進全域提示詞： 發布清單每次工作階段都在，等於每輪付說明書。
3. 假設路徑通用： Claude Code 的 .claude/skills 不會被 Codex 當預設根；Codex 安裝器還可能寫到 ~/.codex/skills。
4. 未讀腳本就裝使用者級： scripts/ 跟啟動使用者同權。先專案目錄、先隔離節點。
5. 用社群技能代替測試： /verify 和你們的 CI 不是互斥。技能不能替代紅綠測試。

落地步驟：7 步

1. 打開 CLAUDE.md / AGENTS.md，把超過一段的流程標成候選：發布、評審、回滾、產生變更說明。事實留下，步驟搬走。
2. 先寫一條沒有 scripts/ 的 SKILL.md，描述寫清「何時用 / 何時不用」。用 /review-change 或 $review-change 手動觸發一次。
3. 再用一句正常口語試自動觸發。誤觸發就改描述，不要靠再裝一個技能去覆蓋。
4. Claude Code 放到 .claude/skills/，Codex 放到 .agents/skills/。需要同時給 Cursor 或其他 Agent，用 npx skills add … -a，不要手抄錯目錄。
5. 捆綁技能加 2–4 個專案技能就停。社群包只在讀完 SKILL.md 和腳本之後進專案目錄，不進 ~/.claude/skills 或 ~/.agents/skills。
6. 帶 scripts/ 的技能先在容器或遠端 Mac 跑。金鑰不進提示詞、不進技能正文。工作階段結束能清工作區。
7. 用同一條發布或評審任務做驗收：有沒有觸發、改了哪些檔案、測試在不在你們的 CI 裡綠。本機快取冒充通過，不算驗收。

FAQ

Skills 和 CLAUDE.md / AGENTS.md 有什麼區別？

穩定事實放進 CLAUDE.md 或 AGENTS.md，每次工作階段都會讀。重複的多步流程放進 Skills，正文只在用到時載入。把發布清單塞進全域提示詞，等於每輪都付說明書。

Claude Code 和 Codex 的技能能共用嗎？

能共用 SKILL.md 開放格式，但不能假設路徑和呼叫方式一樣。Claude Code 看 .claude/skills/ 和 ~/.claude/skills/；Codex 看 .agents/skills/ 和 ~/.agents/skills/，舊路徑 ~/.codex/skills 仍會被掃到。跨 Agent 用 npx skills 指定 -a。

該不該把 GitHub 上熱門技能一鍵全裝？

不該。描述寫得太寬會誤觸發；scripts/ 會在本機同權執行。先讀 SKILL.md 和腳本，再裝進專案目錄，不要先裝進使用者級目錄污染所有倉庫。

Codex 的 $skill-installer 和 npx skills 有什麼不同？

$skill-installer 是 Codex 捆綁安裝器，常寫到 ~/.codex/skills。npx skills 是跨 Agent 的套件管理器，可指定 claude-code 或 codex。手寫技能優先放 .agents/skills 或 .claude/skills，兩邊都查一遍再判斷「沒裝上」。

帶腳本的 Skills 能在日常筆電上跑嗎？

能跑，但不建議對不熟悉的倉庫或生產金鑰這麼做。先放到容器或遠端 Mac 節點，確認觸發範圍和寫盤邊界，再決定是否提交到團隊倉庫。

總結

2026 年選 Agent Skills，不要再把社群排行榜當成購物車。先按三類入口選：捆綁技能負責官方回退；專案技能負責你們每週重複的發布和評審；跨倉庫規範只裝讀過的那幾份。 Claude Code 和 Codex 共用格式，不共用預設目錄。描述寫窄，腳本後裝，使用者級目錄當例外而不是預設。按 7 步把拆分、觸發、路徑和可清節點寫進驗收。遠端節點從 租用頁 和 定價頁 查看，帳戶問題走 幫助中心。

延伸閱讀

• Pi vs Claude Code vs Codex：2026 套件怎麼選 →
• Function Calling 是什麼：OpenAI / Gemini / Claude 對照 →
• 自建 Agent Memory vs SaaS Memory →