实战SOP:OfficeAce用Gitee CLI管理代码仓库

背景:仓库管理那些重复活

维护代码仓库,真正费时间的不是写代码,是那些反复出现的机械操作:新建仓库要登录网页填表、克隆要拼SSH地址、批量查看同步状态要一个个目录翻、Issue和PR散在网页上想批量处理只能逐个点。一个人维护二三十个仓库的时候,每周光花在"创建仓库+首次推送"上的时间就超过十分钟,而且每次至少伴随一次小报错——仓库名拼错、分支名写成master而远端默认是main、remote add地址写混。

这周我把这些活交给了OfficeAce:不点网页、不背命令,只写一句自然语言指令,让它调Gitee CLI完成仓库的创建、克隆、状态查看和Issue管理。全程三分钟,返工为零。

方案:装一次工具,后面全靠说

1. 先装Gitee CLI。 Gitee CLI是用Go编写的静态二进制,零依赖,从releases页下载对应平台的版本放入系统PATH即可。装好后初始化配置:

gitee config init --token <你的私人令牌> --default-org <组织名>

令牌在Gitee的"设置→私人令牌"页生成,勾选projects、issues、pull_requests等权限。出于安全考虑,配置文件不保存密码,只存令牌。支持环境变量覆盖,CI/CD场景可动态注入。

2. 验证安装。 装好跑一条命令确认连通:

gitee repo list

能看到自己账号下的仓库列表按更新时间倒序输出,说明认证和连通都没问题。

3. 一句指令开工(可直接套用):

用 gitee CLI 创建一个名为 demo-project 的私有仓库,
描述为"OfficeAce自动化测试项目",
创建完成后在当前目录克隆该仓库,
克隆后初始化一个 README.md 并首次推送到 main 分支。
完成后报告仓库地址和克隆路径。

OfficeAce收到这条指令后,依次执行:gitee repo create demo-project --private --description "…"创建远端仓库,gitee repo clone拉到本地,写好README后git add/commit/push推送。你不用记任何参数,说清"做什么"就行。

跑完的效果:Gitee上多了一个私有仓库demo-project,本地多了一个已关联remote的干净目录,README已推送,main分支就绪。

实践要点

1. 令牌权限最小化。 生成令牌时只勾选当前操作需要的权限:只管仓库就勾projects,要操作Issue就加issues,要处理PR就加pull_requests。全选虽然省事,但令牌一旦泄露,损失面就是全部。令牌定期在设置页轮换,旧令牌立即吊销。
2. 分支名在指令里讲死。 Gitee新版仓库默认分支是main,但git init默认还是master。在指令里明确写"推送到main分支",OfficeAce会在git init时加-b main参数,省去事后在网页端改默认分支的麻烦。如果本地已经是master,指令里说"重命名当前分支为main再推送"即可。
3. 批量操作让OfficeAce编排循环。 需要同时查看二十个仓库的同步状态,不用自己写for循环,直接说"列出我名下所有仓库,逐个检查本地是否有未推送的提交,报告有问题的仓库名和落后提交数"。OfficeAce会调gitee repo list拿到列表,再逐个跑git status汇总,你只看结论。
4. 危险操作要加确认门槛。 删除仓库、强制推送这类不可逆操作,在指令里加一句"执行前先列出将要删除的仓库让我确认"。Gitee CLI本身对破坏性操作有二次确认,但通过OfficeAce间接调用时,把确认环节留在指令里更稳妥。

小结

这套流程跑顺之后,仓库管理的机械活在我这里稳定成一句话:我负责把令牌配好、把指令写明白,OfficeAce负责调Gitee CLI一条条执行。网页表单没有消失,只是藏进了自然语言背后——CLI工具的价值不在于功能多,而在于让Agent能替你把重复活接过去,你只管说和验收。