Bob2.0でますます便利に！ ルールとカスタム機能を活用して IBM Bobへの指示を効率化しよう

5/27開催のウェビナー『ルールやカスタム機能、どう使う？理想の出力を引き出すために今知りたいIBM Bob 5つの機能』にて大好評だったルールとカスタム機能の解説をBob2.0に合わせて改訂した解説資料です。

Transcript

1. Bob2.0でますます便利に！ ルールとカスタム機能を活用して IBM Bobへの指示を効率化しよう 日本アイ・ビー・エム株式会社 テクノロジー事業本部 第三営業本部 カスタマー・サクセス推進部 カスタマー・サクセス・マネージャー 上原 瑞歩
2. あなたのBobは期待通りの出力をしてくれていますか？ © 2026 IBM Corporation 2
3. あなたが入力するプロンプトに自信はありますか？ © 2026 IBM Corporation 3
4. AI初心者の典型的な失敗: 背景情報の不足 / 曖昧な指示 出力の質を低下させる © 2026 IBM Corporation 4
5. 期待通りの出力のためには 具体的な指示と十分な情報が必要 © 2026 IBM Corporation 5
6. 期待通りの出力のためには 具体的な指示と十分な情報が必要 プロンプト コンテキスト Bobにユーザーが入力する指示 Bobが出力の際に参照する全ての情報 © 2026 IBM Corporation 6
7. 振り返り: プロンプト / コンテキスト設計のコツ 8/26開催のウェビナーではプロンプトやコンテキストの工夫でより伝わりやすい指示ができることを デモを交えながらご紹介しました。（リプレイはこちら: https://video.ibm.com/recorded/134996351 ） プロンプト設計のコツ • 指示はチームの新メンバーに伝わるくらい具体的に書く • 指示内容を具体化する際は以下の6点を意識し、タスクに合わせて取捨選択する 1. 目的・ゴール ＜達成したいこと、具体的なタスク＞ 2. 役割設定 ＜AIに担わせる役割や専門性、振る舞い＞ 3. 出力要件 ＜出力の形式・構成・分量＞ 4. タスクの背景 ＜タスクを取り巻く状況や前提＞ 5. 参照情報 ＜出力の根拠とする情報源と優先順位＞ 6. 処理ルール ＜タスク遂行にあたってのルール＞ コンテキスト設計のコツ • 回答生成に不要な情報は与えない • タスクはできるだけ小さく切り分ける • タスクを分割して実行するツール（サブタスクツール / サブエージェントツール）を活用する © 2026 IBM Corporation ※ 2026年8月現在の情報に基づき、初心者向けに整理したものです。効果を保証するものではありませんので予めご了承ください。 7
8. 実践すると期待に近い出力は実現できるけど… © 2026 IBM Corporation 8
9. こんな課題を感じませんか？ • タスク間で共通の背景情報を毎回書くのは非効率 • 細かいルールを書くとプロンプトが長大になってしまう • 役割設定を複数のタスクで統一したい © 2026 IBM Corporation 9
10. これらの課題を解決する機能が... © 2026 IBM Corporation 10
11. • AGENTS.md • カスタム・ルール • カスタム・モード • スキル © 2026 IBM Corporation 11
12. この資料のゴール 4つの機能の特徴や使い分けを学ぶ タスクや状況に合わせて機能を選択できるようになる © 2026 IBM Corporation 12
13. 目次 1. ルール・カスタム機能の概要 2. 各機能の紹介・使い分け解説 ① AGENTS.md ② カスタム・ルール ③ カスタム・モード ④ スキル 3. まとめ © 2026 IBM Corporation 13
14. 目次 1. ルール・カスタム機能の概要 2. 各機能の紹介・使い分け解説 ① AGENTS.md ② カスタム・ルール ③ カスタム・モード ④ スキル 3. まとめ © 2026 IBM Corporation 14
15. まずはざっくりとイメージを掴みましょう 各機能の解説に入る前にそれぞれどんなことができるのかを一言でご紹介します。 ① AGENTS.md: 個別タスク全てに共通する背景情報をBobに伝える ② カスタム・ルール: ルールをトピックや目的別のファイルに分割して格納する ③ カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定する ④ スキル: © 2026 IBM Corporation Bobに手順書通りの処理を実行させる 15
16. 機能の分類 4つの機能を2つのグループに分けて解説します。 全体に適用する情報やルールを伝える機能 ① AGENTS.md: 個別タスク全てに共通する背景情報をBobに伝える ② カスタム・ルール: ルールをトピックや目的別のファイルに分割して格納する 用途に応じて指示を出すために使う機能 ③ カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定する ④ スキル: © 2026 IBM Corporation Bobに手順書通りの処理を実行させる 16
17. 目次 1. ルール・カスタム機能の概要 2. 各機能の紹介・使い分け解説 ① AGENTS.md ② カスタム・ルール ③ カスタム・モード ④ スキル 3. まとめ © 2026 IBM Corporation 17
18. 機能の分類 まずは「全体に適用する情報やルールを記述する機能」として AGENTS.mdとカスタム・ルールの特徴や使い分けを解説します。 全体に適用する情報やルールを伝える機能 ① AGENTS.md: 個別タスク全てに共通する背景情報をBobに伝える ② カスタム・ルール: ルールをトピックや目的別のファイルに分割して格納する 用途に応じて指示を出すために使う機能 ③ カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定する ④ スキル: © 2026 IBM Corporation Bobに手順書通りの処理を実行させる 18
19. ① AGENTS.md: 個別タスク全てに共通する前提知識をBobに伝える 書くこと –プロジェクトの概要・ゴール –プロジェクト全体に適用するルール（ルールのアウトライン） 使い方 1. プロジェクトのルートに AGENTS.md を置いてプロジェクト概要などを記述 2. Bobとのチャット開始時に読み込まれる © 2026 IBM Corporation 19
20. ②カスタム・ルール: ルールをトピックや目的別に分割して格納する 書くこと –プロジェクト全体に適用するルール（例: コーディング規約、テスト方針 など） 使い方 1. ルール格納ディレクトリーにトピックや目的別のルールファイルを作成 2. 各ファイルにルールを記述 3. Bobとのチャット開始時に読み込まれる © 2026 IBM Corporation 20
21. ②カスタム・ルール: ルールをトピックや目的別に分割して格納する ディレクトリー/ファイル構成のイメージは以下のとおりです。 ルール格納ディレクトリー (.bob/rules) <ファイル名>.md コーディング規約 © 2026 IBM Corporation <ファイル名>.md テスト方針 <ファイル名>.md デザインガイド … 21
22. AGENTS.mdとカスタム・ルールの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q. 出力標準化ルールなど、プロジェクトで常に適用するルールはどちらに書く？ 1. AGENTS.md: 個別タスク全てに共通する前提知識をBobに伝える 2. カスタム・ルール: ルールをトピックや目的別のファイルに分割して格納する © 2026 IBM Corporation 22
23. AGENTS.mdとカスタム・ルールの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q. 出力標準化ルールなど、プロジェクトで常に適用するルールはどちらに書く？ A. 基本的にはカスタム・ルールに書くのがおすすめ！ • メリット1: 人間がルールを管理しやすい • メリット2: 短いファイルにすることでBobが混乱しづらい • 例外: 短いかつ不変の場合 → AGENTS.md でもOK © 2026 IBM Corporation 23
24. 機能の分類 続いて「用途に応じて指示を出すために使う機能」として カスタム・モード、スキルの特徴や使い分けを解説します。 全体に適用する情報やルールを伝える機能 ① AGENTS.md: 個別タスク全てに共通する背景情報をBobに伝える ② カスタム・ルール: ルールをトピックや目的別のファイルに分割して格納する 用途に応じて指示を出すために使う機能 ③ カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定する ④ スキル: © 2026 IBM Corporation Bobに手順書通りの処理を実行させる 24
25. ③カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定す る いつ使う？ –特定のタスクに人間とBobで議論しながら取り組みたい（例: ドキュメント生成） –Bobができることを制限したい（例: Pythonファイルの編集だけを許可する） 作成イメージ: ドキュメント生成専用モード（custom_modes.yaml） モード名: doc-writer ロール定義: あなたは日本語ドキュメントの作成者です。 使用するタイミング: 日本語のMarkdownドキュメントの 作成、編集に使用します。 追加指示: 出典資料が提供されていない場合は、 作業開始前にユーザーへ確認する。 使用可能なツール: read, edit, skill ※こちらは記述内容のイメージです。実際の文法とは異なります。 © 2026 IBM Corporation ←役割の指示 ←いつ使うモードか ←追加の動作ガイドラインやルール 使い方 通常のモードと同様に モード選択メニューから適用 25
26. ③カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定す カスタム・モードの作成方法は3種類です。 る 簡単に作成できる機能があらかじめ用意されています。 作り方 おすすめ！ チャットに以下のいずれかを入力してBobと作成 • /create-mode （= モード作成スキルの呼び出し） • 「カスタム・モードを作成したい」と指示 設定画面から作成 Bob設定から「モード」を開く > +ボタンを押す → 右図のような作成パネルが表示される → ガイドに沿って必要事項を入力 設定ファイルを編集して作成 公式ドキュメントを参照し、 .bob/custom_modes.yaml に必要事項を 入力する © 2026 IBM Corporation 26
27. ③カスタム・モード: Bobに担わせる役割や専門性、振る舞いを設定す ディレクトリー/ファイル構成のイメージは以下のとおりです。 る カスタム・モードはモード別のルールを指定することでより精度の高い出力が可能になります。 Bobの設定ディレクトリー（.bob/） モード定義ファイル (custom_modes.yaml) • モード1 • モード名 • ロール定義 • 使用するタイミング • 利用可能なツール ︙ • モード2 • モード3 ︙ © 2026 IBM Corporation モード別ルールディレクトリー (rules-<モード名>/) <ファイル名>.md <ファイル名>.md ルール ドキュメント … … 27
28. 補足: カスタム・モードを使いこなすために カスタム・モードを使うときに直面する2つの疑問を解消しましょう Q1. 「使用するタイミング」ってなんのために書くの？ A1. Bobがタスクに合わせてモードを選定するときに参照される Q2. 「利用可能なツール」とは？ A2. Bobができる10個のアクションのこと ツール名 できること ツール名 できること read ファイルとディレクトリーの読み取り workflow 事前定義されたワークフローの起動 edit ファイルの変更（fileRegexで対象の制限可） todo タスクのTODOリストの更新 execute ターミナル・コマンドの実行 subtask サブタスクの作成 mcp MCPサーバーへのアクセス subagent サブエージェントの生成 skill スキルのロード（読み込み・起動） mode 別のモードへ切り替え © 2026 IBM Corporation 28
29. プロンプトとカスタム・モードの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q. 「役割（ロール）」はプロンプトでも指定できるよね？使い分けの基準は？ – プロンプト: Bobにユーザーが入力する指示 – カスタム・モード: © 2026 IBM Corporation Bobに担わせる役割や専門性、振る舞いを設定する 29
30. プロンプトとカスタム・モードの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q. 「役割（ロール）」はプロンプトでも指定できるよね？使い分けの基準は？ A. その役割を一言で述べられない場合はカスタム・モードに書くのがおすすめ！ • メリット: 役割に対してルールや参照ファイルを指定できる → プロンプトで書くと長くなりがちな情報を管理しやすくなる © 2026 IBM Corporation 30
31. ④ スキル: Bobに手順書通りの処理を実行させる いつ使う？ –手順書を厳守した処理をさせたい（例: チェックリストに基づくコードレビュー） –同じ処理や指示を使いまわしたい 作成イメージ: チェックリストに基づくコードレビュースキル（SKILL.md） --name: code-review description:チェックリストに従ってコードレビューする --1. 前回のコミットと比較して変更があるファイルを探す 2. 各ファイルについてcheck-list.mdに従ってレビュー 3. output-format.mdに従ってレビュー結果を出力 © 2026 IBM Corporation ※手順の書き方は簡略化しています。 ←スキル名 ←スキルの説明 ←手順と参照するファイルの指定 使い方 • /スキル名 で明示的に呼び出す • Bobがタスクに応じて自動で呼び出す 31
32. ④ スキル: Bobに手順書通りの処理を実行させる スキルの作成方法はカスタム・モードと同じく3種類です。 簡単に作成できる機能があらかじめ用意されています。 作り方 おすすめ！ チャットに以下のいずれかを入力してBobと作成 • /create-skill （= スキル作成スキルの呼び出し） • 「スキルを作成したい」と指示 設定画面から作成 Bob設定から「スキル」を開く > +ボタンを押す → 右図のような作成パネルが表示される → ガイドに沿って必要事項を入力 設定ファイルを編集して作成 公式ドキュメントを参考に、 .bob/<スキル名>/SKILL.md に必要事項を 入力する © 2026 IBM Corporation 32
33. ④ スキル: Bobに手順書通りの処理を実行させる ディレクトリー/ファイル構成のイメージは以下のとおりです。 1つのファイルに1つのスキルを定義します。SKILL.mdは必須、他ファイルの作成は任意です。 スキル定義ディレクトリー (.bob/skills/) スキル別ディレクトリー (<スキル名>/) SKILL.md <ファイル名>.md <ファイル名>.md 手順 チェックリスト ドキュメント © 2026 IBM Corporation … … 33
34. プロンプトとスキルの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q.プロンプトでも手順は指示できるよね？使い分けの基準は？ – プロンプト: Bobにユーザーが入力する指示 – スキル: Bobに手順書通りの処理を実行させる © 2026 IBM Corporation 34
35. プロンプトとスキルの使い分け よく聞かれる質問を例に使い分けを考えてみましょう。 Q.プロンプトでも手順は指示できるよね？使い分けの基準は？ A. チェックリストやドキュメントなどを参照する場合はスキルの活用がおすすめ！ • メリット: ファイルが一箇所にまとまるため人間が管理しやすい © 2026 IBM Corporation 35
36. 目次 1. ルール・カスタム機能の概要 2. 各機能の紹介・使い分け解説 ① AGENTS.md ② カスタム・ルール ③ カスタム・モード ④ スキル 3. まとめ © 2026 IBM Corporation 36
37. まとめ 本資料では以下の4つの機能とその使い分けについてご紹介しました。 全体に適用する情報やルールを記述する機能 ①AGENTS.md: ②カスタム・ルール: 個別タスク全てに共通する前提知識をBobに伝える ルールをトピックや目的別のファイルに分割して格納する 用途に応じて指示を出すために使う機能 ③カスタム・モード: ④スキル: Bobに担わせる役割や専門性、振る舞いを設定する Bobに手順書通りの処理を実行させる 使い分けのキーワード:「Bobにとってのわかりやすさ」「人間の管理しやすさ」 © 2026 IBM Corporation 37
38. 4つの機能を用いて課題を解決 ここまで学んだ4つの機能を活用することで、本資料の冒頭で提示した課題を克服することができます 課題1:タスク間で共通の背景情報を毎回書くのは非効率 → AGENTS.mdに記述することでチャット開始時に自動で読み込まれるので、 背景を知ってる前提で指示が出せる 課題2: 細かいルールを書くとプロンプトが長大になってしまう → プロジェクト全体に共通するルールはカスタム・ルールに記述することで チャット開始時に自動で読み込まれる → 特定のタスクについてのルールは手順と共にスキルにまとめることで コマンド一つで呼び出せる 課題3: 役割設定を複数のタスクで統一したい → カスタム・モードを作成することでモード選択から呼び出すだけで使いまわせる © 2026 IBM Corporation 38
39. （再掲）本資料のゴール 4つの機能の特徴や使い分けを学ぶ タスクや状況に合わせて機能を選択できるようになる 達成できましたか？ © 2026 IBM Corporation 39
40. 参考情報 本資料でご紹介した機能の詳細は公式ドキュメントにてご確認ください。 公式ドキュメント トップページ: https://bob.ibm.com/ja/docs/ide AGENTS.md: https://bob.ibm.com/ja/docs/ide/configuration/rules#agentsmdファイルの使用 カスタム・ルール: https://bob.ibm.com/ja/docs/ide/configuration/rules カスタム・モード: https://bob.ibm.com/ja/docs/ide/configuration/custom-modes スキル: https://bob.ibm.com/ja/docs/ide/features/skills 冒頭でご紹介したプロンプト・コンテキストのコツについてのウェビナー タイトル: その指示、Bobにしっかり伝わってる？ 初心者でも即実践できるプロンプト/コンテキスト設計のコツ 資料: https://speakerdeck.com/muehara/kontekisuto-sekkei-no-kotsu リプレイ: https://video.ibm.com/recorded/134996351 © 2026 IBM Corporation 40