> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/zh/service-connections/github.md).

# GitHub

连接你的 GitHub 账号，通过对话管理仓库、Issue、Pull Request，甚至直接修改代码。

> **套餐要求：** GitHub 集成仅限 **Pro** 套餐使用。

## 连接 GitHub

Crew 通过一个叫 **Crew Agent** 的 GitHub App 来安全、精细地访问你的仓库。

1. 进入侧边栏的**设置**
2. 滚动到**服务连接**
3. 点击 GitHub 旁边的**连接**
4. 你会跳转到 GitHub，安装 **Crew Agent** 应用
5. 选择要授权访问的仓库（所有仓库，或选择特定的几个）
6. 授权应用——然后你会被带回 Crew

连接成功后，你的 GitHub 用户名会显示在设置页面。

### 为什么用 GitHub App？

Crew Agent GitHub App 提供：

* **精细权限控制** — 只访问你选择的仓库
* **安全的编程代理** — 编程代理可以克隆仓库和创建 PR，无需你的个人访问令牌
* **自动刷新令牌** — 令牌过期时无需重新连接

### 重新连接

如果你需要更改 Crew 可以访问的仓库，在设置页面断开并重新连接 GitHub。重新安装时你可以更新仓库选择。

## 功能介绍

### 仓库管理

> "列出我的 GitHub 仓库。"

> "帮我看看 my-org/my-repo 有哪些未解决的 Issue。"

> "前端仓库最近有哪些 Pull Request？"

### Issue 管理

> "在 my-org/api-server 创建一个 Issue，标题是'修复登录超时问题'，附上 Bug 描述。"

> "列出分配给我的所有 Issue。"

> "关闭后端仓库的 Issue #42。"

### Pull Request

> "帮我看看 design-system 仓库中未合并的 PR。"

> "PR #15 的状态是什么？"

> "帮我写一条 PR 评审评论。"

### 编程代理

**编程代理**可以自主对你的仓库进行实际代码修改：

> "在 my-org/frontend-app 中，修复登录页面的 CSS 对齐问题。提交按钮应该居中。"

> "在 my-org/api-server 中，将认证模块从 Session Cookie 重构为 JWT Token。"

编程代理的工作流程：

1. Crew 在安全环境中克隆你的仓库
2. 自主进行代码修改
3. 将更改提交到新分支
4. 创建一个 Pull Request 供你审查

整个过程在后台运行——你可以继续聊天。PR 准备好后 Crew 会通知你。

## 实用场景

### Bug 分类

> "帮我看看主仓库中所有未关闭的 Bug，按最新排序，总结前5个。"

### 代码审查准备

> "列出需要我审查的未合并 PR，分别总结每个 PR 的变更内容。"

### 快速修复

> "my-org/docs 的 README 有个错别字——把 'recieve' 改成 'receive'，然后创建一个 PR。"

## 注意事项

* 编程代理只会创建分支和 PR——绝不会直接推送到 main 分支
* 你始终需要自己审查并合并代码
* 仓库访问权限由你的 GitHub App 安装配置控制——Crew 只能访问你明确允许的仓库
