# 工具與 Skill 管理工具

尋找、建立、測試與執行其他工具與 skill 的工具。

| 工具 | 說明 |
|---|---|
| `find_tools` | 工具註冊表。`mode=search` 以關鍵字比對（需全部命中）或 `select:<name>,<name>` 精確啟用，並注入對應 schema；`mode=list` 僅回傳名稱與一行描述、不注入 schema —— `mcp=true` 限縮為 MCP 對外暴露的工具，另有旗標可一併列出內部記帳用的 system 工具。省略 mode 時：有 `query` → search，否則 list。看似缺少的能力一律先查這裡，再決定是否新建 |
| `edit_tool` | 工具定義本身。`mode=write` 建立或覆寫、`mode=patch` 在 `test_tool` 失敗後修正精確字串、`mode=remove` 將目錄丟進 `.Trash`（可回收）。`tag` 決定目標檔案：`json` = `tool.json`（schema）、`script` = `script.py`（執行內容）、`api` = `<name>.json`（API 工具）。名稱為 snake_case 且不帶 `script_` 前綴 —— 前綴由 runtime 自動補上 |
| `test_tool` | 在沙箱中以 JSON 由 stdin 餵入並執行 script 工具的 `script.py`，回傳其輸出。這是每次 `edit_tool` write 或 patch 後的驗證步驟；失敗時的循環是 `edit_tool(mode=patch)` → 再測 |
| `run_skill` | 將指定 skill 的參考素材載入當前 turn；結果為 `skill: <name>`、skill 目錄與解析後的 `SKILL.md` 內文。它是參考資料，不是逐行照做的腳本。自 v1.1.0 起，執行開始時比對到或被指名的 skill 也以同樣方式載入：runtime 記錄一筆 `run_skill` 呼叫，其工具結果即帶有 skill 內容，不再另外加一則 system message |
| `edit_skill` | `~/.config/agenvoy/skills/` 底下的檔案。`mode=write` 以相對路徑建立或重寫檔案（`my-skill/SKILL.md`）、`mode=patch` 取代精確字串、`mode=remove` 以單層目錄名丟棄整個 skill（可從 `.Trash` 回收） |