codearts-repo（Codearts 仓库）

codearts-repo (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../codearts-shared/SKILL.md 了解配置与认证。

CodeArts 代码托管模块。--project-id 在所有 repo 命令中是必填的（不从 config 兜底）。

从 git remote 自动提取 project-id

当用户在一个 CodeArts Repo 克隆的仓库目录下操作时，可以从 git remote -v 的 URL 中提取 project-id，避免手动输入：

git@codehub-cn-south-1.devcloud.huaweicloud.com:759278abbfb14b098eeddc548741f38b/nest-app-agent.git
                                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                                 这就是 project-id

提取方式（Agent 应自动执行）：

PROJECT_ID=$(git remote -v | grep codehub | head -1 | sed 's/.*:\([a-f0-9]\{32\}\)\/.*/\1/')

HTTPS 格式同理：

https://codehub-cn-south-1.devcloud.huaweicloud.com/759278abbfb14b098eeddc548741f38b/nest-app-agent.git

PROJECT_ID=$(git remote -v | grep codehub | head -1 | grep -oE '[a-f0-9]{32}' | head -1)

提取后直接传给 --project-id $PROJECT_ID。如果 git remote -v 中没有 codehub 的 URL，则需要用户手动提供。

命令

repo list

查询项目下的仓库列表。--project-id 必填（可从 git remote -v 自动提取）。

# 列出所有仓库
codearts-cli repo list --project-id <project_uuid>

# 按名称搜索
codearts-cli repo list --project-id <project_uuid> --search "backend"

# 分页
codearts-cli repo list --project-id <project_uuid> --page-index 2 --page-size 10

API 参考: ShowAllRepositoryByTwoProjectId

返回值：result.repositories 数组，每条包含 repository_id（整数，用于 MR 操作）、repository_name、ssh_url、https_url、web_url。

关键：repo list 返回的 repository_id 就是 repo mr create / repo mr comment 需要的参数。

重要：repository_id 是整数

所有 repo 命令的 <repository_id> 必须是正整数（如 8147520），不是 32 位 UUID。

• UUID 格式（如 759278abbfb14b098eeddc548741f38b）是 project_id，不是 repo_id
• 获取 repo_id：运行 codearts-cli repo list --project-id <proj>，或 CodeArts Repo 控制台 → 仓库设置 → 仓库 ID（数字）

CLI 会严格校验：传入 UUID 会直接报错（不会静默截断）。

命令

repo mr create

创建合并请求。

# 最简
codearts-cli repo mr create <repo_id> \
  --title "feat: 接入 codearts-cli" \
  --source feat/cli --target main

# 带评审人 / squash / 关联工作项
codearts-cli repo mr create <repo_id> \
  --title "feat: x" --source feat/x --target main \
  --reviewers "uid-a,uid-b" --assignees "uid-c" \
  --squash --squash-message "feat: squashed" \
  --force-remove-source \
  --work-item 1251275102548402177

# 完整 body
codearts-cli repo mr create <repo_id> --body-file mr.json

API 参考: CreateMergeRequest

*使用 --body-json / --body-file 时不需要这些 flag。

返回值包含 iid（MR 编号，用于后续 repo mr comment）和 web_url（控制台链接）。

repo mr comment

给合并请求发检视意见。

# 简单评论
codearts-cli repo mr comment <repo_id> <mr_iid> --body "LGTM"

# 带严重级别
codearts-cli repo mr comment <repo_id> <mr_iid> \
  --body "参数未校验" --severity major

# 行级评论（需要 position 结构，用文件）
codearts-cli repo mr comment <repo_id> <mr_iid> --body-file review.json

API 参考: CreateMergeRequestDiscussion

*使用 --body-json / --body-file 时不需要此 flag。

repo member list

查询仓库成员列表。<repository_id> 必须是正整数（不是 UUID）。

# 所有成员
codearts-cli repo member list <repo_id>

# 按用户名 / 昵称 / 租户名模糊搜索
codearts-cli repo member list <repo_id> --search "zhang"

# 分页（offset 从 0 开始，limit 1-100，默认 20）
codearts-cli repo member list <repo_id> --offset 20 --limit 50

# 按权限点 + 动作过滤（如：有 code push 权限的成员）
codearts-cli repo member list <repo_id> --permission code --action push

API 参考: ListMembers

--action 取值（按 --permission 分）：

返回值：成员 DTO 数组，字段包括 user_id、user_name、user_nick_name、tenant_name、repository_role_name、service_license_status（0=停用 / 1=正常）等。

典型工作流

# 1. 查询仓库列表，获取 repository_id
codearts-cli repo list --project-id <proj>
#  → repository_id: 8147520, repository_name: "nest-app-agent"

# 2. 创建 MR
MR_IID=$(codearts-cli repo mr create 8147520 \
  --title "feat: x" --source feat/x --target main 2>/dev/null \
  | jq -r '.iid')

# 3. 发检视意见
codearts-cli repo mr comment 8147520 $MR_IID --body "请补单测" --severity minor