gitlab-repo

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Repository Skill

仓库操作技能

Repository and project operations for GitLab using the

glab

CLI.

使用

glab

CLI进行GitLab仓库与项目操作。

Quick Reference

快速参考

Operation	Command	Risk
Clone repo	`glab repo clone <repo>`	-
Fork repo	`glab repo fork <repo>`	⚠️
View repo	`glab repo view`	-
Create repo	`glab repo create`	⚠️
Search repos	`glab repo search <query>`	-
Archive repo	`glab repo archive`	⚠️⚠️
Delete repo	`glab repo delete`	⚠️⚠️⚠️
List contributors	`glab repo contributors`	-

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

操作	命令	风险
克隆仓库	`glab repo clone <repo>`	-
复刻仓库	`glab repo fork <repo>`	⚠️
查看仓库	`glab repo view`	-
创建仓库	`glab repo create`	⚠️
搜索仓库	`glab repo search <query>`	-
归档仓库	`glab repo archive`	⚠️⚠️
删除仓库	`glab repo delete`	⚠️⚠️⚠️
列出贡献者	`glab repo contributors`	-

风险说明: - 安全 | ⚠️ 注意 | ⚠️⚠️ 警告 | ⚠️⚠️⚠️ 危险

When to Use This Skill

何时使用此技能

ALWAYS use when:

User wants to clone, fork, or create repositories
User mentions "repo", "repository", "project", "clone", "fork"
User wants to manage project settings

NEVER use when:

User wants to work with specific repo content (use git directly)
User wants to manage deploy keys (use gitlab-deploy-key skill)

请务必在以下场景使用：

用户需要克隆、复刻或创建仓库
用户提及“repo”、“repository”、“project”、“clone”、“fork”
用户需要管理项目设置

请勿在以下场景使用：

用户需要处理仓库特定内容（直接使用git）
用户需要管理部署密钥（使用gitlab-deploy-key技能）

Available Commands

可用命令

Clone Repository

克隆仓库

bash

glab repo clone <repo> [directory] [options]

Arguments:

```
<repo>
```
- Repository path, URL, or project ID
```
[directory]
```
- Optional local directory name

Options:

Flag	Description
`-g, --group=<group>`	Clone all repos in a group
`-p, --preserve-namespace`	Clone into subdirectory based on namespace
`-a, --archived=<bool>`	Include/exclude archived repos (with -g)
`--paginate`	Fetch all pages of projects (with -g)

Examples:

bash

undefined

bash

glab repo clone <repo> [directory] [options]

参数：

```
<repo>
```
- 仓库路径、URL或项目ID
```
[directory]
```
- 可选的本地目录名称

选项：

标志	描述
`-g, --group=<group>`	克隆组内所有仓库
`-p, --preserve-namespace`	根据命名空间克隆到子目录
`-a, --archived=<bool>`	包含/排除已归档仓库（搭配-g使用）
`--paginate`	获取所有分页的项目（搭配-g使用）

示例：

bash

undefined

Clone by path

通过路径克隆

glab repo clone gitlab-org/cli

Clone by URL

通过URL克隆

glab repo clone https://gitlab.com/gitlab-org/cli

Clone into specific directory

克隆到指定目录

glab repo clone gitlab-org/cli my-glab

Clone by project ID

通过项目ID克隆

glab repo clone 4356677

Clone preserving namespace structure

保留命名空间结构克隆

glab repo clone gitlab-org/cli -p

Creates: gitlab-org/cli/

生成目录: gitlab-org/cli/

Clone all repos in a group

克隆组内所有仓库

glab repo clone -g mygroup --paginate

Clone only non-archived repos from group

克隆组内未归档的仓库

glab repo clone -g mygroup --archived=false --paginate

undefined

glab repo clone -g mygroup --archived=false --paginate

undefined

Fork Repository

复刻仓库

bash

glab repo fork <repo> [options]

Options:

Flag	Description
`-c, --clone`	Clone the fork after creating
`-n, --name=<name>`	Name for the forked project
`-p, --path=<path>`	Path for the forked project
`--remote`	Add a remote for the fork

Examples:

bash

undefined

bash

glab repo fork <repo> [options]

选项：

标志	描述
`-c, --clone`	创建复刻后克隆仓库
`-n, --name=<name>`	复刻项目的名称
`-p, --path=<path>`	复刻项目的路径
`--remote`	为复刻添加远程仓库

示例：

bash

undefined

Fork a repository

复刻仓库

glab repo fork owner/repo

Fork and clone

复刻并克隆

glab repo fork owner/repo --clone

Fork with custom name

自定义名称复刻

glab repo fork owner/repo --name="my-fork"

Fork and add remote

复刻并添加远程仓库

glab repo fork owner/repo --remote

undefined

glab repo fork owner/repo --remote

undefined

View Repository

查看仓库

bash

glab repo view [repo] [options]

Options:

Flag	Description
`-w, --web`	Open repository in browser
`-b, --branch=<branch>`	View specific branch

Examples:

bash

undefined

bash

glab repo view [repo] [options]

选项：

标志	描述
`-w, --web`	在浏览器中打开仓库
`-b, --branch=<branch>`	查看指定分支

示例：

bash

undefined

View current repository info

查看当前仓库信息

glab repo view

View specific repo

查看指定仓库

glab repo view gitlab-org/cli

Open in browser

在浏览器中打开

glab repo view --web

View specific branch

查看指定分支

glab repo view --branch=develop

undefined

glab repo view --branch=develop

undefined

Create Repository

创建仓库

bash

glab repo create [name] [options]

Options:

Flag	Description
`-n, --name=<name>`	Repository name
`-d, --description=<desc>`	Repository description
`-g, --group=<group>`	Create in specific group/namespace
`--public`	Make repository public
`--private`	Make repository private
`--internal`	Make repository internal
`--readme`	Initialize with README
`-c, --clone`	Clone after creation

Examples:

bash

undefined

bash

glab repo create [name] [options]

选项：

标志	描述
`-n, --name=<name>`	仓库名称
`-d, --description=<desc>`	仓库描述
`-g, --group=<group>`	在指定组/命名空间下创建
`--public`	设置仓库为公开
`--private`	设置仓库为私有
`--internal`	设置仓库为内部可见
`--readme`	初始化时添加README文件
`-c, --clone`	创建后克隆仓库

示例：

bash

undefined

Create repository interactively

交互式创建仓库

glab repo create

Create with name and description

指定名称和描述创建

glab repo create my-project -d "My awesome project"

Create public repo in group

在组内创建公开仓库

glab repo create my-project --group=myteam --public

Create and clone

创建并克隆仓库

glab repo create my-project --clone --readme

undefined

glab repo create my-project --clone --readme

undefined

Search Repositories

搜索仓库

bash

glab repo search <query> [options]

Options:

Flag	Description
`-P, --per-page=<n>`	Results per page
`--all`	Get all results

Examples:

bash

undefined

bash

glab repo search <query> [options]

选项：

标志	描述
`-P, --per-page=<n>`	每页显示结果数
`--all`	获取所有结果

示例：

bash

undefined

Search for repos

搜索仓库

glab repo search "cli tools"

Search with more results

搜索更多结果

glab repo search "gitlab" --per-page=50

undefined

glab repo search "gitlab" --per-page=50

undefined

Archive Repository

归档仓库

bash

glab repo archive [repo] [options]

Archives a repository (makes it read-only).

Examples:

bash

undefined

bash

glab repo archive [repo] [options]

归档仓库（设置为只读）。

示例：

bash

undefined

Archive current repo

归档当前仓库

glab repo archive

Archive specific repo

归档指定仓库

glab repo archive owner/repo

undefined

glab repo archive owner/repo

undefined

Delete Repository

删除仓库

bash

glab repo delete [repo] [options]

Warning: This permanently deletes the repository and all its data!

Options:

Flag	Description
`-y, --yes`	Skip confirmation prompt

Examples:

bash

undefined

bash

glab repo delete [repo] [options]

警告： 此操作将永久删除仓库及其所有数据！

选项：

标志	描述
`-y, --yes`	跳过确认提示

示例：

bash

undefined

Delete repo (will prompt for confirmation)

删除仓库（将提示确认）

glab repo delete owner/repo

Delete without confirmation (dangerous!)

无需确认直接删除（危险操作！）

glab repo delete owner/repo --yes

undefined

glab repo delete owner/repo --yes

undefined

List Contributors

列出贡献者

bash

glab repo contributors [repo] [options]

Options:

Flag	Description
`-P, --per-page=<n>`	Results per page
`--order=<order>`	Sort order: name, email, commits

Examples:

bash

undefined

bash

glab repo contributors [repo] [options]

选项：

标志	描述
`-P, --per-page=<n>`	每页显示结果数
`--order=<order>`	排序方式：name、email、commits

示例：

bash

undefined

List contributors for current repo

列出当前仓库的贡献者

glab repo contributors

List with sorting

按提交数排序列出

glab repo contributors --order=commits

undefined

glab repo contributors --order=commits

undefined

Transfer Repository

转移仓库

bash

glab repo transfer <repo> <new-namespace>

Transfer a repository to another namespace.

Examples:

bash

undefined

bash

glab repo transfer <repo> <new-namespace>

将仓库转移到其他命名空间。

示例：

bash

undefined

Transfer to different group

转移到其他组

glab repo transfer myrepo newgroup

undefined

glab repo transfer myrepo newgroup

undefined

Common Workflows

常见工作流

Workflow 1: Fork and Contribute

工作流1：复刻并贡献代码

bash

undefined

bash

undefined

1. Fork the repository

1. 复刻仓库

glab repo fork upstream/project --clone

2. Add upstream remote

2. 添加上游远程仓库

cd project git remote add upstream https://gitlab.com/upstream/project.git

3. Create feature branch

3. 创建特性分支

git checkout -b feature/my-change

4. Make changes, commit, push

4. 进行修改、提交、推送

git add . && git commit -m "Add feature" git push -u origin feature/my-change

5. Create MR to upstream

5. 向上游仓库创建合并请求

glab mr create --target-branch=main

undefined

glab mr create --target-branch=main

undefined

Workflow 2: Batch Clone Team Repos

工作流2：批量克隆团队仓库

bash

undefined

bash

undefined

Clone all non-archived repos from team group

克隆团队组内所有未归档的仓库

glab repo clone -g myteam --archived=false --paginate -p

This creates:

将生成以下目录结构：

myteam/

repo1/

repo2/

...

undefined

undefined

Workflow 3: Create New Project

工作流3：创建新项目

bash

undefined

bash

undefined

1. Create the repository

1. 创建仓库

glab repo create awesome-project
-d "An awesome new project"
--group=myteam
--readme
--clone

2. Set up the project

2. 配置项目

cd awesome-project

Add initial files...

添加初始文件...

3. View it in browser

3. 在浏览器中查看

glab repo view --web

undefined

glab repo view --web

undefined

Troubleshooting

故障排查

Issue	Cause	Solution
Authentication failed	Invalid/expired token	Run `glab auth login`
Repo not found	Invalid path or no access	Check repo path and permissions
Clone failed	SSH keys not configured	Use HTTPS or configure SSH keys
Cannot fork	Already forked or no permission	Check existing forks
Cannot delete	Not owner or maintainer	Request owner to delete

问题	原因	解决方案
认证失败	令牌无效/过期	运行 `glab auth login` 重新登录
仓库未找到	路径无效或无访问权限	检查仓库路径和权限
克隆失败	未配置SSH密钥	使用HTTPS或配置SSH密钥
无法复刻	已复刻或无权限	检查现有复刻仓库
无法删除	不是所有者或维护者	请求所有者删除