连接 GitHub / GitLab

01

先选一条正确的连接路线

不要一次开放所有能力。先选择最小可用入口，验证价值后再升级。

官方 CLI 登录

本地开发优先用 gh auth login 或 glab auth login，凭证由 CLI 与系统钥匙串管理。

服务端

GitHub App / GitLab Token

持续运行的 Agent 应使用独立应用身份、短周期凭证和明确的仓库范围。

事件驱动

Webhook + API

让 Issue、PR/MR、Pipeline 事件进入你的服务，再按规则触发 Agent 分析或生成评论草稿。

02

按这六步完成第一次接入

把身份、权限、工具边界和验收一起配置，而不是只追求“接口能通”。

01
建立测试仓库
复制一个不含敏感数据的仓库，准备 Issue、保护分支和最小 CI。
02
选择身份类型
个人开发机使用官方 CLI；团队服务使用 App、Bot 或专用服务账号，不共用个人 Token。
03
缩小仓库范围
仅授权指定仓库或项目。Token 只给 read_repository、api 中实际需要的部分，并设置到期时间。
04
登录并验证
分别运行 gh auth status 或 glab auth status，确认 Host、用户与协议正确。
05
封装协作动作
拆分为读 Issue、建分支、开 PR/MR、读检查结果、写评论草稿等工具。
06
启用服务端保护
主分支启用评审、状态检查、禁止强推与合并策略；Agent 不可绕过保护。

03

配置示例

字段和值都是示例占位符，请按你使用的 Agent、平台和密钥管理方式调整。

terminal · CLI 登录示例 · 不含真实密钥

# GitHub
gh auth login
gh auth status
gh repo view OWNER/REPO

# GitLab / self-managed GitLab
glab auth login --hostname gitlab.example.com
glab auth status
glab repo view GROUP/PROJECT

不要把 Token 直接写在 shell 历史、Git remote URL 或仓库文件中。企业 GitLab 请确认 hostname 与实例证书。

04

最小权限建议

把读取、草稿和高影响动作分开，避免一个 Token 同时拥有全部能力。

动作	默认等级	建议边界
读仓库 / Issue / MR	只读	先开放读取元数据、Diff 与检查结果。
创建分支 / PR / MR	草稿	允许生成 Draft PR/MR，标题与描述必须关联任务。
评论 / 指派 / 标签	确认	对外可见或改变协作状态的动作先预览。
合并 / 关闭 / 删除分支	确认	必须满足评审和 CI，并由人确认目标分支。