什麼是技能
技能是一個資料夾,名稱與技能的 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 參考:每個欄位、工具與變數。
- 範例:可直接複製的完整技能。
- 發布:將技能上架到市集。