CI/CD中的AI如何用Agent自动生成Release Note

Git Push (触发 workflow)
  → GitHub Actions 拉取代码
    → 用 daily-report-agent 分析 git log
      → Agent 调用 LLM 分类 & 组织语言
        → 生成 Release Note Markdown
          → 自动发布到 GitHub Releases

// cmd/agentd/release.go
package main
import (
    "context"
    "fmt"
    "os"
    "os/exec"
    "strings"
    "time"
    "agent-project/internal/config"
    "agent-project/internal/llm"
)
// GenerateReleaseNote 从 Git 历史生成 Release Note
func GenerateReleaseNote(cfg *config.Config, fromTag, toTag string) (string, error) {
    // 1. 获取提交记录
    commits, err := getGitCommits(fromTag, toTag)
    if err != nil {
        return "", fmt.Errorf("获取提交记录失败: %w", err)
    }
    if len(commits) == 0 {
        return "无新提交", nil
    }
    // 2. 构造 Prompt
    prompt := buildReleaseNotePrompt(commits, fromTag, toTag)
    // 3. 调用 LLM
    client := llm.NewClient(cfg.LLM)
    resp, err := client.Chat(context.Background(), []llm.Message{
        {
            Role:    "system",
            Content: releaseNoteSystemPrompt,
        },
        {
            Role:    "user",
            Content: prompt,
        },
    })
    if err != nil {
        return "", fmt.Errorf("LLM 调用失败: %w", err)
    }
    return resp.Text, nil
}
// getGitCommits 获取两个 tag 之间的提交记录
func getGitCommits(fromTag, toTag string) ([]Commit, error) {
    rangeStr := "HEAD"
    if fromTag != "" && toTag != "" {
        rangeStr = fmt.Sprintf("%s..%s", fromTag, toTag)
    } else if fromTag != "" {
        rangeStr = fmt.Sprintf("%s..HEAD", fromTag)
    }
    cmd := exec.Command("git", "log", rangeStr,
        "--pretty=format:%H|||%an|||%ad|||%s|||%b",
        "--date=short",
    )
    output, err := cmd.Output()
    if err != nil {
        return nil, err
    }
    var commits []Commit
    for _, line := range strings.Split(strings.TrimSpace(string(output)), "\n") {
        if line == "" {
            continue
        }
        parts := strings.SplitN(line, "|||", 5)
        if len(parts) < 4 {
            continue
        }
        body := ""
        if len(parts) == 5 {
            body = parts[4]
        }
        commits = append(commits, Commit{
            Hash:    parts[0][:7],
            Author:  parts[1],
            Date:    parts[2],
            Subject: parts[3],
            Body:    body,
        })
    }
    return commits, nil
}
type Commit struct {
    Hash    string
    Author  string
    Date    string
    Subject string
    Body    string
}
// buildReleaseNotePrompt 构造分类 Prompt
func buildReleaseNotePrompt(commits []Commit, fromTag, toTag string) string {
    var sb strings.Builder
    sb.WriteString(fmt.Sprintf("从 %s 到 %s 的变更：\n\n", fromTag, toTag))
    for _, c := range commits {
        sb.WriteString(fmt.Sprintf("- [%s] %s (%s, %s)\n",
            c.Hash, c.Subject, c.Author, c.Date))
        if c.Body != "" {
            // 只取 body 的第一段
            bodyLines := strings.Split(c.Body, "\n\n")
            if len(bodyLines) > 0 {
                sb.WriteString(fmt.Sprintf("  详情: %s\n", bodyLines[0]))
            }
        }
    }
    sb.WriteString(fmt.Sprintf("\n共 %d 个提交。请生成 Release Note。", len(commits)))
    return sb.String()
}
const releaseNoteSystemPrompt = `你是一个开源项目的 Release Manager。
根据 Git 提交记录生成 Release Note。
分类规则：
- 🚀 新功能：feat 开头的提交
- 🐛 Bug 修复：fix 开头的提交
- 🔧 改进：refactor/perf/style 开头的提交
- 📝 文档：docs 开头的提交
- ⚠️ 破坏性变更：有 BREAKING CHANGE 标记或明显不向后兼容的提交
如果不能归类的，放在 "其他" 里。
格式要求：
- 使用 Markdown
- 每个条目一行，说明变更内容，不写过程
- 避免 "该同志"、"表现优异" 等套话
- 语言：中文
输出格式：
## 🚀 新功能
- xxx
## 🐛 Bug 修复
- xxx
## 🔧 改进
- xxx
## 📝 文档
- xxx
如有破坏性变更，在开头加：
> ⚠️ 本版本包含破坏性变更，请谨慎升级。`

# .github/workflows/release-note.yml
name: Generate Release Note
on:
  push:
    tags:
      - 'v*'         # 推送 v 开头 tag 时触发
  workflow_dispatch:   # 也支持手动触发
    inputs:
      from_tag:
        description: '从哪个 tag 开始'
        required: false
      to_tag:
        description: '到哪个 tag'
        required: false
jobs:
  generate-release-note:
    runs-on: ubuntu-latest
    permissions:
      contents: write  # 需要写权限来创建 Release
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 获取完整 git 历史
      - name: 安装 Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.22'
      - name: 编译 agent
        run: go build -o agentd ./cmd/agentd
      - name: 确定 tag 范围
        id: tags
        run: |
          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
            echo "FROM=${{ inputs.from_tag }}" >> $GITHUB_OUTPUT
            echo "TO=${{ inputs.to_tag }}" >> $GITHUB_OUTPUT
          else
            # 自动获取：上一次 tag → 当前 tag
            CURRENT_TAG="${{ github.ref_name }}"
            PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
            echo "FROM=${PREV_TAG}" >> $GITHUB_OUTPUT
            echo "TO=${CURRENT_TAG}" >> $GITHUB_OUTPUT
          fi
      - name: 生成 Release Note
        env:
          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
          LLM_MODEL: deepseek-v4-flash
        run: |
          ./agentd release-note \
            --from "${{ steps.tags.outputs.FROM }}" \
            --to "${{ steps.tags.outputs.TO }}" \
            > release-note.md
      - name: 展示生成的 Release Note
        run: cat release-note.md
      - name: 创建 GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          body_path: release-note.md
          draft: false
          prerelease: false
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

## 🚀 新功能
- 支持多仓库批量分析，自动汇总日报 (#15)
- 新增企业微信通知渠道，日报直接推送到群 (#18)
## 🐛 Bug 修复
- 修复 Git 提交信息中含特殊字符时解析崩溃的问题 (#12)
- 修复时区问题导致日报日期差一天 (#14)
## 🔧 改进
- LLM 调用增加指数退避重试，API 超时自动恢复 (#16)
- 日志改用 slog 结构化输出，方便接入日志平台 (#17)
## 📝 文档
- README 新增 Docker Compose 部署说明
- 补充 API 文档和调用示例

func GenerateMultiRepoReleaseNote(repos []string) (string, error) {
    var allNotes []string
    for _, repo := range repos {
        note, err := GenerateReleaseNoteForRepo(repo)
        if err != nil {
            log.Printf("[Warn] 仓库 %s 生成失败: %v", repo, err)
            continue
        }
        allNotes = append(allNotes, fmt.Sprintf("### %s\n\n%s", repo, note))
    }
    // 调一次 LLM 做最终汇总
    return summarizeReleaseNotes(allNotes)
}