GitLab Code Review

GitLab 定时代码审查，自动获取新提交并生成 Review 报告。触发场景：(1) 用户说"配置 GitLab code review"、"设置代码审查"、"帮我监控 GitLab 提交"； (2) 用户提到 GitLab code review 或需要定时审查代码；(3) Heartbeat 执行定时检查时。

定时获取 GitLab 新提交，自动生成代码审查报告并推送通知。

用户配置流程

当用户说「配置 GitLab code review」或类似意图时：

1. 引导用户输入配置（或复用现有配置）

首先检查现有配置：读取 workspace/.env 文件，如果已存在 GitLab 相关配置，直接复用，无需重新询问。

如果配置不完整，逐个询问：

我需要几个配置信息：

1. GitLab URL 是什么？（例如：https://gitlab.example.com）

2. 项目路径是什么？（group/project 格式）

3. 分支名称是什么？（默认 main）

4. Personal Access Token 是什么？
   需要的权限：read_api
   获取方式：GitLab → 用户设置 → Access Tokens

2. 创建/更新配置文件

收集完信息后，创建或更新 workspace/.env 文件：

GITLAB_URL=<用户输入的URL>
GITLAB_TOKEN=<用户输入的Token>
GITLAB_PROJECT=<用户输入的项目路径>
GITLAB_BRANCH=<用户输入的分支>

3. 创建 Cron 定时任务

重要：使用 OpenClaw cron 命令创建定时任务

openclaw cron add \
  --name "GitLab Code Review" \
  --cron "0 * * * *" \
  --stagger 5m \
  --channel <当前channel> \
  --to <当前用户ID> \
  --message "执行 GitLab Code Review 定时任务：运行 python3 skills/gitlab-code-review/scripts/fetch_commits.py 获取新提交，检查 memory/pending_review_*.json。**有新提交**才进行 code review 并推送报告；**无新提交则静默结束，不推送任何消息，不调用模型审查**"

参数说明：

• --cron "0 * * * *" - 每小时整点执行
• --stagger 5m - 5 分钟随机偏移，避免整点拥堵
• --channel - 当前对话的 channel（如 feishu）
• --to - 当前用户的 ID

检查是否已存在：先运行 openclaw cron list，如果已存在同名任务，跳过创建。

4. 简化 HEARTBEAT.md

更新 HEARTBEAT.md，说明定时任务已配置为 cron：

# HEARTBEAT.md

# Heartbeat 任务清单

GitLab Code Review 已配置为独立的 cron 定时任务（每小时整点执行），无需在 heartbeat 中处理。

---

**注意**：
- 定时任务通过 `openclaw cron list` 查看

5. 执行首次审查

配置完成后，立即执行首次审查：

1. 运行 python3 skills/gitlab-code-review/scripts/fetch_commits.py 获取待审查提交
2. 检查 memory/pending_review_*.json 是否存在
3. 如果有待处理文件：
   • 按文件名排序（时间正序）
   • 逐个进行深度 code review
   • 生成完整报告 memory/code_review_<short_id>.md
   • 使用 message 工具推送到当前用户：
     • 发送简化版报告文本
     • 发送完整报告文件（.md 附件）
   • 删除已处理的 pending 文件
4. 如果无新提交：静默结束，不推送任何消息

6. 确认完成

✅ 配置完成！

- 已创建 .env 文件
- 已创建 cron 定时任务（每小时整点执行）
- 已完成首次审查并推送报告

查看定时任务：openclaw cron list

定时执行逻辑

Cron 任务触发时，agent 会执行以下步骤：

1. 检查配置：读取 workspace/.env
2. 获取提交：执行 python3 skills/gitlab-code-review/scripts/fetch_commits.py
3. 检查结果：查看 memory/pending_review_*.json
4. 有新提交：
   • 读取 pending 文件内容
   • 进行深度 code review
   • 生成报告 memory/code_review_<short_id>.md
   • 推送简化版报告和完整报告文件到当前对话用户
   • 删除 pending 文件
5. 无新提交：
   • 静默结束，不推送任何消息
   • 不调用模型审查代码
   • 直接返回，不做任何输出

推送方式

使用 message 工具推送两条消息：

1. 简化版报告文本：

{
  "action": "send",
  "channel": "feishu",
  "target": "当前用户ID",
  "message": "简化版报告内容"
}

2. 完整报告文件：

{
  "action": "send",
  "channel": "feishu",
  "target": "当前用户ID",
  "media": "memory/code_review_<short_id>.md",
  "filename": "code_review_<short_id>.md",
  "caption": "📋 完整的 Code Review 报告"
}

脚本说明

scripts/fetch_commits.py

获取 GitLab 未审查的提交。

执行方式：

python3 skills/gitlab-code-review/scripts/fetch_commits.py

首次运行：只获取最近 2 个提交 后续运行：获取上次审查之后的所有新提交（最多 50 个）

依赖：

• 配置文件：workspace/.env
• Python 包：requests, python-dotenv

输出：

• memory/pending_review_<short_id>.json - 待审查提交数据
• memory/gitlab_review_state.json - 审查状态记录

Code Review 维度

审查提交时，关注以下维度：

🔒 安全性

• SQL 注入、XSS、CSRF 漏洞
• 敏感信息泄露（密码、Token 硬编码）
• 权限校验缺失

⚡ 性能

• N+1 查询问题
• 循环内数据库操作
• 大数据集内存问题
• 缓存策略合理性

📦 代码质量

• 命名规范与可读性
• 注释完整性
• 错误处理与边界检查
• 重复代码

🧪 可测试性

• 依赖注入
• 单一职责
• 测试覆盖

报告格式

完整报告保存到 memory/code_review_<short_id>.md。

简化版推送格式：

📋 GitLab Code Review - 新提交审查

提交: <short_id>
标题: <title>
作者: <author>
时间: <time>
变更: <N> 个文件

⚠️ 发现 <严重程度> 问题

🔴 主要问题:
1. <问题描述>
   📄 <文件路径>:<行号范围>

💡 改进建议:
1. <建议内容>

📊 状态: <状态说明>
🔗 查看详情: <commit_url>

故障排查

Skill 未识别

确保 skill 安装在正确位置：

• ClawHub 安装：workspace/skills/gitlab-code-review/
• 手动安装：解压到 workspace/skills/

脚本执行失败

# 检查依赖
pip3 install requests python-dotenv

# 测试连接
python3 skills/gitlab-code-review/scripts/fetch_commits.py

Token 权限不足

确保 Token 有 read_api 权限：

• GitLab → 用户设置 → Access Tokens
• 勾选 read_api
• 创建新 Token

无新提交被检测

检查 memory/gitlab_review_state.json 中的 last_reviewed_commit_id：

cat memory/gitlab_review_state.json

如果需要重新检测，删除该文件后重新运行脚本。

定时任务未执行

检查 cron 任务状态：

openclaw cron list

手动触发测试：

openclaw cron run <job-id>