菜单
Use the GitHub CLI (gh) for PRs, repos, search, releases, and API access from the terminal. Use when attempting to get information about other repos or about PRs in this repo.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Advanced Jest test modes in the Commons monorepo — /local/ tests, watch mode, live console output, multi-file batching, and test-failure troubleshooting. For routine "run the test for this file" resolution, call the nx-project-for-file tool instead.
Use Graphite CLI (gt) for stacked PRs and branch management. Use when creating branches, committing changes, submitting PRs, syncing with trunk, or managing stacked pull requests.
Investigate data-integrity / "why does this data look wrong" questions in the Commons codebase (mismatched IDs, orphaned rows, cross-entity divergence, unexpected duplicates, values that don't agree across tables). Use when a ticket or user asks WHY a piece of data is in a surprising state and you must trace it to a root cause through code + production data. Pairs with the commons-sql-query skill for the SQL itself.
Advanced lint/format modes in the Commons monorepo — git-affected linting across a stack, auto-fix, and the full-CI lint pipeline. For routine "lint this file's project" resolution, call the nx-project-for-file tool instead.
Build administrative CRUD interfaces in the Commons admin panel following established patterns for list, create, and edit views.
Create job files in the Commons monorepo. Use when the user wants to create a new job, backfill script, cache job, export job, sync job, bulk operation, cron task, or any background task that runs via HTTP POST endpoint.
| name | github-cli |
| description | Use the GitHub CLI (gh) for PRs, repos, search, releases, and API access from the terminal. Use when attempting to get information about other repos or about PRs in this repo. |
How to use the GitHub CLI (gh) for common GitHub workflows from the terminal.
brew install gh
Check: gh --version
Authenticate with GitHub so gh can access your account and repos.
Interactive login (browser):
gh auth login
Follow prompts: choose host (github.com or Enterprise), protocol (HTTPS or SSH), and complete the browser flow. The token is stored in the system credential store.
Other auth commands:
| Command | Purpose |
|---|---|
gh auth status | Show current auth and token location |
gh auth logout | Remove stored credentials |
gh auth refresh | Refresh expired token |
gh auth token | Print the current token (for piping) |
gh auth switch | Switch between accounts |
Minimum token scopes for normal use: repo, read:org, gist. Use gh auth login -s <scope> to request more.
Most commands run in the context of the current directory’s git repo. To target another repo without cd:
gh issue list -R owner/repo
# or set once:
export GH_REPO=owner/repo
Placeholders {owner} and {repo} in gh api endpoints are filled from the current repo or GH_REPO.
| Area | Commands | Reference |
|---|---|---|
| Pull requests (list, merge, etc.) | gh pr | references/prs.md |
| Repo, branches, commits, files | gh repo, gh api | references/repo.md |
| Search (issues, PRs, repos, code) | gh search | references/search.md |
Open the linked file for the specific commands and flags.