用途:该技能面向 GitLab 群组(group)层面的管理操作,通过 glab api 直接调用 GitLab Groups API 原始端点完成。适用于用户提到 group、team、organization、namespace,或需要管理群组成员、查看子群组与群组项目、将项目共享给其他群组时。项目级设置应改用 gitlab-repo,CI/CD 群组变量应改用 gitlab-variable 并加 -g 参数。
主要能力:列出与查看群组(支持分页、search、owned、top_level_only 过滤);创建顶级群组或子群组(可设 name、path、parent_id、visibility、description、request_access_enabled);更新与删除群组;列出、添加、更新、移除群组成员(access_level 与 expires_at);列出子群组与后代群组;列出群组项目(可 include_subgroups、archived 过滤);将项目共享给群组或取消共享。
必要用法:需 api 令牌作用域。常用命令形如 glab api groups、glab api groups/:id、glab api groups -X POST -f ...、glab api groups/:id/members -X POST -f user_id=456 -f access_level=30、glab api projects/:id/share -X POST -f group_id=123 -f group_access=30。路径含斜杠时需 URL 编码,例如 glab api "groups/$(echo 'parent/child' | jq -Rr @uri)"。访问级别:Guest 10、Reporter 20、Developer 30、Maintainer 40、Owner 50。
限制与风险:删除群组会永久删除该群组及其所有项目,属最高风险操作;创建、更新、删除群组及成员变更均需谨慎。创建群组取决于实例设置,管理成员需 Owner 或 Maintainer 角色,删除群组需 Owner 角色。常见问题包括创建群组返回 403(实例禁用创建)、404(路径不存在或未编码)、无法添加成员(用户不存在,需先用 glab api users?search=... 查找)。