菜单
Use whenever running GitHub CLI (`gh`) or GitHub HTTPS git push from this repo, including PR creation, PR merge, PR checks, issues, Actions, or branch publishing. Enforces repo-local `.env` `GH_TOKEN` injection into the child process without mutating global `gh` auth state.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when adding or changing features that affect lifecycle phases, service startup/shutdown, EventBus/IPC boundaries, shared state ownership, background processes, or cross-module responsibilities.
MANDATORY rules for adding or changing any AppConfig field (data layer only — independent of whether a settings-screen UI is involved). Covers AppConfig type, CONFIG_METADATA, CONFIG_KEYS, DEFAULT_CONFIG registration and persistence model.
Pipeline instructions for creating events, subscribing via EventBus, and syncing with the Renderer (React) via IPC.
Use when changing anything under src/main/kakao/ (login/launch automation, PageHandler selectors, SecurityCenter, visibility policy, page dumps, maintenance detection) or the KakaoGames starter/UAC path (src/main/utils/uac/kakao-game-starter.ts, uac-migration.ts). Third-party-DOM selector policy and real-user blast radius rules.
Use when a user says a feature, bug fix, experiment, or follow-up can wait, should be done later, belongs on the roadmap/backlog, or asks to add/update roadmap items. Two tracks — user-visible product changes go to docs/Roadmap.md (CI-synced to GitHub Issue
Declarative pipeline for rendering and wiring settings-SCREEN UI items (settings-config.ts items, Context API hooks, no-hardcoding rule). For the underlying AppConfig data-layer registration, use config-management first.
| name | github-cli-token |
| description | Use whenever running GitHub CLI (`gh`) or GitHub HTTPS git push from this repo, including PR creation, PR merge, PR checks, issues, Actions, or branch publishing. Enforces repo-local `.env` `GH_TOKEN` injection into the child process without mutating global `gh` auth state. |
Use this skill before any repo-local gh command or GitHub HTTPS push.
gh auth switch or gh auth login for repo-local work; those commands mutate shared GitHub CLI state..env may contain GH_TOKEN, but gh does not load .env automatically..env or token values. Check only whether GH_TOKEN exists.GH_TOKEN into the command environment, not just a shell variable.Correct:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')" gh pr view 200
Wrong:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')"; gh pr view 200
The wrong form creates a shell variable only. Unless it is exported, the gh
child process falls back to global auth and may fail with misleading permission
errors such as Resource not accessible by personal access token.
Create a PR:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')" gh pr create \
--base master \
--head "$(git branch --show-current)" \
--title "<title>" \
--body "<body>"
Check PR status:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')" gh pr checks <pr-number> --watch=false
Squash merge a PR:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')" gh pr merge <pr-number> \
--squash \
--delete-branch \
--subject "<commit title>" \
--body "<commit body>"
If git push fails because global Git credentials are different from the
repo-local token, inject the token only for that push:
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')"
AUTH_HEADER="AUTHORIZATION: basic $(printf 'x-access-token:%s' "$GH_TOKEN" | base64 -w0)"
git -c http.https://github.com/.extraheader="$AUTH_HEADER" push -u origin "$(git branch --show-current)"
unset GH_TOKEN AUTH_HEADER
To compare auth contexts without changing them:
gh auth status -h github.com
GH_TOKEN="$(grep '^GH_TOKEN=' .env | cut -d= -f2- | tr -d '\r')" gh auth status -h github.com
If the inline GH_TOKEN=... gh ... form still fails, treat it as a real token
scope or repository permission problem. If only the non-inline form fails, fix
the command invocation before investigating permissions.