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. 执行首次审查
配置完成后，立即执行首次审查：
- 运行
python3 skills/gitlab-code-review/scripts/fetch_commits.py获取待审查提交 - 检查
memory/pending_review_*.json是否存在 - 如果有待处理文件：
- 按文件名排序（时间正序）
- 逐个进行深度 code review
- 生成完整报告memory/code_review_<short_id>.md
- 使用 message 工具推送到当前用户：- 发送简化版报告文本
- 发送完整报告文件（.md 附件）
- 删除已处理的 pending 文件
- 如果无新提交：静默结束，不推送任何消息
6. 确认完成
✅ 配置完成！
- 已创建 .env 文件
- 已创建 cron 定时任务（每小时整点执行）
- 已完成首次审查并推送报告
查看定时任务：openclaw cron list
定时执行逻辑
Cron 任务触发时，agent 会执行以下步骤：
- 检查配置：读取
workspace/.env - 获取提交：执行
python3 skills/gitlab-code-review/scripts/fetch_commits.py - 检查结果：查看
memory/pending_review_*.json - 有新提交：
- 读取 pending 文件内容
- 进行深度 code review
- 生成报告memory/code_review_<short_id>.md
- 推送简化版报告和完整报告文件到当前对话用户
- 删除 pending 文件 - 无新提交：
- 静默结束，不推送任何消息
- 不调用模型审查代码
- 直接返回，不做任何输出
推送方式
使用 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>
