安裝與管理技能
本指南說明如何用 GitHub 上的技能填滿一個工作區:把程式庫新增為來源、從中安裝 你想要的技能,並讓它們隨時間保持最新。
開始之前必須知道的一件事:來源程式庫並不受信任。 它的名稱、描述與星星數 都由擁有者自行填寫。Control Center 唯一信任的安全訊號是防毒掃描判定,每次安裝 都必須先通過它,內容才會到達磁碟或代理提示。若你想了解背後的理由,請閱讀 代理模型的技能一節;本頁只談實際操作。
技能位於 設定 → 工作區 → 技能
(/workspaces/<id>/settings/workspace/skills)。它們以工作區為範圍:你在這裏
安裝的技能只屬於這個工作區。該頁面有兩個分頁:已安裝(本機技能,包含一個
新增技能編輯器)與來源(GitHub 目錄)。兩種寫入都會通過同一道掃描閘門。
新增技能程式庫
標題為「新增技能程式庫」的章節- 開啟 設定 → 工作區 → 技能,並切換到來源分頁。
- 按新增程式庫。
- 貼上 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。
預覽掃描的正是安裝會寫入的同一批位元組,所以你看到的判定就是安裝會得到的判定; 不會在你背後重新判定任何東西。
安裝技能
標題為「安裝技能」的章節- 開啟技能的詳細檢視。
- 閱讀掃描判定。若判定為
warn或pass,按安裝。 - 若判定為
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 則不會放行,而該路徑上沒有任何操作
人員覆寫。