# GitHub 应用权限

> Skipbox CI、Skipbox (personal) 和可选的 Skipbox Migrate 应用申请的每一项权限、Skipbox 用每一项做什么，以及运行器应用不申请哪些权限。

## Skipbox CI（组织）

| 权限 | 访问级别 | Skipbox 用它做什么 |
|---|---|---|
| Organization: Self-hosted runners | Read and write | 为每个需要运行器的作业添加一个运行器，作业结束时移除 |
| Repository: Actions | Read and write | 看到作业何时在等它的运行器，在控制台上列出你的作业，读取你最近 30 天的运行来推荐套餐，并重跑在作业中途 Skipbox 机器停止了的作业 |
| Repository: Metadata | Read | 仓库名称，以及启动运行的人的访问权限（你的专属机器只运行你团队的代码） |
| Account: Email addresses | Read | 你的邮箱地址，用于试用和账单邮件 |

这个应用无法读取你的代码。每个作业在它自己的虚拟机里自行检出你的代码。

## Skipbox (personal)

| 权限 | 访问级别 | Skipbox 用它做什么 |
|---|---|---|
| Repository: Administration | Read and write | 为一个作业在作业的仓库上添加一个运行器，作业结束时移除 |
| Repository: Actions | Read and write | 与上面相同，并在控制台上显示你的工作流文件 |
| Repository: Metadata | Read | 仓库名称，以及启动运行的人的访问权限（你的专属机器只运行你团队的代码） |

在个人账号上，GitHub 只允许持有 Administration 权限的应用在仓库上注册运行器。这项权限也涵盖仓库的设置、协作者和部署密钥。Skipbox 用它只调用运行器相关的端点。

## Skipbox Migrate（可选）

第三个应用，只用于你账号页面上的 **“创建拉取请求”**。你只把它安装在你选择的仓库上，也可以不装：改为复制给你编程智能体的提示词即可。

| 权限 | 访问级别 | Skipbox 用它做什么 |
|---|---|---|
| Repository: Contents | Read and write | 读取 `.github/workflows` 中的文件，并把改动过的文件提交到分支 `skipbox/run-ci-on-skipbox` |
| Repository: Workflows | Read and write | 修改 `.github/workflows` 中的任何文件时，GitHub 要求这项权限 |
| Repository: Pull requests | Read and write | 从那个分支创建一个标题为 "Run CI on Skipbox" 的拉取请求，或者更新已经打开的那一个 |
| Repository: Metadata | Read | 仓库的默认分支 |

这个拉取请求只修改你的控制台推荐的作业的 `runs-on:` 行，它的描述列出每个作业的旧标签和新标签。Skipbox 从不推送到你的默认分支或任何其他分支，也从不合并：在你合并之前，什么都不会改变。只有当一行写的是 GitHub 托管的 Ubuntu 标签时，它才会修改这一行。`runs-on` 是其他标签或表达式（比如矩阵值）的作业，以及调用可复用工作流的作业，会列在描述中，由你手动修改。当每个作业都在 Skipbox 上运行后，你就可以卸载它。

## Skipbox CI 和 Skipbox (personal) 不申请的权限

Contents、Workflows、Secrets 和 Pull requests。这两个应用从不修改工作流，从不推送，也从不创建拉取请求；只有 Skipbox Migrate 会这样做，而且是在你按下 **“创建拉取请求”** 时。Actions 的写入权限只用于重跑在作业中途 Skipbox 机器停止了的作业：不会启动其他任何运行，也不会取消任何运行。

## 作业的虚拟机持有什么

和在任何运行器上一样，GitHub 把你的代码、工作流传给作业的密钥，以及这个作业的令牌发送到作业的虚拟机。作业运行的代码可以读取它们。它们留在那台虚拟机里：新的虚拟机连同它们一起删除，你的专属机器在每个作业后删除运行器的凭据和作业检出目录中的令牌。从 2026年11月13日起，检出目录本身留在那里，供你组织之后的作业使用；开启“每个作业用新虚拟机”后，每个作业都在一台新机器上运行。见[虚拟机隔离](https://docs.skipbox.dev/zh-hans/isolation)。

## 修改或移除访问权限

在 GitHub 上打开应用的 **Configure** 页面，修改它可以使用哪些仓库，或者卸载它。见[取消和卸载](https://docs.skipbox.dev/zh-hans/cancel)。

更新于 2026-11-13 · https://docs.skipbox.dev/zh-hans/permissions
