name: gh-cli description: >- GitHub CLI (gh): аутентификация, репозитории, issues, PR, проверки, просмотр и перезапуск workflow runs, работа с gh api. Используй при отладке CI, работе с PR/issue из терминала, скриптах вокруг GitHub, когда пользователь упоминает gh, GitHub CLI или gh в shell.

GitHub CLI (gh)

Установка и вход

• Установка: cli.github.com или пакетный менеджер ОС.
• gh auth login — выбрать github.com, протокол HTTPS/SSH, способ (браузер или token).
• gh auth status — какой хост/аккаунт активен. gh auth token — для скриптов (осторожно с логами).

Репозиторий и контекст

• gh repo view / gh repo view owner/name — описание, default branch, URL.
• В каталоге с git remote origin — контекст по умолчанию; иначе -R owner/repo.

Issues и PR

• gh issue list / gh issue view <n> / gh issue create.
• gh pr list / gh pr view / gh pr create / gh pr merge (флаги по политике репо).
• gh pr checks — статусы checks по текущему/указанному PR.

Actions (CI)

• gh run list — недавние runs; gh run list --workflow=<name.yml>.
• gh run view <id> — логи, шаги; --log / --log-failed для вывода.
• gh run rerun <id> / gh run download <id> (артефакты, если права).
• gh workflow list / gh workflow run <name> (ручной запуск при workflow_dispatch).

Низкоуровневый API

• gh api — GraphQL/REST, например gh api user, gh api repos/{owner}/{repo}/....
• Удобно для автоматизации, чего нет в подкомандах; смотри REST / схемы.

Скрипты и CI

• В GitHub Actions job с gh: обычно GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + gh ... (или gh api), права permissions сузить, но дать нужное (например pull-requests: write).

Связь с GHA

• Правка YAML — см. skill github-actions-templates; gh — для проверки прогонов и PR с машины.