ベスト・プラクティス
Bobを最大限に活用するために、これらのガイドラインに従ってください。
モードを理解して使用する
Bobのモードは、その動作を形作るタスク固有のペルソナです。適切なモードを選択することで、最良の結果を得ることができます。
組み込みモード
Bobには、それぞれ特定の目的のために設計された3つの組み込みモードがあります:
| モード | 目的 | 使用するタイミング |
|---|---|---|
| Agent | コードの記述と変更 | 機能の実装、バグの修正、またはコードの改善を行う場合 |
| Plan | 計画と設計 | 実装前にアーキテクチャーを計画したり、技術仕様を作成したりする必要がある場合 |
| Ask | 情報の取得 | ファイルを変更せずに説明や情報が必要な場合 |
モード選択戦略
最も効果的なワークフローのために:
Planモードから始める 新しいプロジェクトや複雑な機能の場合、コードを書く前に詳細な実装計画を作成します。 計画を注意深く読んで、目標と一致していることを確認してください。
Agentモードに切り替える 実装の準備ができたら、ほとんどの日常的な開発タスクに使用します。
Askモードを使用する ファイルを変更せずに説明や情報が必要な場合。
モードの詳細と切り替え方法については、モードを参照してください。
カスタム・モード
特定のタスクやワークフロー用に専門化されたモードを作成できます:
- セキュリティー・レビューやドキュメント作成などの専門的なタスク用のモードを作成します。
- 特定のツール・アクセス権限とロール定義でカスタム・モードを構成します。
- ワークフローを標準化するためにチームとモードを共有します。
カスタム・モードの作成と構成の詳細については、カスタム・モードのドキュメントを参照してください。
ワークフローの最適化
コーディング前に計画する
複雑なプロジェクトや機能は常にPlanモードで開始して:
- 詳細な実装計画を生成します。
- 複雑な問題を管理可能なステップに分解します。
- 発生する前に潜在的な課題を特定します。
- 実装のロードマップを作成します。
このアプローチは破壊的な変更を防ぎ、開発の明確な方向性を提供します。
Rollbackを効果的に使用する
Rollbackはgitを使用してワークスペース・ファイルをタスク内の任意の以前のポイントの状態に復元し、以下を可能にします:
- AI提案の変更を安全に実験します。
- 望ましくない変更から簡単に回復します。
- さまざまな実装アプローチを比較します。
Bobが低品質の作業を生成し始めた場合は、Rollbackを使用してファイルを以前の状態に戻します。これは、新しい指示で誤った出力を修正しようとするよりも効果的です。
作業を以前の状態に復元するには:
ロールバックしたいプロンプトの上にカーソルを合わせます。
Rollbackボタンをクリックして、その時点のファイルを復元します。
使用状況を監視してコストを最適化
BobalyticsでBobcoinの消費と使用パターンを追跡して、ワークフローを最適化し、コストを効果的に管理します。
バージョン管理との統合
変更をバージョン管理システムに定期的にコミットしてプッシュします:
- 明確なメッセージで頻繁に小さなコミットを作成します。
- 変更をリモート・リポジトリーに定期的にプッシュします。
- 実験的な機能にはブランチを使用します。
Gitは、偶発的で永続的なコードの削除を防ぐための重要なセーフティー・ネットを提供します。
コミュニケーション戦略
効果的なプロンプトを書く
プロンプトの品質は、Bobの応答の品質に直接影響します:
- 具体的で明確に: 曖昧なプロンプトは曖昧な出力につながります。Bobが何をすべきで何をすべきでないかを詳細に説明してください。
- 例を提供: 可能な限り、望ましい出力形式やスタイルの例を含めます。
コンテキスト・メンションを使用する
コンテキスト・メンションを使用すると、Bobとの会話でプロジェクトの特定の要素を直接参照できます:
@/path/to/file.jsを使用して特定のファイル・コンテンツを含めます。@/path/to/folderを使用してディレクトリー内のすべてのファイルを含めます。@problemsを使用してBob Findingsパネルからの診断を含めます。@terminalを使用して最新のターミナル出力を含めます。- テキストをハイライトして⌘ + Lのキーボード・ショートカットを使用してチャットに追加します。
.docx、.pdf、.xlsxファイルをコンテンツを手動で抽出せずに直接コンテキストとして添付します。
このアプローチは、コードをコピー＆ペーストしたり、ファイルの場所を説明したりするよりも効率的です。
コンテキスト・メンションの詳細については、コンテキスト・メンションのドキュメントを参照してください。
コンテキスト・ウィンドウの管理
Bobのコンテキスト・ウィンドウは270,000トークンで、会話履歴、ファイル・コンテンツ、ツール出力が含まれます。効果的に使用するために:
- 特定の目標を持つ新しいタスクを定期的に開始します。
- Bobにコードベース全体を一度に与えることは避けてください。
- 直接的なファイル参照を使用して、ターゲットを絞ったコンテキストを提供します。
- 複雑なタスクを小さく焦点を絞ったサブタスクに分割します。
セキュリティーとコントロール
自動承認設定を構成する
Bobでは、どのアクションに承認が必要かを制御できます:
- 手動承認: Bobが実行する各アクションを確認して承認します（最も安全な設定）。
- 自動承認: Bobに中断なく特定のタスクを実行する機能を付与します。
- ハイブリッド・アプローチ: リスクの低いアクションを自動承認し、リスクの高いタスクには確認を要求します。
- 編集可能なコマンド: Bobが提案するコマンドを実行前に編集でき、キャンセルや言い直しをせずに正確なコントロールが可能です。
- 自動承認コマンド: Bobが毎回承認を求めずに実行できる信頼済みコマンドのリストを定義します。
- タスク・レベルの承認: グローバル設定とは独立して、タスクごとにツール・グループの承認を設定します。
快適さのレベルとプロジェクトの機密性に基づいてこれらの設定を構成してください。
自動承認設定の詳細については、アクションの自動承認のドキュメントを参照してください。
.bobignoreを使用する
.bobignoreファイルを使用すると、Bobがアクセスまたは変更してはならないファイルとディレクトリーを指定できます:
プロジェクト・ルートに.bobignoreファイルを作成します。
機密ファイル、ビルド・アーティファクト、大きなアセットのパターンを追加します。
.gitignoreと同じ構文を使用します。
これにより、機密情報を保護し、生成されたファイルへの偶発的な変更を防ぐことができます。
ファイル・アクセスの制御の詳細については、.bobignoreの使用のドキュメントを参照してください。
セキュリティー・ガイドラインの詳細については、セキュリティー・ガイドラインを参照してください。
ルールを設定する
Bobでは、Bobがタスクを実行する方法を制御するルールを設定できます:
.bobディレクトリーでグローバルまたはプロジェクトごとにルールを定義します。.bob/rules-{mode-slug}/ディレクトリーでモード固有のルールを作成します。- ルールを使用して、コーディング標準、ドキュメント要件、またはその他のワークフロー制約を強制します。
カスタム・モードとルールの詳細については、カスタム・モードのドキュメントを参照してください。