NeboAI
NeboAI
はじめる

スキル

スキルは、ある種類の仕事をうまくこなす方法を社員に教えます。SKILL.mdファイルを収めたフォルダとして書きます。社員がスキルを選ぶための短い説明と、スキルを読み込んだ後に従う指示です。スキルにコードは不要で、ボット上のすべての社員が使えます。

スキルとは

スキルとは、スキルのnameと同じ名前のフォルダです。フォルダにはSKILL.mdファイルと、必要に応じて指示が参照するその他のファイル(参考文書、テンプレート、スクリプト)が入ります。

SKILL.mdは2つの部分からなります。---の行で囲まれたYAMLフロントマターには、名前と説明が入ります。その後のMarkdownの本文には指示が入ります。

社員がスキルを使う仕組み

社員は3つのステップでスキルを使います。

  1. 選ぶ。社員はターンごとに、使用できるスキルの一覧を目にします。各スキルの名前、説明、最大3つのトリガーです。社員は説明を読んで判断するので、スキルが何をするのか、いつ使うのかがわかるように書いてください。
  2. 読み込む。社員はスキルの名前を指定してuse_skillツールを呼び出します。ツールは、指示、スキルのフォルダのパス、ファイル名を返します。社員がスキルを読む方法は、これだけです。
  3. 働く。社員は指示に従います。補助ファイルは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リファレンス: すべてのフィールド、ツール、変数。
  • 例: そのままコピーできる完全なスキル。
  • 公開: スキルをマーケットプレイスに出す。