---
title: "使用 npx skills 徹底解決不同 AI Agent（如 Claude Code 或 Kimi）技能碎片化問題"
description: "正在執行 Claude Code、Kimi 等多個 AI Agent？本文教你如何使用開源 npx skills CLI 建立統一的中央資料夾，徹底解決技能檔案碎片化與多版本衝突。"
canonical_url: "https://techvoyage.dev/tw/article/centralised-the-skills-for-agents"
last_updated: "2026-06-14T11:05:30.629Z"
---

如果你在電腦上執行了多個 AI Agent（或 CLI 工具）——不論是 Hermes、Claude Code、Codex、Antigravity、Kimi 還是其他支援的工具，你可能都遇過一個極其令人沮喪的問題：**技能碎片化（skills fragmentation）**。每個 Agent 或 CLI 都會維護自己獨立的 `skills` 資料夾，這會導致重複安裝、版本偏差以及極高的管理維護成本。

在日常使用 AI Agent 的過程中，我們經常會遇到以下痛點：

- **重複安裝**：為了一個 Agent 安裝了新技能後，還必須為其他 Agent 一次又一次地重複安裝。
- **版本偏差（Version Drift）**：在某個 Agent 中客製或修復了某個技能，卻忘記同步更新其他 Agent，導致不同的 Agent 表現出不一致的行為。
- **技能 management 混亂**：必須逐個翻看系統中每個 Agent 的 `skills` 資料夾，才能知道到底安裝了哪些技能。

由 Vercel 推出的開源 CLI 工具 `npx skills` 完美地解決了這個問題。它允許你建立並管理一個統一的、中央化的 `skills` 資料夾，並無縫共享給所有的 Agent。你可以前往 [`npx skills` 的 GitHub 專案](https://github.com/vercel-labs/skills)了解更多資訊。

## 技能一元化管理

這個方案的核心概念非常簡單：如果我們把每個 Agent 的 `skills` 資料夾都指向**同一個實體資料夾**，那麼碎片化問題就會迎刃而解。

當你使用 `npx skills` CLI 安裝技能时，該技能會被下載到你電腦上的中央統一資料夾（`~/.agents/skills`）。接著，CLI 會自動在各個 Agent 的 `skills` 資料夾中建立**符號連結（Symlink，即指向實際資料夾的捷徑）**，直接導向該中央資料夾。

例如，當 Claude Code 在 `~/.claude/skills/` 中尋找技能時，它會被透明地導向到 `~/.agents/skills`。只要你對中央資料夾中的技能進行任何微調，所有 Agent 都會立刻同步應用。無需手動複製，無需撰寫同步指令稿，更不會浪費任何硬碟空間。

## 安裝 `npx skills` 並新增技能

執行以下指令來開始並新增我們的第一個技能：

```bash
npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram
```

![使用 npx skills add 指令從 GitHub 安裝 AI Agent 技能](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-add-command.webp)

CLI 會詢問是要將此設定套用於特定專案還是全域（globally）。我們通常推薦選擇 **global**（全域），以便所有支援的 Agent 都能存取它：
![在 npx skills CLI 中選擇全域（global）安裝選項](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-install-global-prompt.webp)

接下來，請務必選擇 `Symlink` 以確保**單一事實來源（Single Source of Truth）**：
![選擇符號連結（Symlink）方式以確保單一事實來源](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-symlink-option.webp)![CLI 顯示技能安裝完成與符號連結建立成功確認](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-installation-completed.webp)

完成後，我們可以驗證該技能是否已經正確安裝在中央統一資料夾 `~/.agents/skills` 中：
![驗證中央統一資料夾中已安裝的 AI Agent 技能](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-directory-verification.webp)

開啟 Kimi CLI（或任何其他 Agent），你會發現 `excalidraw-diagram` 技能已經立即可用！
![Kimi CLI 顯示已成功載入並可立即使用的中央統一技能](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skills-integration.webp)

## 從零開始建立技能

如果你想自建專屬技能，可以使用 Anthropic 的 `skill-creator` 工具。透過以下指令進行安裝：

```bash
npx skills add https://github.com/anthropics/skills --skill skill-creator
```

現在，在 Kimi 或任何其他 Agent 中，輸入以下提示詞（Prompt）：

```text
Use the skill-creator to help me build a skill for creating a product landing page
```

Kimi 或你的 Agent 會自動識別 `skill-creator` 並引導你一步步完成建立過程：
![在 Kimi CLI 中執行互動式 skill-creator 引導建立新技能](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skill-creator-setup.webp)

## 其他實用的 `npx skills` 指令

以下是一些常用的便捷指令：

- `npx skills ls -g`：列出所有全域安裝的技能
- `npx skills update`：僅需一條指令即可將所有技能一鍵更新到最新版本
- `npx skills remove`：以互動式的方式解除安裝/移除某個技能

請參閱 [`npx skills` 的 GitHub 專案](https://github.com/vercel-labs/skills)以取得更多指令和參考文件。

## 進階玩法：結合 Git 管理

由於現在所有的技能都集中在同一個地方（`~/.agents/skills`），我們可以將其初始化為一個 Git 儲存庫，並推送到 GitHub 或 GitLab 進行備份與版本控制。

```bash
cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main
```

這樣，我們就擁有了技能修改的完整歷史記錄。萬一某次更新破壞了功能，我們可以非常輕鬆地復原（Rollback）。此外，如果你有多台電腦（例如筆記型電腦和桌上型電腦），只需執行一次快速的 `git pull`，即可在不同裝置間無縫同步所有技能。

## 幾點注意事項（安全與風險）

- **相容性差異**：並非所有的 Agent 平台都完全支援所有功能（例如自訂勾子 custom hooks 或特定的授權工具）。某個技能在 A Agent 上執行順暢，在 B Agent 上可能會遇到功能限制。
- **來源可信度**：請務必只從信任的來源安裝技能。
- **執行前程式碼審查**：如果你使用的是自訂或第三方的技能，在授權 Agent 執行它之前，請務必先審查其程式碼檔案（尤其是 `scripts/` 資料夾下的內容）。
- **最小權限原則**：儘量不要給技能授予超出其核心功能所需的工具權限或系統存取權限。
- **切勿寫死機密資訊**：千萬不要在技能檔案中直接寫入 API 金鑰（API Keys）或其他敏感憑證。

使用 `npx skills` 建立「單一事實來源」後，我們的團隊徹底擺脱了版本混亂和重複設定的煩惱。強烈建議你嘗試一下——隨著技能庫的不斷豐富，AI Agent 的能力也將迎來爆發式成長！