self-hosted-runner-setuplisted
Install: claude install-skill ttamakijp/dev-templates
# self-hosted-runner-setup
## Overview
GitHub Free の private repo は Actions 月 2000 min の制約があり、Android ビルドや
重い test を回すと早期に枠を消化する。ローカルの Windows PC を self-hosted runner
として登録すれば、追加コストゼロで CI を継続できる(PC の電力・寿命負担のみ)。
本 skill は Windows PC 1 台に複数 repo 分の runner を **別ディレクトリ・別名前**
で登録し、Scheduled Task at logon で永続化する非対話手順を提供する。
admin 権限 / Windows サービス登録は不要。
**Keywords**: github actions, self-hosted runner, ci, private repo, free plan,
windows, scheduled task, operations, ADR-0016
## Trigger
### 日本語
- 「self-hosted runner をセットアップ」
- 「GitHub Actions の self-hosted を入れて」
- 「Free 枠の制約を外したい」
- 「private repo の CI をローカル PC で回したい」
- 「`<repo>` 用の runner を Windows PC に追加」
### English
- "set up a self-hosted runner on Windows"
- "register a GitHub Actions runner for `<repo>`"
- "free us from the GitHub Free 2000-minute cap"
- "run private repo CI on my local PC"
## 前提条件
- **OS**: Windows 10 / 11 (x64) または Windows Server 2019+
- **gh CLI**: 認証済 (`gh auth status` で確認) かつ対象 private repo の admin 権限
- **PowerShell**: 5.1+ (Windows 標準) または PowerShell 7+
- **ネットワーク**: 443/tcp で `github.com` / `api.github.com` / `pkg.actions.githubusercontent.com` へ到達可能
- **disk**: 1 runner あたり ~500 MB(runner 本体)+ build artifact 領域
- **対象 repo**: **必ず private**。public repo で fork PR を受ける構成では本 skill を
使用しない(任意コード実行リスク → ADR-0016 ��キュリティ章参照)
## Inputs
| 項目 | 例 | 必須 | 補足 |
|---|---|---|---|
| `OWNER` | `ttamakijp` | 必須 | GitHub owner |
| `REPO` | `tackt` | 必須 | private repo 名 |
| `RUNNER_NAME` | `tackt-windows-1