メインコンテンツへスキップ
Droidは明確で具体的な指示で最高のパフォーマンスを発揮します。熟練したエンジニアとペアプログラミングを行うように、コミュニケーションの質が結果に直接影響します。このガイドでは、より少ない反復でより良い結果を得るための実践的なパターンを紹介します。

基本原則

求めることを明確に示す。「認証システムを改善できますか?」ではなく、「middleware/rateLimit.tsのパターンに従って、指数バックオフを用いたログイン試行のレート制限を追加してください」と試してみてください。Droidは目標を明確に述べられた時に最高のパフォーマンスを発揮します。 **最初にコンテキストを提供する。**エラーメッセージ、ファイルパス、スクリーンショット、または関連ドキュメントを含めてください。Jiraチケットやデザインドキュメントから何かを実装している場合は、リンクを貼り付けてください。droidはFactoryのダッシュボードで統合したプラットフォームから自動的にコンテキストを読み取ることができます。 **アプローチを選択する。**複雑な機能については、自動プランニングのためのSpecification Modeの使用を検討してください。日常的なタスクについては、droidは直接進めることができますが、それでもレビューのためにすべての変更を表示します。詳細なガイダンスについてはPlanning versus doingセクションを参照してください。 **成功を定義する。**特定のテストを実行する、サービスがクリーンに開始することを確認する、またはUIがモックアップと一致することを確認するなど、作業が完了したことを確認する方法をdroidに伝えてください。

効果的なプロンプトの書き方

最高のプロンプトは直接的で関連する詳細を含んでいます:
これらの例に注目してください:
  • 最初の文で目標を明確に述べる
  • 既知の場合は特定のファイルやコマンドを含める
  • 役立つ可能性のある関連コードについて言及する
  • 結果をテストする方法を説明する
  • 会話的だが直接的に保つ

プランニング対実行

複雑な機能については、実装前に自動的にプランニングとレビューを提供するSpecification Modeを使用してください:
簡単なタスクについては、droidは承認のために変更を表示しながら直接進めることができます:

コンテキストの管理

AGENTS.mdファイルを使用してビルドコマンド、テスト手順、コーディング標準を文書化してください。Droidはこれらを自動的に読み取るため、プロジェクトの規約を繰り返す必要がありません。詳細なセットアップ手順についてはAGENTS.md guideを参照してください。 特定のファイルを言及するコードがどこにあるか分かっている場合。ファイルを直接参照するために@filenameを使用するか、プロンプトにファイルパスを含めてください。これによりdroidの注意を集中させ、時間を節約できます。 変更の境界を設定する。「authディレクトリ内のファイルのみを変更する」または「パブリックAPIを変更しない」といった指示は、スコープを制限するのに役立ちます。 外部リソースを参照するチケット、ドキュメント、デザイン、または仕様へのURLを含めることで。Droidはこの情報を取得して使用できます。

一般的なワークフロー

コードの理解:
機能の実装:
バグの修正:
コードレビュー:
リファクタリング:

エンタープライズ統合

チケットやドキュメントへのリンクを貼り付けてチームのツールを参照してください:
Factoryのダッシュボードでこれらのプラットフォームを統合している場合、droidはJira、Notion、Slack、その他のソースから自動的にコンテキストを読み取ることができます。追加のツール接続については、droidはMCP統合もサポートしています。 セキュリティに敏感な作業については:

セッション管理

コンテキストが乱雑になった場合や関連しないタスクに切り替える場合は、新しい会話を開始してください。失敗した試行から蓄積されたノイズよりも、新鮮なコンテキストの方が多くの場合うまく機能します。 大きなプロジェクトの場合は、作業をフェーズに分けてください:
その後のフォローアップで:

高度なテクニック

テスト駆動開発:
プラン駆動開発:

良いプロンプトの例

こちらはうまく機能する実際の例です:

うまく機能しないもの

曖昧なリクエストは避けてください:
  • 「アプリを良くして」→ 範囲が広すぎる
  • 「データベースを修正して」→ 十分に具体的でない
  • 「フロントエンドを手伝ってもらえますか?」→ 目標が不明確
droidに推測させないでください:
  • ファイルパスを知っている場合は、それを含める
  • 実行するコマンドを知っている場合は、それについて言及する
  • 関連するコードがある場合は、それを指摘する

より良い結果を得る

droidを有能なチームメイトとして扱ってください。タスクに取り組む同僚に提供するのと同じコンテキストとガイダンスを提供してください。品質基準とビジネス要件について具体的に述べてください。 droidは時間をかけてあなたの組織のパターンを学習することを覚えておいてください。コードベース内でより一貫して使用するほど、あなたの規約に従うのが上手になります。 最も重要なことは、droidが提案する変更をレビューすることです。承認ワークフローを通じて完全な制御を維持しているため、変更を理解し、将来のより良い結果のためにフィードバックを提供する時間を取ってください。 これらのパターンを試す準備はできましたか?Quickstartに戻って、あなた自身のコードで練習してください。