# 用 AI 程式設計代理設定

> 讓 Claude Code、Codex、Cursor 或其他 AI 程式設計代理把你的 GitHub Actions 作業移到 Skipbox：安裝技能、提出要求，再審查 Pull Request。

你的 AI 程式設計代理可以把 GitHub Actions 作業移到 Skipbox。你負責安裝 GitHub App。代理會找出值得移過來的作業、修改它們的 `runs-on` 那一行、補上每個作業需要的設定步驟，再開一個 Pull Request 讓你審查。

## 安裝技能

技能是 GitHub 上 [skipbox-dev/skills](https://github.com/skipbox-dev/skills) 裡的一個 Markdown 檔案。它告訴代理該移哪些作業、有哪些標籤和規格、Runner 映像檔裡有什麼，以及作業失敗或一直排隊時怎麼修。安裝方式有三種。

用 skills.sh，適用 Claude Code、Codex、Cursor 和其他代理：

```bash
npx skills add skipbox-dev/skills
```

當成 Claude Code 外掛程式。先加入 marketplace：

```text
/plugin marketplace add skipbox-dev/skills
```

再安裝外掛程式：

```text
/plugin install skipbox@skipbox-skills
```

手動安裝：把 [`SKILL.md`](https://github.com/skipbox-dev/skills/blob/main/skills/skipbox-github-runners/SKILL.md) 複製到代理的 skills 或 rules 資料夾。以 Claude Code 來說，路徑是：

```text
.claude/skills/skipbox-github-runners/SKILL.md
```

## 向代理提出要求

在代理中開啟儲存庫，用你自己的話提出要求：

```text
把我們的 Linux CI 作業移到 Skipbox，並開一個 Pull Request
我們的哪些工作流程在 GitHub Actions 上花最多錢？哪些應該移過去？
這個作業在 Skipbox 上失敗，顯示「command not found」：請修好它
這個作業移到 Skipbox 之後就一直在排隊：請找出原因
```

代理會先從一個作業開始，所以第一次執行就能看出是否缺少某個工具。macOS、Windows 和 Arm 的作業，它會留在 GitHub 的 Runner 上。

## 這兩件事由你來做

- **登入並安裝 Skipbox App。** 在擁有儲存庫的帳號上完成[快速入門](https://docs.skipbox.dev/zh-hant/quickstart)的步驟 1 和 2。組織和個人帳號各該安裝哪個 App，請見[組織和個人帳號](https://docs.skipbox.dev/zh-hant/accounts)。
- **選擇方案。** 免費試用不需信用卡，從第一個作業開始：為期 7 天或 3,000 作業分鐘，以先到者為準。試用結束後，由你選擇方案。請見[方案](https://docs.skipbox.dev/zh-hant/plans)。

在這個做法裡，Skipbox 不會修改你的工作流程：修改就是代理開的那個 Pull Request，由你合併。如果想讓 Skipbox 替你開這個 Pull Request，請在帳號頁面上按儲存庫旁的**開啟 Pull Request**（請見 [GitHub App 權限](https://docs.skipbox.dev/zh-hant/permissions)）。

## 沒有技能時

這份說明文件的每個頁面也有 Markdown 版本：在網址後面加上 `.md`。所有頁面的清單在 `https://docs.skipbox.dev/llms.txt`。沒有技能的代理可以直接閱讀說明文件，從這幾頁開始：

- 步驟：[快速入門](https://docs.skipbox.dev/zh-hant/quickstart)。
- 該寫哪個標籤：[標籤和規格](https://docs.skipbox.dev/zh-hant/labels)。
- VM 裡安裝了什麼：[Runner 映像檔](https://docs.skipbox.dev/zh-hant/runner-image)。
- 在 GitHub 的 Runner 上通過、在這裡失敗的作業：[移過來後作業失敗](https://docs.skipbox.dev/zh-hant/migration)。

試用期間的標籤是 `skipbox`。其他問題請寫信到 hello@skipbox.dev。

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