跳至主要內容

Skills

Skill 是可重複使用的任務說明套件,以 SKILL.md 為入口,並可帶配套檔案。Dashboard → Skills 管理目前 Profile 的清單;切換 Profile 後,目錄和啟用狀態隨之改變。

安裝一個本機 ZIP​

先讀懂套件內說明,尤其是指令、外部下載和認證資料要求,再選擇 Install Skill 上傳 .zip。壓縮檔只能包含一個 Skill,支援兩種佈局:

  • 壓縮檔根目錄直接放 SKILL.md 和支援檔案;
  • 只放一個 Skill 目錄,在其中放 SKILL.md 和支援檔案。

SKILL.md 的 name 只能由小寫字母、數字和連接它們的單一連字元組成,最長 64 字元,例如 weekly-report;名稱不能是路徑。有外層目錄時建議使用同名目錄。

整個上傳請求(包括 multipart 額外負擔)最多 10 MiB;ZIP 檔案和解壓內容也分別受 10 MiB 上限約束。Anyy 在暫存區驗證,拒絕越界路徑、Symlink、特殊檔案及無效名稱。壓縮檔結構檢查不能替你判斷指令是否可信。

服務會檢查所選 Profile 的上傳 ID、SHA-256 與有效期,再寫入代管庫並重新載入目錄。同名代管 Skill 會被替換。安裝只支援本機 ZIP,不支援 GitHub 位址、遠端 URL、本機目錄或集合安裝;已有記錄的歷史來源仍可顯示。

檢查是否安裝並生效​

  1. 回到清單,開啟安裝的 Skill。
  2. 核對名稱、描述、來源、代管狀態、檔案路徑和正文。
  3. 檢查啟用狀態;替換曾被停用的 Skill,不表示自動重新啟用。
  4. 在同一 Profile 的下一次對話中要求使用它。

非 System Skill 可以切換啟用/停用。停用只影響正常解析,不刪除檔案。詳情頁也顯示 Scope、停用原因和關聯支援檔案,方便檢查實際內容。

來源標籤表示記錄的來處:System 隨版本提供,不能在頁面關閉或移除;User Installed 位於 Profile 代管庫;Agent Created 表示由 Agent 代管流程建立的已有記錄。

對話和頁面使用同一份庫​

可以給 Anyy 主機可存取的可信 ZIP 路徑,要求它安裝。目前對話提供 skill_manage 時,會寫入這個 Profile 的代管庫;重新整理頁面即可檢查結果。該工具不負責切換啟用狀態,應在頁面另行核對。

反過來,頁面安裝完成後,新提示詞可以發現重新載入後的目錄,再用 read/bash(也可以經 Codemode)讀取入口。已接受或正在執行的提示詞不會被重新載入替換。若缺少 reader,模型不會獲得 Skill 目錄。

對話修改通常也自動重新載入;顯式 reload:false 會跳過。看到 reload_error 時,不可將套件已儲存當成執行環境已重新整理,應先修復並重新載入。外部直接修改檔案後也需要重新載入。TUI 可用 /skills、Dashboard Chat 可用 / 瀏覽目前介面目錄;無需僅為了重新整理執行環境而強制建立工作階段。

刪除和還原​

代管 Skill 詳情頁的刪除 Skill會移除套件並重新載入,System Skill 不能刪除。要回到歷史代管版本,使用 CLI:

anyy skills list
anyy skills view weekly-report
anyy skills rollback weekly-report
anyy skills rollback --revision REVISION_ID weekly-report
anyy skills uninstall weekly-report
anyy skills reload

不指定版本時回到前一個代管版本。一般檔案修改不自動產生這些套件版本。

從 CLI 安裝​

anyy skills install ./weekly-report.zip
anyy skills install --force ./weekly-report.zip

CLI 優先透過該 Profile 的常駐 RPC 修改,並由常駐服務重新載入。沒有常駐程序持有所有權時,才允許取得獨佔所有權後離線修改;檔案在下次啟動時被發現。--now 會在離線修改後嘗試請求 Gateway reload,沒有可連線服務時會報告失敗。--json 可用於讀取結構化結果。

安裝失敗先檢查 Profile、ZIP 名稱、單包結構和大小。若頁面已存在但對話不能用,應檢查啟用狀態、重新載入結果和 reader,不要只看安裝成功提示。進一步用法見 Skills 系統;Skill 不會授予額外工具或系統權限。