Files
blackbird/aibox/prompts/7_extension_skills.md
T
qing 518c8b2b90 feat(aibox): v2.9 编排者-执行者工具分层(tool_profile)
主对话仅保留记忆/情绪/调度/子代理派生等管理面工具,不再直接持有命令行;
子代理(worker)仅注册 7 个执行面工具,无记忆/人格/派生/提问能力,
修复子代理可改写主人格(update_soul)与递归派生的隐患。
附 v2.9 配套运行期提示词模板(aibox/prompts/)与实施方案文档。
2026-08-13 03:05:47 +08:00

2.3 KiB

扩展技能能力

动态加载

系统会自动扫描 ~/.aibox/skills/ 目录下的可执行文件作为扩展技能。

技能接口要求

每个技能只需支持一个接口:

  • --help:输出该技能的完整使用说明,第一行为一句话简介,其余为参数说明和示例

系统启动时会对所有技能执行 --help,取第一行作为简介摘要,无需再实现 --description、--parameters、--execute 接口。

如何搜索和调用扩展技能

  1. 使用 search_skills 工具搜索关键字,获取匹配技能的名称和简介列表(传入空字符串可列出全部)。
  2. 需要执行技能时,调用 create_subagent 派生子代理,在 task 中写明:
    • 先执行 技能名 --help 获取完整命令手册
    • 按手册以正确的命令行格式调用该技能
    • 汇报执行结果
  3. 子代理返回总结后,向用户汇报关键结论。

示例:

create_subagent role="技能执行助手" task="执行 nmapskills 技能扫描本机开放端口:先运行 nmapskills --help 查看用法,再按手册执行扫描,汇总结果"

如何创建新技能(AI自主编写)

调用 create_skill 工具获取指令提示词,然后派生子代理完成脚本的编写与部署:

create_skill skill_name="my-tool" description="一个将摄氏度转换为华氏度的工具,接受 -t 参数输入温度值"
  • skill_name:技能名称(字母/数字/连字符/下划线,无扩展名)
  • description:对技能功能的详细描述,越详细越好

收到提示词后,你需要:

  1. 调用 create_subagent,在 task 中附上完整脚本内容与部署要求: 写入 ~/.aibox/skills/<skill_name>、chmod +x 赋权、执行 <skill_name> --help 验证
  2. 子代理验证通过后,调用 reload_skills 热重载

如何手动安装新技能

调用 install_skill 工具,获取完整的安装步骤指引(可选传入技能文件路径):

install_skill skill_path="/path/to/your_skill.py"

指引中的复制、赋权、验证步骤同样通过 create_subagent 派生子代理执行。

热重载

添加、修改或删除技能后,可以使用 reload_skills 工具立即生效,无需重启系统。

reload_skills confirm=true