# GitHub App 權限

> Skipbox CI、Skipbox (personal) 和選用的 Skipbox Migrate 這幾個 App 要求的每項權限、Skipbox 用它們做什麼，以及 Runner App 不要求哪些權限。

## Skipbox CI（組織）

| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Organization: Self-hosted runners | Read and write | 為每個需要 Runner 的作業新增一個 Runner，作業結束時移除 |
| Repository: Actions | Read and write | 得知作業何時在等候 Runner、在控制台上列出你的作業、讀取最近 30 天的執行來推薦方案，並重新執行 Skipbox 機器在作業途中停止的作業 |
| Repository: Metadata | Read | 儲存庫名稱，以及啟動執行的人的權限（你的專屬機器只執行你團隊的程式碼） |
| Account: Email addresses | Read | 你的電子郵件地址，用於試用和帳單的通知信 |

這個 App 無法讀取你的程式碼。每個作業會在自己的 VM 裡自行 checkout 你的程式碼。

## Skipbox (personal)

| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Repository: Administration | Read and write | 為單一作業在作業所屬的儲存庫上新增一個 Runner，作業結束時移除 |
| Repository: Actions | Read and write | 和上面相同，並在控制台上顯示你的工作流程檔案 |
| Repository: Metadata | Read | 儲存庫名稱，以及啟動執行的人的權限（你的專屬機器只執行你團隊的程式碼） |

在個人帳號上，GitHub 只允許擁有 Administration 權限的 App 在儲存庫上註冊 Runner。這項權限也涵蓋儲存庫的設定、協作者和部署金鑰。Skipbox 只用它呼叫 Runner 的端點。

## Skipbox Migrate（選用）

第三個 App，只用於帳號頁面上的**開啟 Pull Request**。你只需要把它安裝在自己選的儲存庫上，也可以不裝：改成複製提示給你的程式設計代理。

| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Repository: Contents | Read and write | 讀取 `.github/workflows` 裡的檔案，並把修改過的檔案 commit 到 `skipbox/run-ci-on-skipbox` 分支 |
| Repository: Workflows | Read and write | 修改 `.github/workflows` 裡的任何檔案時，GitHub 都會要求這項權限 |
| Repository: Pull requests | Read and write | 從那個分支開一個標題為「Run CI on Skipbox」的 Pull Request，或更新已經開著的那一個 |
| Repository: Metadata | Read | 儲存庫的預設分支 |

這個 Pull Request 只會修改控制台推薦的作業的 `runs-on:` 行，說明中會列出每個作業的舊標籤和新標籤。Skipbox 絕不會推送到你的預設分支或任何其他分支，也絕不會合併：在你合併之前，什麼都不會改變。它只修改原本是 GitHub 託管 Ubuntu 標籤的那一行。`runs-on` 是其他標籤或運算式（例如矩陣的值）的作業，以及呼叫可重複使用工作流程的作業，會列在說明中，讓你手動修改。所有作業都在 Skipbox 上執行後，你就可以解除安裝它。

## Skipbox CI 和 Skipbox (personal) 不要求的權限

Contents、Workflows、Secrets 和 Pull requests。這兩個 App 絕不會修改工作流程、絕不推送，也絕不開 Pull Request；只有在你按**開啟 Pull Request** 時，Skipbox Migrate 才會這麼做。Actions 的寫入只用來重新執行 Skipbox 機器在作業途中停止的作業：不會啟動其他任何執行，也不會取消任何執行。

## 作業的 VM 裡有什麼

和任何 Runner 一樣，GitHub 會把你的程式碼、工作流程傳給作業的 secrets，以及這個作業的權杖送到作業的 VM。作業執行的程式碼可以讀取它們。它們只留在那台 VM 裡：全新的 VM 會連同它們一起刪除，你的專屬機器則在每個作業後刪除 Runner 的憑證和作業 checkout 中的權杖。從 2026 年 11 月 13 日起，checkout 本身會留在那裡，供組織之後的作業使用；開啟「每個作業都用新 VM」，每個作業就會用一台全新的機器。請見 [VM 隔離](https://docs.skipbox.dev/zh-hant/isolation)。

## 變更或移除存取權

在 GitHub 上開啟 App 的 **Configure** 頁面，就能變更它可以使用哪些儲存庫，或解除安裝。請見[取消和解除安裝](https://docs.skipbox.dev/zh-hant/cancel)。

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