gitlab-workflow

GitLab 工作流

通过 mx_gitlab 工具管理 GitLab 项目。严格遵守团队规范。

前置条件

1. 安装插件: openclaw plugins install openclaw-morphixai
2. 获取 API Key: 访问 morphix.app/api-keys 生成 mk_xxxxxx 密钥
3. 配置环境变量: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 链接账号: 访问 morphix.app/connections 链接 GitLab 账号，或通过 mx_link 工具链接（app: gitlab）

---

参数命名规范（重要）

mx_gitlab 工具所有 action 的参数命名：

参数	说明
project	项目 ID（数字字符串）或路径（group/repo），不是 project_id
mr_iid	MR 在项目内的序号，不是 merge_request_iid
pipeline_id	Pipeline 的全局 ID

description 字段换行格式

⚠️ description 字段必须使用真实换行符，不要使用 \n 字面量字符串。

错误示例（在 GitLab 上会显示为 \n）：

description: "改动\n- 修复 bug\n- 新增功能"

正确示例（使用 YAML 多行字符串）：

description: |
  ## 改动
  - 修复 bug
  - 新增功能

  ## 测试
  - 单元测试通过

---

代码审查策略（优先级顺序）

获取 MR 代码变更时，按以下顺序尝试：

✅ 优先：本地 git（推荐）

本地仓库 + git 命令是最可靠的代码审查方式：

• 无需额外认证（使用本地已有凭证）
• 无响应体大小限制（任意规模的 diff）
• 速度快，工具丰富（log、diff、show、blame）

第一步：查找本地仓库路径

# nodes.run — 在本机执行
find ~/www -maxdepth 4 -type d -name '<仓库名>'
# 例：find ~/www -maxdepth 4 -type d -name 'tanka-2b-web'

第二步：fetch 最新数据

# nodes.run — 工作目录切换到仓库路径
cd ~/www/<项目路径> && git fetch origin

第三步：获取 MR 的 commits（需要知道源分支和目标分支）

# 查看 MR 分支间的 commit 列表
git log origin/<target-branch>..origin/<source-branch> --oneline

# 示例（MR: feat/zoom-v2/main → uat-tanka-oh）
git log origin/uat-tanka-oh..origin/feat/zoom-v2/main --oneline

第四步：获取文件变更统计

git diff --stat origin/<target-branch>...origin/<source-branch>
# 示例
git diff --stat origin/uat-tanka-oh...origin/feat/zoom-v2/main

第五步：获取具体文件的 diff

# 全量 diff（大 MR 慎用，建议指定文件）
git diff origin/<target-branch>...origin/<source-branch>

# 指定文件 diff（推荐）
git diff origin/<target-branch>...origin/<source-branch> -- src/path/to/file.ts

# 只看特定目录
git diff origin/<target-branch>...origin/<source-branch> -- src/components/