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

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.windsurfCLAUDE.mdAGENTS.md など、コードベース内の専用ファイルに基づいて Knowledge を自動的に取得および更新します。.md のような、より一般的なファイルタイプは Devin が自動取得しない点に注意してください。

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

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