跳至內容

安裝與管理技能

本指南說明如何用 GitHub 上的技能填滿一個工作區:把程式庫新增為來源、從中安裝 你想要的技能,並讓它們隨時間保持最新。

開始之前必須知道的一件事:來源程式庫並不受信任。 它的名稱、描述與星星數 都由擁有者自行填寫。Control Center 唯一信任的安全訊號是防毒掃描判定,每次安裝 都必須先通過它,內容才會到達磁碟或代理提示。若你想了解背後的理由,請閱讀 代理模型的技能一節;本頁只談實際操作。

技能位於 設定 → 工作區 → 技能 (/workspaces/<id>/settings/workspace/skills)。它們以工作區為範圍:你在這裏 安裝的技能只屬於這個工作區。該頁面有兩個分頁:已安裝(本機技能,包含一個 新增技能編輯器)與來源(GitHub 目錄)。兩種寫入都會通過同一道掃描閘門。

  1. 開啟 設定 → 工作區 → 技能,並切換到來源分頁。
  2. 按新增程式庫。
  3. 貼上 GitHub 程式庫 URL,例如 https://github.com/anthropics/skills, 然後確認。

伺服器會檢查該程式庫是否存在,以及在它的憑證下是否可見,然後把它加入左側邊欄。 中間並沒有策劃好的商店:任何 GitHub 程式庫都可以,這也意味着信譽要由你自己判斷 ——星星數是證據,永遠不是保證。

一個程式庫的技能,就是含有 SKILL.md 的目錄(最多三層深,另加 Claude 外掛市集 版面配置 plugins/<plugin>/skills/<skill>,並略過依賴與廠商目錄樹)。如果之後格狀 清單顯示該程式庫沒有技能,那就是這個意思:它裏面沒有任何目錄符合技能慣例。

在左側邊欄選取一個程式庫;它的技能會在右邊以格狀清單出現,上方有篩選欄位,可按 名稱、描述或 slug 收窄目錄。點擊卡片即可開啟詳細檢視。它會顯示三項內容:

  • README,以 markdown 呈現——技能目錄的 README.md,若沒有 README, 則為 SKILL.md 的內文。
  • 掃描預覽——判定(pass、warn 或 quarantine)、技能內容所宣告的能力 (執行 shell、寫入檔案、網絡存取…),以及掃描器記錄的每一項發現項目。
  • 檔案數目——一次安裝會寫入技能的整個目錄,不只是它的 SKILL.md。

預覽掃描的正是安裝會寫入的同一批位元組,所以你看到的判定就是安裝會得到的判定; 不會在你背後重新判定任何東西。

  1. 開啟技能的詳細檢視。
  2. 閱讀掃描判定。若判定為 warn 或 pass,按安裝。
  3. 若判定為 quarantine,安裝會保持停用,直到你勾選 我了解風險——仍要安裝。該覆寫會記錄下來,而不是假設。

安裝會把技能的目錄寫入工作區、在 skills-lock.json 中記錄一筆固定資料(來源 程式庫、路徑、它來自哪個提交,以及內容雜湊),之後該技能便可為工作區中的代理 所用。標有名稱已被使用的卡片,代表本機已有另一個技能佔用了該名稱——請先 解除安裝那一個。

已安裝技能的卡片帶有標記:已安裝,或在程式庫已推進到你固定提交之後的版本時 顯示有可用更新。開啟詳細檢視並按更新,即會依新的提交重新取得。更新會與 安裝一樣通過同一道掃描閘門——新版本被隔離的技能會被拒絕,你原有的版本會保持 不變。舊版本的雜湊會保留在鎖定檔中,作為回滾參照。

解除安裝(在已安裝技能的詳細檢視上,或在已安裝分頁中刪除)會一併移除技能的 目錄與它在鎖定檔中的固定資料——解除安裝後的技能不會留下任何東西。

從左側邊欄移除程式庫只會移除目錄:你從它安裝的技能會保持已安裝,也依然可以 更新,因為固定資料是以名稱記錄程式庫,而不是參照來源項目。若你想再次瀏覽它, 把程式庫重新加回來即可。

技能會在各自的命名空間下叫用,因此永遠不會與內建斜線指令(/plan、/goal、 /loop、/compact)衝突:

  • /skill:<name>——安裝在此工作區中的技能,或附加到該代理的技能
  • /skill:<repo>:<name>——本空間中已檢出的其中一個程式庫所隨附的技能

不加命名空間的非內建名稱仍然可以解析,以兼容命名空間出現之前所寫的訊息。 /skill:plan 才會觸達名為 plan 的技能;/plan 永遠都是內建指令。

一個已檢出的程式庫可以隨附自己的技能,位置可在 .agents/skills/、 .agent/skills/、.claude/skills/、.opencode/skills/ 或 skills/。那些技能 不會透過本頁安裝。代理只會攜帶它目前所在程式庫的技能;當它移動時,這些技能 就會替換。輸入框並不那樣劃分範圍:/skill:<repo>:<name> 可以觸達空間中的任何 程式庫。

程式庫技能的前置資料到達提示之前,會先通過同一道失效即拒絕掃描(pass / warn / quarantine)。warn 會放行;quarantine 則不會放行,而該路徑上沒有任何操作 人員覆寫。

參見以程式庫為界的技能與 斜線指令。