用 n8n 自动生成 GitHub Release Notes 并推送到 Slack

输入仓库信息 → 获取最新 tag 与合并 PR → 按标签分组生成 Markdown 草稿 → 创建 GitHub draft release → Slack 通知

给谁

开源维护者、DevOps 工程师、需要结构化发布说明的技术团队

你会得到

每次手动触发后，自动生成基于标签分组的 Markdown release notes，创建 GitHub draft release，并将摘要发送到 Slack

你需要

n8n

步骤

1. 通过表单输入仓库信息

   在 n8n 中运行该 workflow 时，先填写表单：Repository Owner（GitHub 用户名或组织）、Repository Name（仓库名）、Branch Name（目标分支，如 main）。三个字段均为必填。

2. 配置节点提取输入并定义标签分组

   Config 节点（Edit Fields/Set）将表单输入映射为 repoOwner、repoName、defaultBranch，同时定义 labelMap 和 qaChecklist。labelMap 决定 PR 标签如何归类到 release notes 的章节标题；qaChecklist 为末尾附加的 QA 检查项。可按需修改映射规则。

3. 获取最新 tag 及其提交时间

   先调用 GitHub API `GET /repos/{owner}/{repo}/tags` 获取最新 tag（使用 githubApi 凭证认证），再跟随该 tag 的 commit.url 获取具体提交时间戳。该时间戳用于确定「上次发布之后」的范围边界。

4. 查询该时间之后合并的 PR

   使用 GitHub Search API 查询：`is:pr is:merged repo:{owner}/{repo} base:{branch} merged:>={tag_commit_date}`。返回结果包含 PR 标题、编号、标签数组等，供下一步分组使用。

5. 按标签分组并生成 Markdown release notes

   Code 节点执行 JavaScript，读取 Config 节点的 labelMap 与 qaChecklist，将 PR 按匹配标签分组，未匹配归入「📋 Others」。输出格式包含各级 Markdown 标题、PR 列表及 QA Checklist。

   运行提示词 · 来源原文。n8n Code 节点 'Adjusted: Group PRs & Generate Release Notes' 的 JS Code 字段

   复制提示词

   // SAFELY access config node data
   const configNode = $('Config').first();
   if (!configNode) {
     throw new Error("Missing 'Config' node or it's not accessible.");
   }
   
   const labelMap =  configNode.labelMap|| {};
   const qaChecklist = configNode.qaChecklist || [];
   
   console.log("Your message", labelMap);
   console.log("Your message", qaChecklist);
   
   // Access PR list from previous node
   const prNode = $('Fetch All Merged PRs Since Last Tag').first(); // <-- Replace with your actual PR-fetch node name
   if (!prNode || !prNode.json || !Array.isArray(prNode.json.items)) {
     throw new Error("Pull request data not found or improperly formatted.");
   }
   
   const prItems = prNode.json.items;
   
   /** @type {Record<string, string[]>} */
   const grouped = {};
   
   // Loop through each PR
   for (const pr of prItems) {
     const labels = pr.labels?.map(l => l.name) || [];
     const matchedKey = labels.find(l => labelMap[l]);
     const groupTitle = matchedKey ? labelMap[matchedKey] : "📋 Others";
   
     if (!grouped[groupTitle]) {
       grouped[groupTitle] = [];
     }
   
     grouped[groupTitle].push(`- ${pr.title} (#${pr.number})`);
   }
   
   // Build Markdown content
   let markdown = `## 📝 Release Notes\n`;
   
   for (const group in grouped) {
     markdown += `\n### ${group}\n`;
     markdown += grouped[group].join("\n") + "\n";
   }
   
   markdown += `\n## ✅ QA Checklist\n`;
   markdown += qaChecklist.map(item => `[ ] ${item}`).join("\n");
   
   return [
     {
       json: {
         release_notes: markdown,
       },
     },
   ];

6. 创建 GitHub draft release 并通知 Slack

   GitHub Pre-release 节点以 POST 调用 `/repos/{owner}/{repo}/releases`，参数包括 tag_name、name、body（上一步生成的 release_notes）、draft=true、prerelease=false。随后 Slack 节点将 release notes 与 release 链接发送到指定频道。Slack 节点的 url 字段需填入你的 Webhook URL。

你正在搭建一个 n8n workflow：从 GitHub 仓库的合并 PR 自动生成 draft release notes 并推送到 Slack。请先确认你已具备：1）可访问的 n8n 实例；2）GitHub 个人访问令牌（PAT）或 OAuth 应用，具备 repo 与 write:repo_hook 权限；3）Slack Incoming Webhook URL 或等效凭证。然后导入 workflow JSON，按步骤配置凭证、填写表单字段，最后手动触发测试。若 PR 无标签，请先在 Config 节点更新 labelMap 或确保 PR 已打标签。