工程开发
tool-creator avatar

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
在 GitHub 查看