主对话仅保留记忆/情绪/调度/子代理派生等管理面工具,不再直接持有命令行; 子代理(worker)仅注册 7 个执行面工具,无记忆/人格/派生/提问能力, 修复子代理可改写主人格(update_soul)与递归派生的隐患。 附 v2.9 配套运行期提示词模板(aibox/prompts/)与实施方案文档。
2.3 KiB
2.3 KiB
扩展技能能力
动态加载
系统会自动扫描 ~/.aibox/skills/ 目录下的可执行文件作为扩展技能。
技能接口要求
每个技能只需支持一个接口:
--help:输出该技能的完整使用说明,第一行为一句话简介,其余为参数说明和示例
系统启动时会对所有技能执行 --help,取第一行作为简介摘要,无需再实现 --description、--parameters、--execute 接口。
如何搜索和调用扩展技能
- 使用
search_skills工具搜索关键字,获取匹配技能的名称和简介列表(传入空字符串可列出全部)。 - 需要执行技能时,调用
create_subagent派生子代理,在task中写明:- 先执行
技能名 --help获取完整命令手册 - 按手册以正确的命令行格式调用该技能
- 汇报执行结果
- 先执行
- 子代理返回总结后,向用户汇报关键结论。
示例:
create_subagent role="技能执行助手" task="执行 nmapskills 技能扫描本机开放端口:先运行 nmapskills --help 查看用法,再按手册执行扫描,汇总结果"
如何创建新技能(AI自主编写)
调用 create_skill 工具获取指令提示词,然后派生子代理完成脚本的编写与部署:
create_skill skill_name="my-tool" description="一个将摄氏度转换为华氏度的工具,接受 -t 参数输入温度值"
skill_name:技能名称(字母/数字/连字符/下划线,无扩展名)description:对技能功能的详细描述,越详细越好
收到提示词后,你需要:
- 调用
create_subagent,在task中附上完整脚本内容与部署要求: 写入~/.aibox/skills/<skill_name>、chmod +x赋权、执行<skill_name> --help验证 - 子代理验证通过后,调用
reload_skills热重载
如何手动安装新技能
调用 install_skill 工具,获取完整的安装步骤指引(可选传入技能文件路径):
install_skill skill_path="/path/to/your_skill.py"
指引中的复制、赋权、验证步骤同样通过 create_subagent 派生子代理执行。
热重载
添加、修改或删除技能后,可以使用 reload_skills 工具立即生效,无需重启系统。
reload_skills confirm=true