用途:在 GitHub Actions 工作流需要使用 Mac Studio(Apple Silicon / arm64)上的仓库专用 self-hosted runner 时,提供标签(label)命名规约与检查清单。适用场景包括:bootstrap 时套用 CI = Mac Studio self-hosted、新建或修改 .github/workflows/*.yml、为 reusable workflow 内 job 决定 runs-on,以及 self-hosted job 一直排队不前进时排查。
主要能力与规约:一份 repo 对应一个 runner 进程,以 <repo-slug> 标签从 workflow 指定 runner。命名上,<repo-slug> 为 GitHub 仓库名(kebab-case,如 gitdoc-v2、hacksaw-shop);<label> 与 <repo-slug> 相同;<runner-name> 为 macstudio-<repo-slug>;config.sh 的 labels 为 self-hosted,macOS,ARM64,<repo-slug>;workflow 的 runs-on 必须写作 [self-hosted, <repo-slug>]。
使用方式:SKILL.md 仅作入口,详细内容需阅读 references 下的对应文件:runs-on 写法与 reusable workflow 见 workflow-runs-on-label.md;merge 前确认与故障排查见 runner-prerequisites.md;cache bootstrap 与 mise 拆分由同级技能 kf-g-github-actions-self-hosted-ci-cache 负责。runner 二进制的 install、launchd、token 获取以 host 运维 README 为正本,路径为 ~/projects/_github-selfhosted-actions-runner/README.md。
检查要点:host 侧 runner 注册需先于 workflow merge;所有在 self-hosted 上运行的 job(含 reusable 内)都必须使用 runs-on: [self-hosted, <repo-slug>];确认 runner 的 --labels 中含 <repo-slug>(Settings → Actions → Runners);如需 cache 优化,检查是否存在同级技能的 bootstrap step。
限制:1 个 runner 进程同时只跑 1 个 job;同一 repo 内多个 job 在单台 runner 上会排队等待;不同 repo 各自独立进程时可并行(例如 gitdoc-v2 与 hacksaw-shop 同时 CI)。