GitHub Smart Code Digest

自动化 GitHub 代码审查与飞书 Wiki 推送工作流，5 分钟生成团队代码质量报告。

适用场景

• 工程团队每日/每周代码审查汇总
• 技术负责人追踪多个仓库的 PR 质量
• 自动化生成工程师日报/周报内容
• 开源项目维护者追踪贡献代码质量
• CI/CD 流水线失败后的审查报告归档

工作流程

Step 1 → github
   │   获取仓库列表 → 筛选目标仓库
   │   获取指定时间范围内的 Commits + PR 列表
   ↓
Step 2 → code-review-skill
   │   对每个 Open/Recent PR 执行 5 维度 AI 审查
   │   输出：问题列表 + 置信度评分 + 修复建议
   ↓
Step 3 → card-renderer
   │   生成审查摘要卡片（封面图 + 详情页）
   │   包含：仓库名、PR 数量、问题分布、质量评分
   ↓
Step 4 → feishu-wiki
       创建/更新飞书 Wiki 页面
       支持定时任务自动触发

使用方式

手动触发

# 审查单个仓库（默认最近 7 天）
openclaw run github-smart-code-digest --repo owner/repo

# 指定时间范围和仓库
openclaw run github-smart-code-digest \
  --repo owner/repo \
  --since "2026-04-10" \
  --until "2026-04-17" \
  --feishu-space-id <知识空间ID>

定时自动推送（推荐）

# 每天早上 9:00 推送代码审查日报
openclaw cron add "0 9 * * *" "github-smart-code-digest" \
  --name "代码审查日报" \
  --repo owner/repo

# 每周一早上 9:30 推送周报
openclaw cron add "0 9:30 * * 1" "github-smart-code-digest" \
  --name "代码审查周报" \
  --repo owner/repo1,owner/repo2 \
  --period weekly

配置项 (config.yaml)

github:
  # 监控的仓库列表
  repos:
    - owner/repo1
    - owner/repo2
  # 默认审查时间范围（天）
  default_days: 7
  # 最小 PR 变更行数（过滤小修改）
  min_pr_lines: 10

feishu:
  # 飞书知识空间 ID
  wiki_space_id: ""
  # 飞书 Wiki 父节点（可选，指定挂载位置）
  wiki_parent_node: ""

card:
  # 卡片风格
  style: macbook-pro   # macbook-pro | cyberpunk | bauhaus
  # 输出格式
  format: png          # png | jpg

cron:
  # 默认启用定时任务
  enabled: true
  # 推送时间（HH:MM）
  push_time: "09:00"
  # 报告周期
  period: daily        # daily | weekly

Step 详解

Step 1: github — 仓库信息采集

# 获取仓库最近 PR 列表（最近 7 天）
gh pr list --repo owner/repo \
  --state open \
  --search "created:>=$(date -d '7 days ago' +%Y-%m-%d)" \
  --json number,title,author,createdAt,changedFiles,additions,deletions

# 获取指定 PR 的文件变更
gh pr diff <pr-number> --repo owner/repo

# 获取最近 Commits
gh api repos/owner/repo/commits?since=<unix-timestamp>

输出中间结果（JSON）：

{
  "repo": "owner/repo",
  "period": "2026-04-10 ~ 2026-04-17",
  "prs": [
    {
      "number": 123,
      "title": "feat: add user authentication",
      "author": "dev1",
      "changed_files": 8,
      "additions": 245,
      "deletions": 32,
      "created_at": "2026-04-14T10:00:00Z"
    }
  ],
  "commits": 12
}

Step 2: code-review-skill — AI 代码审查

对每个 PR 独立执行 5 维度审查（并行处理）：

维度	检查内容	最低报告置信度
正确性	业务逻辑、边界条件、错误处理	80%
安全性	注入、认证绕过、数据暴露	80%
可维护性	代码复杂度、命名、可读性	80%
性能	N+1 查询、内存泄漏、资源管理	80%
规范合规	CLAUDE.md、编码规范、测试覆盖	80%

审查输出：

{
  "pr_number": 123,
  "issues": [
    {
      "severity": "important",
      "file": "src/auth/service.ts",
      "line": "45-47",
      "description": "数据库操作缺少事务保护",
      "confidence": 85,
      "suggestion": "使用 BEGIN...COMMIT 包装多个写操作"
    }
  ],
  "summary": {
    "total_issues": 3,
    "critical": 0,
    "important": 2,
    "minor": 1
  },
  "approval_ready": false
}

Step 3: card-renderer — 可视化卡片生成

生成审查汇总卡片（两张图）：

卡片 ① 封面图：

• 标题：GitHub 代码审查日报 / 周报
• 仓库名称 + 时间范围
• 总体质量评分（五星或雷达图）
• PR 总数 / 问题总数

卡片 ② 详情页：

• 各仓库 PR 分布柱状图
• 问题类型分布饼图
• 高置信度问题列表（Top 5）
• 审查覆盖率（%）

# 调用 card-renderer
python3 scripts/generate_digest_card.py \
  --data /tmp/digest_data.json \
  --style macbook-pro \
  --output /tmp/digest_card.png

Step 4: feishu-wiki — 发布飞书 Wiki

在指定知识空间创建 Wiki 页面：

# GitHub 代码审查报告

**仓库**: owner/repo  
**时间范围**: 2026-04-10 ~ 2026-04-17  
**生成时间**: 2026-04-17 09:00

## 审查概览

| 指标 | 数值 |
|------|------|
| PR 总数 | 12 |
| 问题总数 | 8 |
| 高置信度问题 | 3 |
| 审查覆盖率 | 100% |

## 详细审查结果

### PR #123: feat: add user authentication

- 问题数：3
- 状态：⚠️ 需要修改
- 关键问题：
  - `src/auth/service.ts:45` — 数据库操作缺少事务保护（置信度 85%）
  - `src/auth/middleware.ts:22` — 缺少权限验证中间件（置信度 82%）

## 审查卡片

![审查汇总卡片](file:///tmp/digest_card.png)

输出文件

文件	路径	说明
PR 数据	/tmp/digest_prs.json	原始 PR 列表
审查报告	/tmp/digest_reviews.json	AI 审查结果
封面卡片	/tmp/digest_cover.png	封面图
详情卡片	/tmp/digest_detail.png	详情页图
Wiki 页面	飞书 Wiki	最终发布的报告

注意事项

• 仅报告置信度 ≥ 80% 的问题，避免信息噪音
• 过滤小 PR（变更 < 10 行），减少误报
• 代码审查使用 5 个独立 Agent 并行审查，确保全面性
• 飞书 Wiki 每次运行会创建新页面（历史报告保留）
• 建议一个知识空间用于归档，形成可追溯的审查历史

前置条件

1. GitHub CLI (gh) 已安装并完成 gh auth login
2. 飞书 App 具备 Wiki 写入权限
3. 环境变量：
   • FEISHU_APP_ID、FEISHU_APP_SECRET（飞书应用凭证）