スキルとは
スキルとは、スキルのnameと同じ名前のフォルダです。フォルダにはSKILL.mdファイルと、必要に応じて指示が参照するその他のファイル(参考文書、テンプレート、スクリプト)が入ります。
SKILL.mdは2つの部分からなります。---の行で囲まれたYAMLフロントマターには、名前と説明が入ります。その後のMarkdownの本文には指示が入ります。
社員がスキルを使う仕組み
社員は3つのステップでスキルを使います。
- 選ぶ。社員はターンごとに、使用できるスキルの一覧を目にします。各スキルの名前、説明、最大3つのトリガーです。社員は説明を読んで判断するので、スキルが何をするのか、いつ使うのかがわかるように書いてください。
- 読み込む。社員はスキルの名前を指定して
use_skillツールを呼び出します。ツールは、指示、スキルのフォルダのパス、ファイル名を返します。社員がスキルを読む方法は、これだけです。 - 働く。社員は指示に従います。補助ファイルは
read_skill_fileで読み、同梱のスクリプトはexecuteで実行します。
トリガーだけでスキルが読み込まれることはありません。選ぶのは常に社員です。一覧が長くなったら、社員はfind_skillsで検索できます。
最初のスキルを書く
スキルの名前を付けたフォルダを作り、その中にファイルを1つ置きます。
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".
フォルダを、ボットのユーザーskillsディレクトリに置きます(スキルの置き場所を参照)。Neboは約1秒で新しいフォルダに気づき、そのボット上のすべての社員がスキルを使えるようになります。
社員にスキルを書いてもらうこともできます。保存するよう頼めば、社員はsave_skillを呼び出し、同じユーザーskillsディレクトリにフォルダを書き込みます。
ローダーが適用するルール
これらのルールのいずれかに違反するスキルは読み込まれません。Neboは警告をログに記録し、そのスキルをスキップします。
| ルール | 詳細 |
|---|---|
ファイルが---で始まる | フロントマターはファイルの先頭に置く必要があります。ファイルはUTF-8である必要があります。 |
nameは必須 | 小文字、数字、ハイフンのみ。先頭・末尾のハイフン、連続したハイフンは不可。最大64バイト。 |
descriptionは必須 | 最大1,024バイト。 |
| フィールドの型が正しい | YAMLの型が間違っているフィールドがあると、ファイル全体が失敗します。バージョンは"1.0.0"のように引用符で囲んでください。 |
platformが一致する | 指定されている場合、スキルは列挙されたOSでのみ読み込まれます。 |
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リファレンスで説明しています。
スキルの置き場所
ボットは複数の場所からスキルを集めます。2つのソースが同じ名前のスキルを提供している場合は、この一覧で後にあるソースが優先されます。
| ソース | 場所 | 使える社員 |
|---|---|---|
| 組み込み | 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はこれらのフォルダを監視しており、スキルが変更されると1秒後に再読み込みします。スキルを削除せずにオフにするには、ファイル名をSKILL.md.disabledに変更します。
スキルが記述するのはツールではなく仕事です。レシートの照合のような責任を軸にスキルを書き、オーナーが用意した接続を社員が何でも使えるようにしましょう。スキルが本当にプラグインを必要とする場合は、pluginsフィールドで宣言します。
次へ
- SKILL.mdリファレンス: すべてのフィールド、ツール、変数。
- 例: そのままコピーできる完全なスキル。
- 公開: スキルをマーケットプレイスに出す。