チュートリアル

Bobの動作を標準化する

プロジェクトレベルのルールファイルを使用してチーム全体でBobの動作を標準化し、Bobにコードを文書化し、以前のアクションを記憶するように指示します。

Bobのルールは、すべてのBobの会話に適用される指示を定義するプレーンテキストファイルです。Bobはルールをプロジェクト内の指定されたフォルダーまたはグローバルユーザーレベルのファイルとして保存し、すべてのモードにわたってすべての会話に各ルールファイルの内容を自動的に注入します。ルールの注入により、チームや個々の開発者は、すべてのプロンプトで指示を繰り返すことなく、コーディング標準、コミュニケーションの好み、ワークフローの制約を適用できます。

galaxium-travels/.bobのプロジェクトレベルのルールはコードと一緒にバージョン管理されます。これは次のことを意味します:

  • ルールは、リポジトリをクローンするすべてのチームメンバーに自動的に伝播されます。
  • ルールへの変更は、通常のコードレビュープロセスを経ます。
  • ルールの履歴はgitで追跡されます。

このチュートリアルでは、.bobディレクトリにルールファイルを追加することで、Bobに簡潔に話し、コードを文書化し、以前のアクションを記憶するように指示します。これらのファイルをバージョン管理に含めるため、Bobはチーム全体でそれらを適用します。

前提条件

このチュートリアルを完了するには、以下が必要です:

  • まだお持ちでない場合は、Galaxium Travelsのデモコードをクローンしてください。クローンコマンドは、チュートリアルで使用するコードを含むbob-learning-path-branchもチェックアウトします。
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • Galaxium Travelsのデモコードを開いたBob IDE
  • .bobフォルダーを作成するためにプロジェクトを開始するチュートリアルを完了してください。
  • 必須ではありませんが、Bobのインターフェースと機能に慣れるためにクイックスタートチュートリアルを実行することを検討してください。
  • PythonまたはPython 3。Pythonは公式ウェブサイトからダウンロードできます。

カスタムBobルールファイルを作成する

Bobの/initコマンドは、各Bobモードのためのエージェント.mdファイルを含む.bobフォルダーを作成し、各モードでのBobの動作を指示します。rulesフォルダーに新しいファイルを追加することで、独自のカスタムルールを作成します。Bobはルールファイルの内容を読み取るため、追加した指示はBobとのすべてのインタラクションに適用されます。

ルールフォルダーを作成する

.bobrulesフォルダーがまだ存在しない場合は、作成してください。

ルールファイルを作成する

galaxium-travels/.bob/rules/basic_rules.mdというファイルを作成します。

プロジェクトに作成された.bob/rules/basic_rules.mdファイル

カスタムBobルールを作成する

basic_rules.mdファイルで、次のテキストを追加してカスタムルールを作成します:

ドキュメント標準ルールを追加する

Always include concise JSDoc strings for every public function.

ドキュメント標準ルールは、タスクに関係なく、Bobがパブリック関数を書いたり変更したりするたびに一貫したドキュメントを生成することを保証します。

コミュニケーションスタイルルールを追加する

Be very concise in your wording.

コミュニケーションスタイルルールは、Bobが応答やコメントをどのように表現するかを制御します。これは、詳細な説明よりも簡潔で直接的な出力を好むチームに役立ちます。

内部モノローグルールを追加する

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

内部モノローグは、すべての会話を通じてBobが行ったすべてのことの永続的なログを生成します。

内部モノローグの利点には以下が含まれます:

  • 監査証跡:Bobがどのような変更をいつ行ったかの記録。
  • セッション間の継続性:Bobは将来の会話で内部モノローグフォルダーを参照して、以前の作業を理解できます。
  • チームの透明性:共有リポジトリでは、モノローグは異なるチームメンバーがBobで何をしたかを示します。

すべてのルールを追加すると、basic_rules.mdファイルは次のようになります:

3つのカスタムルールがすべて追加されたbasic_rules.mdファイル

ルールをテストする

エージェンティックチャットサイドバーを開き、コードモードに切り替えて、次のプロンプトを実行してBobにREADME.mdを編集させます。Bobは、より良いトラブルシューティングでの強化、完全な見直し、または不正確さの修正などの提案をする場合があります。READMEのビジョンに最も適した提案を選択できます。

Update the readme

BobはREADME.mdを更新し、internal-monologueというフォルダーを作成し、READMEに加えた更新を示すファイルを作成します。

BobがREADME.mdを更新し、内部モノローグファイルを作成する

次のステップ

このチュートリアルでは、Bobルールがすべての会話とモードに適用される永続的な指示を定義できることを学びました。プロジェクトレベルのルールはコードと一緒にバージョン管理されるため、チームは自動的に同じ標準を共有します。内部モノローグパターンは、すべてのセッションにわたるBobのアクションの監査証跡を提供します。

Bob機能を追加するに進んで、カスタマイズされた指示と特定のツールアクセスを持つ専門的なペルソナを定義するカスタムモードの作成について学びましょう。

このトピックはいかがですか?