tool-creator

tool-creator 元技能為開發者與自主代理提供了一個標準化框架，用於在 AnimaWorks 生態系統中構建與整合自定義 Python 工具。透過自動化工具註冊、參數 schema 定義與憑證處理的模板代碼，此技能能無縫擴展代理的能力。它支援三種不同的工具類別：核心工具、共享工具與個人工具，允許從內部系統模組到用戶自定義腳本的靈活架構。開發者可以定義用於 API 整合的複雜多 schema 工具，或簡單的單操作工具，並確保它們能透過 ExternalToolDispatcher 立即被發現。

• 提供標準化的 get_tool_schemas 與 dispatch 邏輯模板，確保工具執行的一致性。

• 完美支援使用 httpx 的 Web API 封裝，並整合 get_credential 進行安全的憑證管理。

• 透過 refresh_tools 實現熱重載功能，允許代理在不重啟 AnimaWorks 主伺服器的情況下測試與部署更新。

• 透過 animaworks-tool 支援強大的命令行介面存取，支援動態子命令與參數解析。

• 與 permissions.json 整合的細粒度權限管理，在將新檔案寫入工具目錄時強制執行安全性。

• 自動整合跨個人 (~/.animaworks/tools/)、共享與核心目錄的工具發現流程。

• 使用者應遵循 snake_case 命名規範設計工具，並為代理執行的自動化流程提供清晰的輸入 schema。

• 在建立或修改 Python 模組後務必呼叫 refresh_tools，以確保 ExternalToolDispatcher 能檢測到變更。

• 使用具備適當權限的 write_memory_file 方法，從代理環境中以程式化方式建立工具。

• 務必利用 get_credential 輔助函數來獲取敏感憑證，以確保認證資訊不會洩露於原始碼中。

• 請注意，個人與共享工具會進行動態掃描與重載，非常適合快速原型製作與迭代開發工作流。