メインコンテンツへスキップ

Knowledge 101

Knowledge は、Devin がコードベース上で作業する際に役立つ、タスクレベルではなくコードベースレベルのコンテキストを共有するための最も有効な手段です。Devin の Knowledge に含める情報の例としては、コーディング規約やベストプラクティス、デプロイワークフロー、PR の命名規則、テストフロー、独自ツールとの連携方法などがあります。 Knowledge に関する補足事項:
  • Devin は、接続されたリポジトリに存在する README、ファイル構造、ファイル内容に基づいて、リポジトリ用の Knowledge を自動生成します。Devin にそのリポジトリへのアクセス権を付与しない場合、そのリポジトリに関連する Knowledge は生成されない点に注意してください。
  • Knowledge は、あなたが設定した Trigger に基づいて取得されます。Trigger が具体的であればあるほど(例: Knowledge が適用されるファイル、リポジトリ、タスクの種類など)、取得精度は高くなります。詳細はこちらをご覧ください。
  • Devin は、セッション内でどの Knowledge を使用したかを教えてくれます。セッションチャット内の「Accessed Knowledge」で確認できます。
  • Devin は、.rules.mdc.cursorrules.windsurf など、コードベース内の専用ファイルに基づいて Knowledge を自動的に取得および更新します。.md のような、より一般的なファイルタイプは Devin が自動取得しない点に注意してください。

Knowledge オンボーディングのベストプラクティス

Devin の習熟度を高めるために、最初に少し時間をかけて準備しておくと効果的です。新しいメンバーを迎えるときと同様に、エンジニアリングチームが利用しているコードベースやワークフローに関する関連情報やコンテキストを共有することで、Devin をより有効に活用できるようになります。ここでは、最初に Devin の Knowledge をセットアップするときに推奨される手順を紹介します。
  1. 自動生成された Knowledge を確認し、(a) 網羅性 と (b) 正確性 を検証します。
  2. Devin に、セッションで作業している間は常にその Knowledge ノートを参照させたい場合は、必ずすべてのリポジトリにピン留めしてください。特定のコンテキストでのみ有用な情報であれば、特定のリポジトリにだけピン留めすることもできます。Knowledge がピン留めされていない場合は、トリガーされたときのみ使用されるため、「Trigger Description」を明確に記述してください。
  3. コードベース内に集中管理された専用ドキュメントファイルがない場合は、専用のファイル拡張子を持つファイルを用意することを強く推奨します。
詳細については、Knowledge プロダクトガイドを参照してください。