跳至主要內容

Skills 系統

重複工作可以整理為 Skill:SKILL.md 說明適用任務和步驟,支援檔案按需讀取。它使用目前工作階段已有工具,不會額外獲得作業系統權限。安裝前先核對指令、外部服務、認證資料和關聯檔案。

準備並安裝套件​

Anyy 只接受一個本機 .zip 包,不直接安裝 GitHub 位址、遠端 URL、本機目錄或集合,也沒有 --all。ZIP 中放一個 Skill,可以直接放入口與支援檔案,或使用單一外層目錄。

入口的 name 最長 64 字元,只能用小寫字母、數字以及連接它們的單一連字元,例如 invoice-check。不可將路徑作為名稱;外層目錄建議與名稱一致。ZIP 和解壓後的總內容各不超過 10 MiB,Dashboard 整個 multipart 請求也不能超過 10 MiB。無效名稱、越界路徑、Symlink、特殊檔案和多個 Skill 都會被拒絕。

anyy skills install ./invoice-check.zip

替換同名代管套件才使用 --force。也可以從 Dashboard → Skills → Install Skill 上傳,或者把 Anyy 主機可讀的 ZIP 路徑交給具備 skill_manage 的對話。三種入口寫目前 Profile 的同一份代管庫;歷史來源標籤仍可顯示,但不能用來重新啟用舊遠端安裝入口。已有本機發現與唯讀外部根目錄是載入能力,不是目錄安裝。

安裝之後確認兩端都能使用​

頁面安裝後,檢查 Skill 詳情的正文、來源、路徑及啟用狀態;替換停用的套件不會自動重新啟用。隨後在同一 Profile 傳送一則新提示詞,例如:

按 invoice-check Skill 检查这份账单;先读说明,再告诉我需要哪些输入。

對話安裝也應回到頁面檢查實際記錄,不能只依據成功回覆。CLI 常駐 RPC 和 Dashboard 修改會重新載入目錄;對話 skill_manage 預設也重新載入,但 reload:false 會跳過,reload_error 表示儲存與重新整理沒有全部成功。

離線 CLI 修改僅在沒有常駐所有者、取得獨佔 Profile 所有權後執行,檔案在下次啟動時被發現。--now 是離線修改後請求 Gateway reload,沒有可連線 Gateway 時會報告失敗。

模型怎樣讀取 Skill​

目錄給出入口位置,模型用選中的 read 或 bash 按需讀取,支援檔案的相對引用以入口目錄為基準。reader 經 Codemode 可用時仍保留目錄;兩種 reader 都不可用時,不向模型提供 Skill 目錄。沒有獨立的 skills_list/skill_view 模型工具。

顯式 /skill:NAME 為該次提交展開指定 Skill。已辨識入口若讀不到或解析失敗,訊息仍會被接受並交給模型,同時產生非致命展開錯誤通知,通知可能晚於回覆開始。投遞方式見通知與投遞。

目錄重新載入影響後續發現與接受,不替換已排隊、已執行訊息或已接受回顧中的說明和選擇。不需要僅為了接收重新載入而建立工作階段。

檢視、還原和刪除​

CLI 可以檢視目錄、入口及宣告的支援檔案:

anyy skills list
anyy skills view invoice-check
anyy skills view invoice-check references/rules.md

需要撤銷一次代管更新時:

anyy skills rollback invoice-check
anyy skills rollback --revision REVISION_ID invoice-check
anyy skills uninstall invoice-check
anyy skills reload

不指定 revision 就回到前一個代管版本。--json 輸出結構化結果;--now 的含義同上。Dashboard 可以啟用/停用非 System Skill,也可以移除代管套件;停用不刪除檔案。

代管 Skill 更新​

skill_manage 能安裝、建立、修改、刪除代管檔案以及還原,並儲存套件版本。一般檔案編輯不自動取得這一版本保證。內建和外部發現的 Skill 對代管 writer 唯讀;重新載入、新增外部根目錄不會產生套件版本。

自動回顧繼承父對話的工具選擇、排除項與工具組,還需要可用代管 writer。接受時的選擇跨重試或重啟保持,後來修改父對話不為既有回顧增加工具。只有實際成功的代管結果才觸發更新通知;沒有可供重複使用的學習成果時,可以不修改套件庫。

保留原 ZIP 方便重現。個人長期偏好應放 Memory;流程適合 Skill,外部服務連線適合 MCP。頁面步驟見 Dashboard Skills。