スキルで仕事の進め方を教える

仕事の進め方をスキルとして書くか、GitHub からスキルパックを取り込んでアシスタントに取り付けます。アシスタントは回答のたびにスキルの指示に従います。

スキルとは#

スキルは、繰り返し使える仕事の進め方です。たとえば「クレームへの返信手順」や「見積書の形式」などです。スキルを取り付けたアシスタントは、回答のたびにスキルを常に有効な指示として扱います。

スキルとナレッジの違い：

• ナレッジには資料を入れます。アシスタントは質問に応じて検索し、関係する部分だけを使います。
• スキルには進め方を入れます。取り付けたスキルは検索を経ずに、回答のたびに全文が付けられます。

コンソールの「スキル」を開くと、2 つの欄があります。「スキルライブラリ」にはワークスペースで共有するスキルと自分のスキルが一覧になり、「スキルパック」では GitHub からスキルを取り込めます。

誰が何をできるか#

スキルを作成する#

1. 「スキル」を開き、「スキルを作成」までスクロールします。
2. 「名前」を入力します。
3. 必要なら「説明（任意）」に、このスキルをどんなときに使うかを書きます。
4. 「指示内容」に、このスキルを使うときにアシスタントが従う手順を書きます。
5. 「自分だけで使う」をオンにするかどうかを決めます（自分だけで使うスキルを参照）。
6. 「作成」を選びます。

作成したスキルは「スキルライブラリ」の表に表示され、「名前」と「説明」が見られます。

自分だけで使うスキル#

スキルを作成するときに「自分だけで使う」をオンにすると、そのスキルはあなたにしか見えず、ワークスペースのスキルライブラリには追加されません。これらのスキルは「スキルライブラリ」の表の「マイスキル」の下に一覧になり、名前の横に「自分専用」と表示されます。

• オーナーでも管理者でもないメンバーが書いたスキルは常に自分だけで使うものになり、このスイッチはオンで固定されます。ワークスペースのスキルライブラリに追加するには、ワークスペースのオーナーか管理者に作成を頼む必要があります。
• 自分のスキルは自分のプライベートアシスタントにだけ取り付けられます。取り付けはプライベートアシスタントの「そのほかの設定」で行います。
• プライベートアシスタントにあなたの個人スキルが取り付けられている間は、そのアシスタントを共有できません。先にスキルを外すか、管理者にワークスペースのスキルライブラリへ入れてもらってから共有してください。
• 自分のスキルは、管理者の権限がなくても自分で編集、削除、復元できます。

GitHub からスキルパックを取り込む#

チームがすでに GitHub にスキルを置いている場合は、まとめて取り込み、あとから同期して更新できます。

1. 「スキル」ページの「スキルパック」の欄で「リポジトリの URL」を入力します。例：https://github.com/your-org/skills
2. 必要なら「ブランチまたはタグ」を入力します。空欄なら main が使われます。
3. 「パックを取り込む」を選びます。

完了すると、ページに今回の結果が表示されます：「追加 N、更新 N、スキップ N、ローカル保持 N、不正な形式 N、未取込の添付 N。」

リポジトリの形式

リポジトリ内で SKILL.md を 1 つ置いたフォルダが、1 つのスキルになります。

---
name: 返品対応
description: お客様から返品の依頼があったときに使う
---

1. まず注文番号と購入日を確認する。
2. 7 日を過ぎた注文は、返品期限を説明してサポートのメールアドレスを案内する。

• name は必須で、スキルの名前になります。description は任意です。
• ファイルの先頭は --- で始まり、終わりの --- も必要です。
• --- の後ろの内容が指示内容になり、空にはできません。
• SKILL.md と同じフォルダにあるほかのファイルは取り込まれず、「未取込の添付」に数えられます。
• 形式に合わない SKILL.md や長さの上限を超える SKILL.md は取り込まれず、「不正な形式」に数えられます。

取り込みと同期のルール

• 対応しているのは github.com 上の公開リポジトリだけです。
• スキルライブラリに同じ名前（大文字と小文字は区別しません）のスキルがすでにある場合、そのスキルはスキップされ、上書きされません。
• 取り込んだスキルはワークスペースのスキルライブラリに入り、50 件の枠に数えられます。
• 各スキルパックには URL、ブランチまたはタグ、現在同期している commit が表示されます。「同期」を選ぶと、リポジトリの最新の内容を取得します。 - 上流で変更され、あなたが変更していないスキルは新しい内容に更新され、古い内容はバージョン履歴に残ります。 - Agent Lab で変更したスキルは、同期しても常にあなたの版が保持され、「ローカル保持」に数えられます。 - 上流で削除されたスキルはスキルライブラリに残り、自動では削除されません。
• リポジトリの大きさにも上限があります。ファイル数は最大 5,000、合計 32 MB、1 ファイル 4 MB までです。超えるとパック全体が取り込まれません。

アシスタントに取り付ける#

1. アシスタントの設定ページを開き、「スキル」の欄を探します。
2. 「スキルを選択」で 1 つ選び、「取り付ける」を選びます。
3. 外すときは、スキルのラベルの × を選びます。

1 つのアシスタントに取り付けられるスキルは最大 20 件です。スキルライブラリにまだスキルがない場合は、先に「スキル」ページで作成するよう案内されます。アシスタントのほかの設定はアシスタントをご覧ください。

アシスタントがスキルを使う仕組み#

回答のたびに、アシスタントは取り付けたスキルを取り付けた順に自分の指示の後ろへつなげ、そのあとでナレッジのデータを読みます。スキルは質問した人によって変わりません。

取り付けたスキルの合計には長さの上限があり、約 6,000 バイト（日本語や中国語で約 2,000 文字）です。あるスキルを加えると上限を超える場合、そのスキル以降のスキルはすべて付けられず、コンソールにも表示されません。スキルを多く取り付けている場合や長いスキルがある場合は、最も重要なものから取り付け、どのスキルも簡潔にしてください。

編集とバージョン履歴#

• 編集：スキルの行で「編集」を選び、変更したら「変更を保存」を選びます。編集画面には現在の「バージョン N」が表示されます。このスキルを取り付けているすべてのアシスタントが、すぐに新しい内容を使います。
• 同時編集：あなたが編集している間にほかの人が同じスキルを変更した場合、保存は止められ、画面が再読み込みされて通知されます。現在の内容を確認してから保存してください。
• 履歴：「履歴」を選ぶと「「…」の以前の内容」が表示され、各バージョンに日時と変更した人が付いています。現在有効なバージョンには「現在使用中」と表示されます。特定のバージョンに戻すには「この内容に戻す」を選びます。

スキルを削除する#

スキルの行で「削除」を選びます。ダイアログにこのスキルを使っているアシスタントが表示され、削除するとそれらの返信が変わることが示されます。確認したら「それでも削除」を、残す場合は「残す」を選びます。

削除すると、スキルはすべてのアシスタントから外されます。スキルの取り付け、取り外し、削除は、すべて「チームとアクセス」の監査ログに記録されます。

上限#

名前、説明、指示内容は文字数で数え、漢字やかなも英字と同じく 1 文字です。1 回の回答に付けるスキルの合計はバイト数で数え、漢字やかなは 1 文字 3 バイトになるため、日本語や中国語のスキルでは約 2,000 文字で上限に達します。名前、説明、指示内容が長すぎる場合、作成時には「スキルを作成できませんでした。名前と手順を確認してください。」、編集して保存したときには「スキルを保存できませんでした。もう一度お試しください。」と表示されます。

次のステップ#