Skill
知識と手順をまとめたもの。Workspace 内で version 管理され、agent version に grant されます。
Skill は、ルートに SKILL.md を持つファイルのディレクトリです。ある作業について agent が従うべき知識と手順を収めます — そうでなければシステムプロンプトに貼り付けられ、そこで古びていくような情報です。
Skill は workspace に属し、version 管理され、agent version に grant されます。同じ skill を複数の agent に grant することもできます。
バンドル
- refund-policy/
- SKILL.md
- reference/
- tiers.md
- escalation.md
バンドルのルートには SKILL.md が必須です。その frontmatter が skill を名付け、ディレクトリ内の他のものはすべてそれに付いていきます。
| 上限 | 値 |
|---|---|
| バンドルあたりのファイル数 | 1,000 |
| ファイルあたりのバイト数 | 10 MB |
| バンドルあたりのバイト数 | 10 MB |
| シンボリックリンク | 拒否され、決してたどりません |
シンボリックリンクは解決されるのではなく拒否されます。たどってしまえば、バンドルに入れた覚えのないファイルをアップロードすることになるからです — ln -s /etc/passwd notes.txt は、そのファイルの中身を無害そうな名前で送り出してしまいます。
作成と push
最初の push が version 1 を作り、それ以降の push は次の version を追加します。
subako skill create ./refund-policy
subako skill push <skill-id> ./refund-policy
subako skill versions <skill-id>毎回ディレクトリ全体がパックされてアップロードされます — push は直前との差分ではなく、バンドルの新しい version です。
subako skill list
subako skill show <skill-id>
subako skill rename <skill-id> --display-name "Refund policy"Rename は、バンドル自身の名前を上書きする表示名を設定します。空に設定すると解除され、frontmatter の名前が再び使われます。
Skill を grant する
Grant は agent version の設定の中にあります。Version 番号を固定することも、各 version の公開時点における skill の最新に追随させることもできます。
削除
subako skill delete <skill-id>これは skill とそのすべての version・バンドルを削除します。まだ依存しているものがある間は 409 で拒否されます — それを grant している公開済みの agent version や、まだそれを保持している session です。先にそちらを片付けてください。