Role、Skill 與允許清單端點
最後更新
Role、skill，以及 skill 與工具允許清單的端點。
Role 與 Skill
| Method | 路徑 | 說明 |
|---|---|---|
GET | /v1/roles | local — 列出存放於 prompts/ 的 .md session prompt role（name、size、updated_at），放在 roles 下回傳，並為舊版 client 在 rules 下再附同一份清單 |
GET | /v1/role/*name | local — 讀取單一 role |
POST PATCH DELETE | /v1/role | local — 建立 / 更新（可選 rename）/ 刪除 role。POST 與 PATCH 收 {name, content}；名稱已被使用時回 409。DELETE 收 ?name=（或 {name}）；role 不存在時回 404 |
GET | /v1/skills | local — 以 {name, description?} 列出已安裝的 skill，排除 TUI 專用 skill；v1.2.0 起經 /v1/config/skill_source 停用的來源不會被掃描，也不會出現在清單中 |
GET | /v1/skill/*name | local — 讀取單一已安裝 skill：name、description、path、source、content、deletable，另加 files —— 該 skill 的 scripts/／references/／assets/ 底下所有 UTF-8 檔案，以 {path, content} 依路徑排序回傳，跳過隱藏檔、超過 1 MiB 者略過（v1.0.2） |
DELETE | /v1/skill | local — ?name=。把單一已安裝 skill 移到 ~/.config/agenvoy/skills/.Trash，回傳 {ok, trashed}。只有 ~/.config/agenvoy/skills/ 底下的 skill 可移除——.system、.system_design 與其他來源皆不行（回 403） |
Rule 已於 v1.1.0 更名為 role。仍有五條路由保留為 role handler 的別名——
GET /v1/rules、GET /v1/rule/*name，以及 POST / PATCH / DELETE /v1/rule——舊版 client 可繼續使用。操作者筆記已於 v1.0.23 移除：
/v1/notes、/v1/note/*name 與 /v1/note（原 /v1/knowledge*）皆不再存在。常駐指示請改放在 role 或 skill。允許清單
| Method | 路徑 | 說明 |
|---|---|---|
GET POST | /v1/allowlist | local — 兩份允許清單合成一個物件：skill 與 tool。GET 對 skill 區塊讀 ?scope=global|project（project 需帶 ?work_dir=），對 tool 區塊以 ?prefix= 縮限。POST 接受 {skill: {name, scope?, work_dir?}} 切換單一 skill，以及 / 或 {tool: {prefix, entries}} 只替換該 prefix 的自動核准條目（與 TUI /mcp → permission 同一支呼叫），其他規則保持不變；每個條目都必須以 prefix 開頭，prefix* 會收斂其餘條目。未帶到的區塊不動 |