AI 驱动的 GitHub 提交代码审查邮件发送器 - n8n 工作流

Markdown 格式文本:
需要立即获得新提交反馈的软件开发团队。
希望使用 n8n 将自动化质量门禁集成到其 CI/CD 流水线中的 DevOps 工程师。
需要结合 Webhook、自定义代码和大语言模型 (LLM) 高级用例的 n8n 用户。
寻求使用单一 n8n 工作流监控多个仓库代码质量的技术主管。

手动代码审查既耗时又容易出错。这个 n8n 工作流通过创建 AI 驱动的实时代码质量反馈循环来解决这个问题。当开发者向受监控的 GitHub 仓库推送代码时，n8n 触发器会立即激活自动化。工作流获取完整的提交详情，并将格式化后的代码差异传递给使用 Groq 的智能 AI 代理。该代理分析功能问题、代码风格、潜在的安全漏洞并提出改进建议，返回一个结构化的 HTML 总结。整个过程由各种 n8n 节点管理，确保通过 Gmail 直接将快速、一致的代码反馈发送到审查者的收件箱，使其成为现代团队最实用的 n8n 模板之一。

这个强大的 n8n 工作流由 Github Trigger n8n 节点开始执行。这个 n8n 触发器配置为监听特定仓库上的“push”事件。

1. 触发与数据解析： 当发生推送事件时，Github Trigger 捕获数据包 (payload)。随后的 Parser n8n 节点提取必要元数据（仓库名称、所有者、提交 ID）。


2. 获取提交详情： 接着，一个 HTTP Request n8n 节点使用提交 ID 调用 GitHub API，检索详细的提交信息，包括至关重要的补丁/差异数据 (patch/diff data)。


3. HTML 格式化 (Code 节点)： 一个专用的 Code n8n 节点接收原始提交数据，并将其转换为高度风格化的 HTML 输出。这包括对代码差异进行着色（新增用绿色‘+’，删除用红色‘-’），以优化邮件客户端的可读性。


4. AI 分析 (AI Agent 节点)： AI Agent n8n 节点接收此格式化的 HTML。它通过严格的系统提示被指示充当专家代码审查员，专注于功能、风格和安全问题。它利用 Groq 聊天模型和一个 Simple Memory n8n 节点进行处理（尽管对于单次审查，内存是可选的）。


5. 输出合并： 一个 Output Parser Code n8n 节点将原始提交详情（来自第一个 Code 节点）和 AI 代理生成的严格 HTML 总结合并起来。


6. 最终通知： 生成的最终 HTML 输出通过 Gmail n8n 节点发送到指定的接收人（审查员或开发团队），从而完成 n8n 自动化工作流。流程随后以 End Workflow n8n 节点结束。

Markdown 格式文本:

1. 导入 n8n 模板： 复制提供的 JSON，并使用 n8n 实例中的“新建”菜单 -> “从 JSON 导入”将其粘贴进去。


2. GitHub 凭证设置： 为 Github Trigger n8n 节点和 HTTP Request n8n 节点设置凭证。


3. Groq 设置： 使用您的 Groq API 密钥配置 Groq Chat Model n8n 节点。


4. Github Trigger 配置： 自定义 Github Trigger n8n 节点中的仓库 URL 和所有者详细信息，以监控您的目标项目。确保在 GitHub 仓库设置中正确设置 Webhook，使其指向 n8n 触发器的 URL。


5. Gmail 设置： 使用您的 OAuth2 凭证配置 Gmail n8n 节点。将 sendTo 参数更新为您想要的审查者的电子邮件地址。


6. 激活： 保存并激活 n8n 工作流。它现在将在每次推送事件发生时自动运行。

Markdown 格式文本:
Github Trigger (n8n 触发器)：
功能： 在特定 GitHub 仓库发生“push”事件时启动 n8n 工作流。
关键配置： 事件设置为 push。必须手动更新仓库详情以匹配您的项目。
HTTP Request (n8n 节点)：
功能： 使用引用 n8n 触发器数据中提供的提交 ID 的动态表达式，获取包括文件补丁在内的详细提交元数据。
关键配置： 使用 GitHub OAuth2 凭证类型进行安全 API 访问。URL 是动态生成的，用于请求提交数据：=https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}。
Code (Formatter n8n 节点)：
功能： 将原始 GitHub 提交数据（差异）转换为具有颜色编码的样式化 HTML，以便在电子邮件中获得出色的可视化效果。它区分了新增行（‘+’，绿色）和删除行（‘-’，红色）。
关键配置： 包含自定义 JavaScript 逻辑（formatPatch 和 renderResponse）来构建元数据（仓库信息、作者、消息）和代码差异的结构。
Groq Chat Model (n8n 节点)：
功能： 为 AI 代理提供 LLM 后端，利用快速的 llama-3.1-8b-instant 模型来生成代码审查。
关键配置： 需要 Groq API 凭证。
AI Agent (n8n 节点)：
功能： 作为核心智能模块。它接收 HTML 格式的代码差异作为输入，并根据详细的提示指令生成严格的、结构化的代码审查。
关键配置： 系统提示强制 AI 检查功能、风格、安全问题，并建议改进措施，关键是将其结果返回到两个预定义的 HTML 块之一中。
Gmail (n8n 节点)：
功能： 将最终合并的 HTML 输出（提交详情 + AI 审查）作为电子邮件通知发送。
关键配置： Subject 设置为 'Code Review'。Message 使用来自 Output Parser n8n 节点的最终 HTML 输出。