Agent Skills の使い方を考えてみた

俺たちのAI活用LT
～効率化の裏技から、喧嘩の作法まで～

#SagaLightningTalks

Transcript

1. 俺たちのAI活用LT Agent Skills の使い方を考えてみた 木村情報技術株式会社 中原 加寸美 2026/2/27 1
2. 中原 加寸美 - Kasumi Nakahara - 所属 木村情報技術株式会社 出身 佐賀県神埼市 趣味 着物 よく使用する生成AI Kiro、 Gemini 2 2026/2/27
3. アジェンダ Agent Skills とは Skills の使い方 品質向上 予期しない動作を防ぐ 2026/2/27 3 01 02 03 04
4. 01 Agent Skills とは 2026/2/27 4
5. Agent Skills とは？ Agent Skills Anthropic社が提唱し、標準化されたAIエージェント向けの専門知識パッケージ 「必要な時」に「必要なスキルだけ」起動する 2026/2/27 5
6. できること 2026/2/27 6 コンテキストの 効率化 専 門 タ ス ク の 実行 複数プラットフォーム での利用 モジュール化
7. 漸進的開示 (Progressive Disclosure) 2026/2/27 7 エージェント起動時 Skill 利用開始時 Skill 実行時 すべての Skill の 「name」 と 「description」 などの 前書きを読み込む タスクがスキルの説明と一 致した、もしくは、明示的に 呼 び 出 さ れ た と き に 、 SKILL.ｍｄの本文をコンテ キストに読み込む 作業過程で特定のスクリプト を実行したり、詳細な仕様書 やテンプレートを参照する必 要が生じた際に、それらを個 別に読み込む
8. 02 Skills の使い方 2026/2/27 8
9. ディレクトリ構造 my-skill/ ├── SKILL.md 必須: エントリーポイント（メタデータ + 指示） ├── scripts/ 実行可能なコード（Python, Bash, JS等） │ ├── setup.sh │ └── process.py ├── references/ 技術文書、スキーマ定義 │ └── api-spec.json └── assets/ テンプレート、画像、プロトコル定義 └── template.md 2026/2/27 9
10. SKILL.md の基本構造 フィールド名 必須 説明 name Yes 最大６４文字。英小文字、数字、ハイフンのみ。先頭・末尾にハイフンは利用でき ない。 description Yes 最大１０２４文字。空欄不可。 スキルの内容と使用タイミングを説明する。 license No ライセンス名、またはバンドルされたライセンスファイルへの参照。 compatibility No 最大５００文字。環境要件（対象製品、システムパッケージ、ネットワークアクセス など）を示す metadata No 追加のメタデータの任意のキーと値のマッピング allowed-tools No スキルが使用できる事前承認されたツールのスペース区切りリスト。 2026/2/27 10 前書き 本文 1. 明確な手順を番号付きで記述 2. 禁止事項を明示 （「～～は絶対に行わないこと」） 3. 具体例を提示
11. 実際に作成したスキル 2026/2/27 11
12. 03 品質向上 2026/2/27 12
13. 改善サイクル 失敗 パターン の収集 SKILL.mdの 改善 検証と 反復 2026/2/27 16 スキルは一度作って終わり、ではない 実行結果を確認して継続的に改善 していく
14. 改善のポイント 2026/2/27 17 具体的な手順の記載 明確な制約 実例の追加
15. 改善処理のタイミング 2026/2/27 19 実行完了直後 中原のオススメ
16. 完了直後にする理由 2026/2/27 20 実 際 の 失 敗 を も と に 、 改善方法を一緒に考えて くれる • 自分が想定していた作業と実際の作業の差異を 確認して、差を埋める • やってほしくない作業があったら伝える 更 新 を 自 分 で 反 映 し て くれる • 文章を作るのが苦手でも心配なし！ • AIが使いやすいように記述してくれる
17. 2026/2/27 21 • 例
18. 04 予期しない動作を防ぐ 2026/2/27 22
19. エージェントの暴走を防ぐ 2026/2/27 23 実行回数の制限 実行前の確認 実行範囲の制限 サンドボックスでの 実行
20. スキルを安全に使う • 外部から入手したスキルは内容を確認してから使用する • 本番環境で試す前に、テスト環境で動作確認をする • エージェントの実行ログを定期的にチェックする 2026/2/27 24
21. 0５ まとめ 2026/2/27 25
22. まとめ • Agent Skills は 「必要な時」に「必要なスキルだけ」起動する機能 • エージェント起動時には、メタデータのみを読み込むのでコンテキストを節約できる • スキルは一度作って終わりではない • 実行結果を確認して継続的に改善していくことで精度が上がる • 改善のタイミングのオススメは、「実行完了直後」 • 予期しない動作を防ぐ記述も必要 • 外部から入手したスキルは必ず確認してから利用する 2026/2/27 26
23. 2026/2/27 27 Thank you !