tool-creator
用于构建、管理和热重载 AnimaWorks Python 外部工具的元技能,包含调度程序、凭证管理与权限设置。
简介
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 辅助函数来获取敏感凭证,以确保认证信息不会泄露于源代码中。
-
请注意,个人与共享工具会进行动态扫描与重载,非常适合快速原型制作与迭代开发工作流。
仓库统计
- Star 数
- 231
- Fork 数
- 35
- Open Issue 数
- 12
- 主要语言
- Python
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月1日 09:19