NeboAI
NeboAI
開始使用

技能

技能教員工把某一類工作做好。你把它寫成一個含有 SKILL.md 檔案的資料夾:一段簡短說明,供員工用來選擇技能,以及載入技能後要遵循的指示。技能不需要程式碼,機器人上的每位員工都能使用。

什麼是技能

技能是一個資料夾,名稱與技能的 name 相同。資料夾中有一個 SKILL.md 檔案,也可以放指示中提到的任何其他檔案:參考文件、範本或指令碼。

SKILL.md 分成兩部分。位於 --- 行之間的 YAML 前置資料包含名稱與說明。其後的 Markdown 本文則包含指示。

員工如何使用技能

員工使用技能分為三個步驟。

  1. 選擇。每一回合,員工都會看到可用技能的清單:每個技能的名稱、說明,以及最多三個觸發詞。員工是讀說明來做決定的,所以請寫清楚技能的作用和使用時機。
  2. 載入。員工以技能名稱呼叫 use_skill 工具。這個工具會回傳指示、技能資料夾的路徑,以及其中的檔案名稱。這是員工讀取技能的唯一方式。
  3. 工作。員工依照指示進行。它用 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 欄位宣告。

下一步