什么是技能
技能是一个文件夹,名称与技能的 name 一致。文件夹中有一个 SKILL.md 文件,还可以放指令中提到的其他任何文件:参考文档、模板或脚本。
SKILL.md 由两部分组成。--- 行之间的 YAML 前置信息包含名称和描述。其后的 Markdown 正文包含指令。
员工如何使用技能
员工使用技能分三步。
- 选择。每一轮,员工都会看到可用技能的列表:每个技能的名称、描述,以及最多三个触发词。员工靠阅读描述来做决定,所以描述要写清楚技能做什么、何时使用。
- 加载。员工用技能名称调用
use_skill工具。该工具返回指令、技能文件夹的路径以及其中文件的名称。这是员工读取技能的唯一方式。 - 工作。员工按照指令工作。它用
read_skill_file读取辅助文件,用execute运行附带的脚本。
触发词永远不会自行加载技能,始终由员工做出选择。当列表变长时,员工可以用 find_skills 搜索。
编写你的第一个技能
创建一个以技能命名的文件夹,在里面放一个文件。
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
把这个文件夹放进机器人的用户技能目录(参见技能存放位置)。Nebo 会在大约一秒内发现新文件夹,该机器人上的每位员工都可以使用这个技能。
员工也可以替你编写技能。让它保存一个,它就会调用 save_skill,把文件夹写入同一个用户技能目录。
加载器强制执行的规则
违反其中任一规则的技能不会被加载。Nebo 会记录一条警告并跳过它。
| 规则 | 说明 |
|---|---|
文件以 --- 开头 | 前置信息必须位于文件最开头。文件必须是 UTF-8 编码。 |
name 为必填 | 只能使用小写字母、数字和连字符;不能以连字符开头或结尾;不能有连续两个连字符;最多 64 字节。 |
description 为必填 | 最多 1,024 字节。 |
| 字段类型正确 | 任何字段的 YAML 类型不对,整个文件都会失败。版本号要加引号,例如 "1.0.0"。 |
platform 匹配 | 如果存在,技能只会在列出的操作系统上加载。 |
Nebo 无法识别的前置信息键会被忽略。正文没有大小限制,但指令越短,留给工作的空间就越多。把较长的内容移到员工需要时才读取的文件中。
添加文件
文件夹中除 SKILL.md 和点文件之外的任何文件,员工都可以使用。文件夹名称由你决定;Nebo 不会赋予 references/ 或 assets/ 特殊含义。scripts/ 或 bin/ 下的文件可以运行。
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute 用文件在文件夹内的路径来引用它们,例如 references/policy.md。员工用 read_skill_file 读取它们,该工具会拒绝任何超出文件夹的路径。脚本通过 execute 工具在沙盒中运行。SKILL.md 参考介绍了运行时、环境变量、密钥和网络访问。
技能存放位置
机器人会从多个位置收集技能。当两个来源提供同名技能时,此列表中排在后面的来源优先。
| 来源 | 位置 | 谁可以使用 |
|---|---|---|
| 内置 | 编译在 Nebo 中 | 所有员工 |
| 市场 | <data>/nebo/skills/<slug>/<version>/ | 所有员工 |
| 插件 | 已安装插件中的 skills/ 文件夹 | 所有员工 |
| 用户 | <data>/user/skills/<name>/ | 所有员工 |
| 员工包 | 已安装员工包中的 skills/ | 仅限该员工 |
| 习得 | <data>/learned/skills/<employee>/<name>/ | 仅限该员工 |
<data> 在 macOS 上是 ~/Library/Application Support/Nebo,在 Windows 上是 %APPDATA%\Nebo,在 Linux 上是 ~/.local/share/nebo。NEBO_HOME 环境变量可以覆盖它。当员工拥有一个自己的技能和一个同名的共享技能时,以它自己的技能为准。
Nebo 会监视这些文件夹,技能有改动时会在一秒后重新加载。要在不删除的情况下停用某个技能,把它的文件重命名为 SKILL.md.disabled。
技能描述的是工作,而不是工具。围绕一项职责来编写技能,例如核对收据,然后让员工使用所有者提供的任何连接。只有当技能确实需要某个插件时,才用 plugins 字段声明它。
下一步
- SKILL.md 参考:所有字段、工具和变量。
- 示例:可直接复制的完整技能。
- 发布:把技能上架到市场。