# 快速入門

> 在 Skipbox 上執行你的第一個 GitHub Actions 作業：登入、安裝 App、改一行 runs-on，然後推送。

你需要一個在 GitHub 組織或個人帳號上的儲存庫，公開或私有都可以，而且 `.github/workflows` 裡至少有一個工作流程。這些步驟只要幾分鐘，免費試用也不需信用卡。

## 1. 使用 GitHub 登入

開啟 [skipbox.dev](https://skipbox.dev/?lang=zh-Hant)，使用 GitHub 登入。登入不會收取任何費用。

## 2. 安裝 Skipbox App

Skipbox 會顯示兩個安裝按鈕。選擇你要執行作業的帳號所對應的那一個：

- **組織：** 安裝 **Skipbox CI** App。由組織的擁有者安裝。如果你不是擁有者，GitHub 會把你的申請送給擁有者，完成安裝的擁有者要登入 Skipbox 一次。
- **你的個人帳號：** 安裝 **Skipbox (personal)** App。

接著 GitHub 會問這個 App 可以使用所有儲存庫，還是只能使用部分儲存庫。Skipbox 可以執行公開和私有儲存庫的作業；如果組織有公開儲存庫，請允許 Skipbox 使用公開儲存庫一次（儲存庫頁面上的按鈕），因為在擁有者允許之前，GitHub 會讓自架 Runner 遠離公開儲存庫。請見[組織和個人帳號](https://docs.skipbox.dev/zh-hant/accounts)和 [GitHub App 權限](https://docs.skipbox.dev/zh-hant/permissions)。

## 3. 修改一個作業的 runs-on

開啟一個工作流程檔案，把一個作業的 `runs-on` 設為 `skipbox`：

```yaml
jobs:
  test:
    runs-on: skipbox
    steps:
      - uses: actions/checkout@v4
      - run: make test
```

你的控制台會列出儲存庫，每個工作流程都有**在 GitHub 上編輯**的連結，讓你在 GitHub 的編輯器裡修改。或者按儲存庫旁的**開啟 Pull Request**：GitHub 會先請你在那個儲存庫上安裝 Skipbox Migrate App（[GitHub App 權限](https://docs.skipbox.dev/zh-hant/permissions)），接著 Skipbox 會開一個替你修改 `runs-on` 行的 Pull Request。合併它，然後跳過步驟 4。

## 4. Commit 並推送

commit 這個修改。這個作業的下一次執行就會在 Skipbox 上進行，並顯示在你的控制台上。你的免費試用從這第一個作業開始：為期 7 天或 3,000 作業分鐘，以先到者為準。請見[免費試用](https://docs.skipbox.dev/zh-hant/trial)。

## 改回 GitHub 的 Runner

把 `runs-on` 改回原本的值，例如 `ubuntu-latest`，然後 commit。Skipbox 沒有改動你儲存庫裡的其他任何東西。

## 接下來可以讀

- 讓 AI 程式設計代理移動其餘的作業：[用 AI 程式設計代理設定](https://docs.skipbox.dev/zh-hant/ai-agents)。
- 更大的 VM：[標籤和規格](https://docs.skipbox.dev/zh-hant/labels)。
- VM 裡安裝了什麼：[Runner 映像檔](https://docs.skipbox.dev/zh-hant/runner-image)。
- 沒有啟動的作業：[作業一直在排隊](https://docs.skipbox.dev/zh-hant/job-queued)。

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