AI搭載！GitHubコミットコードレビュー自動メール送信ツール - n8n ワークフロー

Markdown-formatted text:
新しいコミットに対して即時のフィードバックを必要とするソフトウェア開発チーム。
n8nを使用して自動化された品質ゲートをCI/CDパイプラインに統合したいDevOpsエンジニア。
Webhook、カスタムコード、大規模言語モデル（LLM）の組み合わせの高度な例を必要としているn8nユーザー。
単一のn8nワークフローを使用して複数のリポジトリにわたるコード品質を監視したいテクニカルリード。

手動でのコードレビューは時間がかかり、人的エラーが発生しがちです。このn8nワークフローは、AI主導のリアルタイムなコード品質フィードバックループを作成することで、この問題を解決します。開発者が監視対象のGitHubリポジトリにコードをプッシュすると、n8nトリガーが自動化を即座に起動します。ワークフローは完全なコミット詳細を取得し、整形されたコード差分をGroqを使用したインテリジェントなAIエージェントに渡します。エージェントは機能的な問題、スタイル、潜在的なセキュリティの欠陥を分析し、改善案を提案。構造化されたHTMLサマリーを返します。この一連のプロセスは様々なn8nノードによって管理され、迅速かつ一貫性のあるコードフィードバックをGmail経由でレビュー担当者の受信トレイに直接配信することで、現代のチームにとって最も有用なn8nテンプレートの1つとなります。

この強力なn8nワークフローは、Githubトリガーn8nノードから実行を開始します。このn8nトリガーは、特定のレポジトリでの「push」イベントをリッスンするように設定されています。

1. トリガーとデータ解析: プッシュが発生すると、Githubトリガーがペイロードをキャプチャします。後続のParser n8nノードが、リポジトリ名、オーナー、コミットIDなどの重要なメタデータを抽出します。


2. コミット詳細の取得: 次に、HTTPリクエストn8nノードがコミットIDを使用してGitHub APIを呼び出し、重要なパッチ/差分データを含む詳細なコミット情報を取得します。


3. HTML整形（Codeノード）: 専用のCode n8nノードが、生のコミットデータを高度にスタイル付けされたHTML出力に変換します。これには、メールクライアントでの視認性を最適化するために、コード差分（追加は緑、削除は赤）のカラーコーディングが含まれます。


4. AI分析（AIエージェントノード）: AIエージェントn8nノードが整形されたHTMLを受け取ります。厳格なシステムプロンプトにより、専門のコードレビュー担当者として機能し、機能、スタイル、セキュリティに関する懸念に焦点を当てるよう指示されます。処理にはGroqチャットモデルとSimple Memory n8nノードを利用しますが、単一パスレビューの場合はメモリはオプションです。


5. 出力の結合: Output Parser Code n8nノードが、元のコミット詳細（最初のCodeノードから）とAIエージェントによって生成された厳密なHTMLサマリーを結合します。


6. 最終通知: 完成したHTML出力をGmail n8nノード経由で指定された受信者（レビュー担当者または開発チーム）に送信し、自動化されたn8nワークフローが完了します。その後、フローはEnd Workflow n8nノードで終了します。

Markdown-formatted text:

1. n8nテンプレートのインポート: 提供されたJSONをコピーし、「新規」メニュー -> 「JSONからインポート」を使用してn8nインスタンスに貼り付けます。


2. GitHub認証情報: GitHubトリガーn8nノードとHTTPリクエストn8nノードの認証情報を設定します。


3. Groqの設定: Groqチャットモデルn8nノードをGroq APIキーで設定します。


4. Githubトリガーの設定: GitHubトリガーn8nノードでリポジトリURLとオーナー情報をカスタマイズし、監視対象プロジェクトに合わせます。GitHubリポジトリ設定で、Webhookがn8nトリガーURLを指すように正しく設定されていることを確認してください。


5. Gmailの設定: Gmail n8nノードをOAuth2認証情報で設定します。sendToパラメーターを希望するレビュー担当者のメールアドレスに更新します。


6. 有効化: n8nワークフローを保存して有効化します。これにより、すべてのプッシュイベントで自動的に実行されるようになります。

Markdown-formatted text:
Githubトリガー (n8nトリガー):
機能: 特定のGitHubリポジトリへの「push」イベント発生時にn8nワークフローを開始します。
主要設定: イベントはpushに設定されます。リポジトリの詳細は、プロジェクトに合わせて手動で更新する必要があります。
HTTPリクエスト (n8nノード):
機能: n8nトリガーデータによって提供されるコミットIDを参照する動的式を使用し、ファイルパッチを含む詳細なコミットメタデータを取得します。
主要設定: 安全なAPIアクセス用にGitHub OAuth2認証情報タイプを使用します。URLはコミットデータをリクエストするために動的に生成されます: =https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}。
Code (フォーマッターn8nノード):
機能: 生のGitHubコミットデータ（差分）を、優れたメール視覚化のために色分けされたスタイル付きHTMLに変換します。追加された行（+、緑）と削除された行（-、赤）を区別します。
主要設定: メタデータ（リポジトリ情報、作成者、メッセージ）とコード差分を構造化するために、カスタムJavaScriptロジック（formatPatchおよびrenderResponse）が含まれています。
Groqチャットモデル (n8nノード):
機能: AIエージェントのLLMバックエンドを提供し、高速なコードレビュー生成のために高速なllama-3.1-8b-instantモデルを利用します。
主要設定: Groq API認証情報が必要です。
AIエージェント (n8nノード):
機能: 中核となる知能として機能します。HTML形式のコード差分を入力として受け取り、詳細なプロンプト指示に基づいて厳密で構造化されたコードレビューを生成します。
主要設定: システムプロンプトにより、AIに関数、スタイル、セキュリティを確認させ、改善点を提案させ、最も重要なこととして、その調査結果を定義済みの2つのHTMLブロックのいずれかで返させます。
Gmail (n8nノード):
機能: 最終的に結合されたHTML出力（コミット詳細＋AIレビュー）をメール通知として送信します。
主要設定: Subjectは「Code Review」に設定されます。Messageには、Output Parser n8nノードからの最終HTML出力が使用されます。