GitLab Code Review

---

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

---

GitLab Code Review

定时获取 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_.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_.md - 推送简化版报告和完整报告文件到当前对话用户 - 删除 pending 文件 5. 无新提交： - 静默结束，不推送任何消息 - 不调用模型审查代码 - 直接返回，不做任何输出

推送方式

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

1. 简化版报告文本：

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

2. 完整报告文件：

{
  "action": "send",
  "channel": "feishu",
  "target": "当前用户ID",
  "media": "memory/code_review_.md",
  "filename": "code_review_.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_.json - 待审查提交数据

memory/gitlab_review_state.json - 审查状态记录

Code Review 维度

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

🔒 安全性

SQL 注入、XSS、CSRF 漏洞

敏感信息泄露（密码、Token 硬编码）

权限校验缺失

⚡ 性能

N+1 查询问题

循环内数据库操作

大数据集内存问题

缓存策略合理性

📦 代码质量

命名规范与可读性

注释完整性

错误处理与边界检查

重复代码

🧪 可测试性

依赖注入

单一职责

测试覆盖

报告格式

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

简化版推送格式：

📋 GitLab Code Review - 新提交审查
提交: 
标题: