Zenn
🐕

Devin AI 公式活用ガイド（1/3）：いつDevinを使うべきか【Essential Guidelines翻訳】

に公開
AI
開発効率化
Devin
Vibe Coding
essentialguideline
tech

Devin AI を効果的に活用するための公式ドキュメントには、「Essential Guidelines」という重要な指針がまとめられています。この「Essential Guidelines」は 3 つのパートで構成されており、本記事はその最初のパートである When to Use Devin の内容を翻訳したものです。

「Essential Guidelines」(原文)の他のパートはこちらです。

翻訳記事については以下で公開しています：

まとめ(TLDR):
Devin をジュニアエンジニアのように扱ってください。十分かつ明確な指示があればジュニアエンジニアやインターンが解決できるようなタスクを Devin に割り当てましょう。人間の同僚に指示するのと同じレベルの詳細さで Devin に指示することを忘れないでください。

ベストプラクティス

複数の Devin を並行して作業させることで 1 日を始めましょう:

  • TODO をよく考え、インターン（Devin）のチームが手伝える小さなタスクを切り出します。
  • 昼休み頃にレビュー待ちのドラフト PR に戻ります。

簡単な修正のために Slack スレッドで Devin をタグ付けしましょう:

  • Devin は 30 分で終わるものの、数週間にわたって大きなバックログに残り続けるようなタスクに適しています。

簡単に検証可能なタスクに集中しましょう:

  • 理想的には、CI がパスすることを確認したり、自動デプロイメントをテストしたりするのと同じくらい簡単であるべきです。タスクが適切に完了したように見えても、何か他のことが起こっている可能性がある曖昧なタスクは避けましょう。

小さく始めましょう:

  • 使い始めは、Devin の最適なユースケースを見つけるために、多くの小さな実行を開始してください。
  • 1 回の実行にあまり多くの ACU（>10）を費やさないようにしてください。Devin のパフォーマンスは長時間のセッションでは低下します。

Devin のタスク評価

タスクが Devin に適しているかどうかを判断する際に最初に自問すべきことは、「十分な時間とコンテキストが与えられれば、ジュニアエンジニアがこれを解決できるだろうか？」ということです。

タスク実行前のチェックリスト

タスクの複雑さ

  • どのような判断や難しい決定が必要かを検討します。
  • インターンが遭遇する可能性のある潜在的な失敗ルートを特定します。
  • 高度なドメイン知識が必要なタスクについては、さらに細分化するか、関連するコンテキストを提供します。

タスクの定義と範囲

  • 優れたタスクには、明確な開始点と終了点、そして成功基準（例：テストに合格する、既存のパターンに一致する）があります。

利用可能な参照資料

  • Devin が従うべき例やパターンはありますか？
  • コードベースやドキュメントからプロトタイプ、部分的なコード、または既存のパターンを提供できますか？
  • Devin が見るべきリンクやファイル名を提供することは非常に役立ちます。

成功の検証

  • テストスイート、lint チェック、またはコンパイルステップがあるタスクは、より良い結果をもたらします。
  • 主観的な基準を持つタスクはより厄介になる可能性があります。

レビューの労力

  • 理想的には、CI がパスすることを確認するか、自動デプロイメントを迅速にテストできるだけで済みます。

タスクのサイズ

  • 大きなタスクの場合は、サブタスクまたは複数のセッションに分割することを検討してください。
  • 大きなリクエストをより小さく管理しやすいチャンクに分割することで、Devin が軌道に乗った状態を維持しやすくなります。

タスク実行後のレビュー

セッション時間の監視

  • Devin が繰り返しセッション使用量の制限に遭遇する場合、割り当てられたタスクが複雑すぎる可能性があります。
  • より詳細な指示とガードレールを提供する必要があるかもしれません。
  • Devin がどこに時間を費やしているかを調査することを検討してください。
  • Devin が開発環境で苦労している場合は、ワークスペースのセットアップを再確認してください。
  • Devin を軌道に戻そうとするよりも、自分でタスクを完了する方が速い場合があります。

Devin の失敗から学ぶ

  • 将来のセッションでは、Devin が以前の障害を乗り越えるのを助けるために、より多くのコンテキストや指示を提供してください。
  • Devin が以前のセッションから学んだことを記憶できるように、ナレッジを追加または承認することを検討してください。

この記事は、When to Use Devin を翻訳したものです。

Discussion