Docs

Skills

把常用的指令、步驟和資料整理成可供多個 AI 代理重複使用的 skill。

Skill 是工作區中可以重複使用的一組工作方法。它以 SKILL.md 為主檔案,也可以附帶指令碼、模板和參考資料。

把 skill 新增到AI 代理後,AI 代理會在執行相關工作時使用其中的說明。相同的方法不必分別複製到每個 AI 代理的指令中,修改時也只需要維護一份。

Skill 與 AI 代理指令

AI 代理指令Skill
適合儲存這名 AI 代理長期不變的職責、邊界和交付要求某類工作可重複使用的步驟、資料和工具
使用範圍只屬於一名 AI 代理,每次執行都會提供可以新增給多名 AI 代理,並單獨啟用或停用
例子"只審查前端程式碼,不直接修改"一套無障礙檢查清單和報告模板

建立或匯入 skill

在工作區的 Skills 頁面選擇"新建 skill",可以使用四種方式:

方式適合什麼情況
手動建立從空白的 SKILL.md 開始編寫。
從本地匯入選擇包含 SKILL.md 的資料夾,或這臺電腦上的 .skill / .zip 壓縮包。
從 URL 匯入從 GitHub、ClawHub 或 Skills.sh 匯入已經發布的 skill。
從執行時複製掃描連線電腦上的 skill,並把選中的內容複製到工作區。

從執行時複製的是當時的檔案快照。之後本地檔案發生變化,不會自動更新工作區中的版本;需要重新匯入或在 Multica 中編輯。

同一套壓縮包格式也可以用 CLI 匯入:

multica skill import --file ./review-helper.skill

匯入時如果工作區已經存在同名 skill,可以停止匯入、覆蓋原內容、使用新名稱儲存,或跳過。透過匯入覆蓋僅限該 skill 的建立者本人;工作區 admin 即使可以在應用內編輯它,也不能用匯入的方式覆蓋。要為已在工作區裡的 skill 拉取新版本,請改用更新已匯入的 skill。

更新已匯入的 skill

從 GitHub、ClawHub 或 Skills.sh 匯入的 skill 會記住它的來源。要拉取最新版本,在 skill 頁面點選更新(或在列表行選單裡選"從來源更新"),也可以用 CLI:

multica skill refresh <skill-id>

Skill 會從來源重新下載並就地替換:

  • 保留:skill 的身份,包括 AI 代理分配、標籤、建立者和建立時間。AI 代理無需重新新增。
  • 替換:名稱(來源改名時跟隨)、描述、SKILL.md 和全部支援檔案。對 skill 的本地修改會被覆蓋。

Skill 的建立者以及工作區 owner、admin 都可以從來源更新。手動建立、從壓縮包匯入或從執行時複製的 skill 沒有託管來源,不能這樣更新,只能重新匯入。

要一次更新多個 skill,在列表中選中它們,然後在選擇工具欄中點選更新。所有選中的、有託管來源的 skill 都會從來源重新下載;沒有託管來源的會被跳過。

Skill 的內容

每個 skill 都包含一個主檔案 SKILL.md。在這裡寫清:

  • 這個 skill 的適用場景;
  • 開始前需要檢查什麼;
  • 執行步驟;
  • 結果應以什麼形式提交;
  • 哪些情況需要停止並向成員確認。

還可以新增支援檔案,例如:

SKILL.md
references/api-conventions.md
templates/review-report.md
scripts/check.sh

SKILL.md 是保留路徑,不能再建立同名支援檔案。支援檔案會和主檔案一起提供給 AI 代理。

新增到 AI 代理

建立或匯入 skill 後,還要把它新增到具體的 AI 代理:在 skill 頁面選擇 新增到 AI 代理,或開啟 AI 代理的 Skills 標籤頁點 新增 skill。AI 代理按 skill 的描述判斷什麼時候載入它。

動手試試Ops helper · Skills
Assigned to agent
Turn off a skill to pause its use without removing it.
No skills assigned
Ops helper has no skills yet.
  • 一名 AI 代理可以使用多個 skill;
  • 同一個 skill 可以供多名 AI 代理使用;
  • 暫時不需要時,可以停用繫結,而不必刪除 skill;
  • 修改後的內容從後續執行開始生效,不會改變已經開始的執行。

只有有權修改該 AI 代理的成員,才能為它新增、移除或停用 skill。

工作區 skill 和倉庫中的 skill

工作區 skill 儲存在 Multica 中,適合由團隊共同維護,並新增給不同 AI 代理。

部分 AI 程式設計工具也會直接讀取程式碼倉庫中的專案級 skill,例如 .claude/skills/ 或 .agents/skills/。這些檔案仍由倉庫管理,Multica 不會自動把它們登記為工作區 skill。具體支援方式取決於使用的工具,見 AI 程式設計工具對照。

連線電腦上已安裝的執行時本地 skill(Claude Code 和 Codex)會顯示在 AI 代理的 Skills 標籤頁中,可以按 AI 代理單獨停用。停用同樣需要有權修改該 AI 代理。

對於 Oh-My-Pi,繼承列表和從執行時複製的操作會遵循啟動命令選定的 profile 及生效的 skill 篩選配置。發現過程在空目錄中執行,讀取使用者級配置;專案配置和顯式分配的 Multica skill 單獨處理。如果 OMP 無法返回 skill 清單,重新整理會報錯。

修改權限

任何工作區成員都可以建立或匯入 skill。建立者和工作區 owner、admin 可以修改或刪除它;其他成員可以檢視和使用,但不能覆蓋內容。

刪除是永久操作,同時會從所有 AI 代理上移除該 skill。

從外部匯入的 skill 可能包含指令碼、命令或不安全的指令。Multica 不會替你審查、簽名或隔離這些內容。匯入的內容會原樣提供給 AI 代理執行,來源需要可信。

接下來

本頁目錄