Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

This article is a Private article. Only a writer and users who know the URL can access it.
Please change open range to public in publish setting if you want to share this article with other users.

@yanagih(Hideo Yanagi)

IBM Bobのベストプラクティス完全ガイド

0
Posted at

IBM Bobのベストプラクティス完全ガイド

はじめに

こんにちは！

IBM Bobを使い始めて、「これは便利だ！」と感じている方も多いのではないでしょうか。でも、「もっと効率的に使えないかな？」「どのモードを使えばいいの？」と悩むこともありますよね:thinking:

この記事では、公式ドキュメントをベースに、私が実際に使ってみて「これは知っておくべき！」と感じたBobのベストプラクティスを紹介していきます。

それでは、早速見ていきましょう:bangbang:

目次

  1. モードを理解して使用する
  2. ワークフローの最適化
  3. バージョン管理との統合
  4. コミュニケーション戦略
  5. セキュリティとコントロール

モードを理解して使用する

Bobには、タスクの種類に応じて最適化された複数のモードがあるんです。適切なモードを選ぶことで、作業効率が大きく変わってきます:rocket:

組み込みモード一覧

モード 用途 主な使用場面
Code コードの記述と変更 機能の実装、バグの修正、またはコードの改善を行う場合
Advanced 複雑な開発タスク MCPやブラウザ機能を含むすべてのツールへの完全なアクセスが必要な場合
Plan 計画と設計 実装前にアーキテクチャを設計したり、技術仕様を作成したりする必要がある場合
Ask 情報の取得 ファイルを変更せずに説明や情報が必要な場合
Orchestrator 複数ステップ・プロジェクトの調整 さまざまな専門的に分かれる調整が必要な複雑なプロジェクトの場合

モード選択戦略

効果的なワークフローのために、こんな順序でモードを使うのがおすすめです:point_down:

私が実践している使い分け：

  1. Planモードから始める - 新しいプロジェクトや複雑な機能の場合、いきなりコードを書かずに、まず計画を立てます。これ、本当に大事です:exclamation:

  2. Codeモードに切り替える - 計画ができたら、実装に移ります。日常的な開発作業はほとんどこのモードですね。

  3. Askモードを使用する - 「このコードって何してるの？」みたいな、ちょっとした質問の時に便利です。

  4. Advancedモードに切り替える - ブラウザ自動化とか、ちょっと特殊なことをしたい時に使います。

モードの詳細と切り替え方法については、モードを参照してください。

カスタム・モード

実は、自分専用のモードも作れるんです:sparkles:

  • セキュリティー・レビュー専用のモードとか
  • ドキュメント作成専用のモードとか
  • チームで共有できるモードとか

使い方に慣れてきたら、ぜひ試してみてください！

ワークフローの最適化

コーディング前に計画する

これ、最初は面倒に感じるかもしれませんが、やってみると本当に効率的なんです:bulb:

複雑なプロジェクトや機能は、必ずPlanモードで開始するようにしています：

  • 詳細な実装計画を生成
  • 複雑な問題を管理可能なステップに分割
  • 「あ、これ問題になりそう」という課題を事前に発見
  • 実装のロードマップを作成

いきなりコードを書き始めると、後で「あれ？これどうするんだっけ？」ってなりがちです。計画、大事:exclamation:

チェックポイントを効果的に使用する

チェックポイント機能、これがまた便利なんです:thumbsup:

Bobタスク中にワークスペース・ファイルを自動的にバージョン管理してくれるので：

  • 「さっきのアプローチの方が良かったかも」って時に比較できる
  • 作業の履歴を追跡できる
  • 実験的な変更も安心して試せる
  • チーム内で「今ここまで進んでます」って共有しやすい

Bobが「なんか変な出力してるな...」って感じたら、無理に修正させようとせず、チェックポイントから復元するのが早いです。これ、経験談です:sweat_smile:

作業を以前の状態に復元する手順

  1. チャット・インターフェースで上にスクロールして、復元したいチェックポイントを見つけます
  2. 「チェックポイントを復元」ボタンをクリック
  3. 「ファイルとタスクを復元」をクリック
  4. 「確認」をクリック

簡単でしょ:relaxed:

バージョン管理との統合

Gitとの連携、これは絶対にやっておくべきです:bangbang:

私が実践している方法：

  • 定期的なコミット: 「キリがいいところで」じゃなくて、こまめにコミットします
  • ブランチ戦略: 実験的な機能は必ず別ブランチで。これ、鉄則です
  • セーフティネット: 「うっかり消しちゃった:scream:」を防げます

Gitは、Bobと組み合わせることで、さらに強力なセーフティネットになります。

コミュニケーション戦略

効果的なプロンプトを書く

プロンプトの書き方で、Bobの応答の質が全然変わってくるんです:pencil:

具体的で明確に

曖昧な指示だと、曖昧な結果が返ってきます。当たり前ですよね:sweat_smile:

悪い例：

ログイン機能を追加して

良い例：

ユーザー認証機能を実装してください。以下の要件を満たす必要があります：
- メールアドレスとパスワードでのログイン
- JWT トークンを使用した認証
- パスワードは bcrypt でハッシュ化
- ログイン失敗時は適切なエラーメッセージを表示
- セッション管理機能も含める

違いは明らかですよね:exclamation:

例を提供

「こんな感じで」って例を見せると、Bobも理解しやすいです。

「プロンプトを強化」機能を使用

「強化」ボタン、これ便利です:sparkles: クリックするだけで、Bobが自動的にコンテキストを追加してくれます。

コンテキスト・メンションを使用する

これ、知ってると知らないとで、作業効率が全然違います:rocket:

メンション 説明 使用例
@/path/to/file.js 特定のファイル・コンテンツを含める @src/auth.js のログイン関数を修正して
@/path/to/folder ディレクトリ内のすべてのファイルを含める @src/components/ のすべてのコンポーネントをレビューして
@problems Bob Findingsパネルからの診断を含める @problems のエラーを修正して
@terminal 最新のターミナル出力を含める @terminal のエラーを解決して

キーボードショートカット：
テキストをハイライトして ⌘ + L (Mac) または Ctrl + L (Windows/Linux) を押すと、チャットに追加できます。

これ、めちゃくちゃ便利です:thumbsup:

コンテキスト・メンションの詳細については、コンテキスト・メンションのドキュメントを参照してください。

コンテキスト・ウィンドウの管理

Bobが混乱しないように、こんなことに気をつけています：

  • 新しいタスクは新しいチャットで始める
  • 「プロジェクト全部見て！」は避ける（Bobも困ります:sweat_smile:）
  • ファイル参照を使って、必要な部分だけ見せる
  • 複雑なタスクは小分けにする

セキュリティとコントロール

自動承認設定を構成する

セキュリティ、大事ですよね:lock:

  • 手動承認: 最初はこれがおすすめ。Bobが何をするか、一つ一つ確認できます

自分の使いやすさとプロジェクトの重要度に応じて設定してください。

自動承認設定の詳細については、アクションの自動承認のドキュメントを参照してください。

.bobignoreを使用する

「これは触らないで！」っていうファイルを指定できます。

.bobignore の記述例：

# 機密情報（これは絶対！）
.env
.env.local
secrets/
credentials.json

# ビルド成果物（触る必要なし）
dist/
build/
*.min.js
*.bundle.js

# 依存関係（重いし、触らない）
node_modules/
vendor/
.pnp/

# ログファイル
*.log
logs/

# データベースファイル
*.db
*.sqlite

# 大きなメディアファイル（これも重い）
*.mp4
*.mov
assets/videos/

# IDEファイル
.vscode/
.idea/
*.swp

.env ファイルは必ず .bobignore に入れましょう。これ、本当に大事です:exclamation:

ルールを設定する

チームで開発している場合、ルールを設定しておくと便利です:pencil:

ルール設定の実例：

.bob/rules-code/coding-standards.md:

# コーディング標準

## TypeScript/JavaScript
- 常に TypeScript の strict モードを使用する
- ESLint と Prettier の設定に従う
- 関数には JSDoc コメントを追加する
- async/await を使用し、Promise チェーンは避ける

## 命名規則
- 変数名: camelCase
- クラス名: PascalCase
- 定数: UPPER_SNAKE_CASE
- ファイル名: kebab-case

## テスト
- 新しい機能には必ずユニットテストを追加する
- テストカバレッジは80%以上を維持する

.bob/rules-code/security.md:

# セキュリティルール

- パスワードやAPIキーをコードに直接記述しない
- 環境変数を使用して機密情報を管理する
- ユーザー入力は必ずバリデーションする
- SQLインジェクション対策を実施する
- XSS対策を実施する

カスタム・モードとルールの詳細については、カスタム・モードのドキュメントを参照してください。

まとめ

IBM Bobを効果的に使うためのポイント、まとめるとこんな感じです:point_down:

  1. 適切なモードの選択 - タスクに応じて使い分ける
  2. 計画的なアプローチ - いきなりコードを書かない
  3. チェックポイントの活用 - 失敗を恐れず、実験できる
  4. 明確なコミュニケーション - 具体的に、詳しく伝える
  5. セキュリティの確保 - .bobignore とルール設定は必須

これらを意識するだけで、Bobとの付き合い方が変わってくると思います:sparkles:

参考リンク

おわりに

実は、この記事自体も、IBM Bobを活用して作成しました:relaxed:

最初は公式ドキュメントをベースに構造化された記事を作成したのですが、「なんか堅いな...」と感じて、私らしい文体に書き直しました。

AIに記事を書いてもらう時の注意点として：

  1. 内容の正しさを必ず自分で確認する - AIも間違えることがあります
  2. そのまま使わず、自分で整える - 自分の言葉で書き直す
  3. 自分の考えや経験を足す - これが一番大事:exclamation:

これらを意識すれば、AIを活用しながらも、自分らしい記事が書けると思います。

IBM Bobは本当に便利なツールです。この記事が、皆さんのBob活用の参考になれば嬉しいです:blush:

質問やフィードバックがあれば、コメント欄でお知らせください:wave:

このサイトにおける掲載内容はあくまで私個人の見解であり、必ずしも私の所属団体・企業における立場、戦略、意見を代表するものではありません。

0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?