GitHub CLI (gh) 命令行工具使用指南 - 安全操作与自动化工作流

cli-gh by paulrberg/agent-skills

265 周安装量

41 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/paulrberg/agent-skills --skill cli-gh

自动化开发运维命令行工具

🇨🇳中文介绍

GitHub CLI (gh)

概述

提供 GitHub CLI (gh) 操作和工作流程的专家指导。使用此技能进行命令行 GitHub 操作，包括拉取请求管理、问题跟踪、仓库操作、工作流自动化和代码空间管理。

核心功能：

在终端中创建和管理拉取请求
高效跟踪和组织问题
跨 GitHub 进行搜索（仓库、问题、PR）
管理标签和项目组织
触发和监控 GitHub Actions 工作流
使用代码空间
自动化仓库操作和发布

安全规则

关键：此技能绝不使用破坏性的 gh CLI 操作。

此技能仅专注于安全、只读或可逆的 GitHub 操作。以下命令被禁止，且绝不允许使用：

永久性破坏性命令：

gh repo delete - 仓库删除
gh repo archive - 仓库归档
gh release delete - 发布删除
gh release delete-asset - 资产删除
gh run delete - 工作流运行删除

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

261,300 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

104,600 周安装

gh cache delete - 缓存删除

gh secret delete - 密钥删除

gh variable delete - 变量删除

gh label delete - 标签删除

gh ssh-key delete - SSH 密钥删除（可能导致用户被锁定）

gh gpg-key delete - GPG 密钥删除

gh codespace delete - 代码空间删除

gh extension remove - 扩展移除

gh gist delete - Gist 删除

使用 xargs 结合任何破坏性命令进行批量删除操作

Shell 命令：rm -rf（临时文件清理除外）

允许的操作：

创建资源（PR、问题、发布、标签、仓库）
查看和列出（状态、日志、信息、搜索）
更新和编辑现有资源
关闭 PR/问题（可逆 - 可以重新打开）
取消工作流运行（停止执行而不删除数据）
合并拉取请求（经过适当审查后）
只读 git 操作（git status、git log、git diff）

# 登录 GitHub
gh auth login

# 检查认证状态
gh auth status

# 配置 git 使用 gh 作为凭证助手
gh auth setup-git

# 交互式创建 PR
gh pr create

# 使用标题和正文创建 PR
gh pr create --title "Add feature" --body "Description"

# 创建到特定分支的 PR
gh pr create --base main --head feature-branch

# 创建草稿 PR
gh pr create --draft

# 从当前分支创建 PR
gh pr create --fill  # 使用提交信息

# 列出 PR
gh pr list

# 列出我的 PR
gh pr list --author @me

# 查看 PR 详情
gh pr view 123

# 在浏览器中查看 PR
gh pr view 123 --web

# 查看 PR 差异
gh pr diff 123

# 检查 PR 状态
gh pr status

# 在本地检出 PR
gh pr checkout 123

# 评审 PR
gh pr review 123 --approve
gh pr review 123 --comment --body "Looks good!"
gh pr review 123 --request-changes --body "Please fix X"

# 合并 PR
gh pr merge 123
gh pr merge 123 --squash
gh pr merge 123 --rebase
gh pr merge 123 --merge

# 关闭 PR
gh pr close 123

# 重新打开 PR
gh pr reopen 123

# 将草稿 PR 标记为就绪
gh pr ready 123

# 使用基础分支更新 PR 分支
gh pr update-branch 123

# 查看 PR 检查
gh pr checks 123

# 监视 PR 检查
gh pr checks 123 --watch

# 交互式创建问题
gh issue create

# 使用标题和正文创建问题
gh issue create --title "Bug report" --body "Description"

# 使用标签创建问题
gh issue create --title "Bug" --label bug,critical

# 分配问题
gh issue create --title "Task" --assignee @me

# 列出问题
gh issue list

# 列出我的问题
gh issue list --assignee @me

# 按标签列出
gh issue list --label bug

# 查看问题详情
gh issue view 456

# 在浏览器中查看
gh issue view 456 --web

# 关闭问题
gh issue close 456

# 重新打开问题
gh issue reopen 456

# 编辑问题
gh issue edit 456 --title "New title"
gh issue edit 456 --add-label bug
gh issue edit 456 --add-assignee @user

# 评论问题
gh issue comment 456 --body "Update"

# 创建分支来处理问题
gh issue develop 456 --checkout

# 查看仓库
gh repo view

# 在浏览器中查看
gh repo view --web

# 克隆仓库
gh repo clone owner/repo

# 复刻仓库
gh repo fork owner/repo

# 列出仓库
gh repo list owner

# 创建仓库
gh repo create my-repo --public
gh repo create my-repo --private

# 同步复刻
gh repo sync owner/repo

# 设置默认仓库
gh repo set-default

跨整个 GitHub 搜索仓库、问题和拉取请求。

# 搜索仓库
gh search repos "machine learning" --language=python

# 使用过滤器搜索
gh search repos --stars=">1000" --topic=kubernetes

# 跨 GitHub 搜索问题
gh search issues "bug" --label=critical --state=open

# 排除结果（注意使用 -- 以防止标志被解释）
gh search issues -- "memory leak -label:wontfix"

# 搜索 PR
gh search prs --author=@me --state=open

# 使用日期过滤器搜索
gh search prs "refactor" --created=">2024-01-01"

管理仓库标签，用于组织和分类问题与 PR。

列出和查看标签

# 列出仓库中的所有标签
gh label list

创建和编辑标签

# 创建新标签
gh label create "priority: high" --color FF0000 --description "High priority items"

# 编辑现有标签
gh label edit "bug" --color FFAA00 --description "Something isn't working"

在仓库间克隆标签

# 从另一个仓库克隆标签
gh label clone owner/source-repo

直接从终端管理 GitHub 代码空间。

列出和创建代码空间

# 列出代码空间
gh codespace list

# 创建新代码空间
gh codespace create --repo owner/repo

连接到代码空间

# SSH 进入代码空间
gh codespace ssh

# 在 VS Code 中打开
gh codespace code

# 在 JupyterLab 中打开
gh codespace jupyter

管理代码空间文件

# 复制文件到/从代码空间
gh codespace cp local-file.txt remote:~/path/
gh codespace cp remote:~/path/file.txt ./local-dir/

# 查看日志
gh codespace logs

# 创建发布
gh release create v1.0.0

# 创建带说明的发布
gh release create v1.0.0 --notes "Release notes"

# 创建带文件的发布
gh release create v1.0.0 dist/*.tar.gz

# 创建草稿发布
gh release create v1.0.0 --draft

# 自动生成发布说明
gh release create v1.0.0 --generate-notes

# 列出发布
gh release list

# 查看发布
gh release view v1.0.0

# 下载发布资产
gh release download v1.0.0

# 创建 gist
gh gist create file.txt

# 从标准输入创建 gist
echo "content" | gh gist create -

# 列出 gists
gh gist list

# 查看 gist
gh gist view <gist-id>

# 编辑 gist
gh gist edit <gist-id>

# 设置默认编辑器
gh config set editor vim

# 设置默认 git 协议
gh config set git_protocol ssh

# 查看配置
gh config list

# 设置浏览器
gh config set browser firefox

常见 gh 操作一览：

操作	命令	常用标志
创建 PR	`gh pr create`	`--draft`, `--fill`, `--base`, `--title`
列出 PR	`gh pr list`	`--author @me`, `--label`, `--state`
查看 PR	`gh pr view <number>`	`--web`, `--comments`
合并 PR	`gh pr merge <number>`	`--squash`, `--rebase`, `--delete-branch`
创建问题	`gh issue create`	`--title`, `--body`, `--label`
列出问题	`gh issue list`	`--assignee @me`, `--label`, `--state`
查看问题	`gh issue view <number>`	`--web`, `--comments`
克隆仓库	`gh repo clone <repo>`	`--` （用于传递 git 标志）
复刻仓库	`gh repo fork`	`--clone`, `--remote`
查看仓库	`gh repo view`	`--web`
创建发布	`gh release create <tag>`	`--title`, `--notes`, `--draft`
运行工作流	`gh workflow run <name>`	`--ref`, `--field`
监视运行	`gh run watch <id>`	`--exit-status`
搜索仓库	`gh search repos <query>`	`--language`, `--stars`
创建标签	`gh label create <name>`	`--color`, `--description`
创建代码空间	`gh codespace create`	`--repo`, `--branch`
SSH 到代码空间	`gh codespace ssh`	`--codespace`

有关详细模式和高级用法，请参阅：

工作流与 Actions - GitHub Actions 工作流、运行、缓存管理和 CI/CD 集成模式
高级功能 - 别名、API 访问、扩展、密钥、SSH/GPG 密钥、组织、项目和高级脚本
自动化工作流 - 常见自动化模式、每日报告、发布自动化以及团队协作工作流
故障排除 - 认证、权限、速率限制和常见错误的解决方案

实用的自动化脚本（参见 examples/ 目录）：

auto-pr-create.sh - 自动化 PR 创建工作流
issue-triage.sh - 批量问题标签和分配
workflow-monitor.sh - 监视并通知工作流完成情况
release-automation.sh - 完整的发布工作流自动化

使用 --json 标志获取结构化输出。始终使用 --help 验证字段名，因为它们与 GitHub API 名称不同。

# 检查任何命令可用的 JSON 字段
gh repo view --help | grep -A 50 "JSON FIELDS"
gh pr list --help | grep -A 50 "JSON FIELDS"

常见 JSON 字段更正

错误（API 风格）	正确（gh CLI）
`stargazersCount`	`stargazerCount`
`forksCount`	`forkCount`
`watchersCount`	`watchers`
`openIssuesCount`	`issues`

# gh repo view --json 的常用字段
gh repo view owner/repo --json name,description,stargazerCount,forkCount,updatedAt,url,readme

使用 --web 标志在浏览器中打开项目以查看详细信息
通过省略参数来利用交互式提示 - 大多数命令支持交互模式
使用 --author、--label、--state 应用过滤器以高效缩小列表范围
添加 --json 标志以启用可脚本化的输出，便于自动化
始终检查 --help 以获取有效的 JSON 字段名 - 它们与 GitHub API 不同
使用 gh repo create --template 从模板仓库搭建项目结构
使用 gh pr merge --auto 为通过检查的 PR 启用自动合并

🇺🇸English

GitHub CLI (gh)

Overview

Expert guidance for GitHub CLI (gh) operations and workflows. Use this skill for command-line GitHub operations including pull request management, issue tracking, repository operations, workflow automation, and codespace management.

Key capabilities:

Create and manage pull requests from the terminal
Track and organize issues efficiently
Search across all of GitHub (repos, issues, PRs)
Manage labels and project organization
Trigger and monitor GitHub Actions workflows
Work with codespaces
Automate repository operations and releases

Safety Rules

CRITICAL: This skill NEVER uses destructive gh CLI operations.

This skill focuses exclusively on safe, read-only, or reversible GitHub operations. The following commands are PROHIBITED and must NEVER be used:

Permanently destructive commands:

gh repo delete - Repository deletion
gh repo archive - Repository archival
gh release delete - Release deletion
gh release delete-asset - Asset deletion
gh run delete - Workflow run deletion
gh cache delete - Cache deletion
gh secret delete - Secret deletion
gh variable delete - Variable deletion
gh label delete - Label deletion
gh ssh-key delete - SSH key deletion (can lock out users)
gh gpg-key delete - GPG key deletion
gh codespace delete - Codespace deletion
gh extension remove - Extension removal
gh gist delete - Gist deletion
Bulk deletion operations using xargs with any destructive commands
Shell commands: rm -rf (except for temporary file cleanup)

Allowed operations:

Creating resources (PRs, issues, releases, labels, repos)
Viewing and listing (status, logs, information, searches)
Updating and editing existing resources
Closing PRs/issues (reversible - can be reopened)
Canceling workflow runs (stops execution without deleting data)
Merging pull requests (after proper review)
Read-only git operations (git status, git log, git diff)

Installation & Setup

# Login to GitHub
gh auth login

# Check authentication status
gh auth status

# Configure git to use gh as credential helper
gh auth setup-git

Pull Requests

Creating PRs

# Create PR interactively
gh pr create

# Create PR with title and body
gh pr create --title "Add feature" --body "Description"

# Create PR to specific branch
gh pr create --base main --head feature-branch

# Create draft PR
gh pr create --draft

# Create PR from current branch
gh pr create --fill  # Uses commit messages

Viewing PRs

# List PRs
gh pr list

# List my PRs
gh pr list --author @me

# View PR details
gh pr view 123

# View PR in browser
gh pr view 123 --web

# View PR diff
gh pr diff 123

# Check PR status
gh pr status

Managing PRs

# Checkout PR locally
gh pr checkout 123

# Review PR
gh pr review 123 --approve
gh pr review 123 --comment --body "Looks good!"
gh pr review 123 --request-changes --body "Please fix X"

# Merge PR
gh pr merge 123
gh pr merge 123 --squash
gh pr merge 123 --rebase
gh pr merge 123 --merge

# Close PR
gh pr close 123

# Reopen PR
gh pr reopen 123

# Ready draft PR
gh pr ready 123

# Update PR branch with base branch
gh pr update-branch 123

PR Checks

# View PR checks
gh pr checks 123

# Watch PR checks
gh pr checks 123 --watch

Issues

Creating Issues

# Create issue interactively
gh issue create

# Create issue with title and body
gh issue create --title "Bug report" --body "Description"

# Create issue with labels
gh issue create --title "Bug" --label bug,critical

# Assign issue
gh issue create --title "Task" --assignee @me

Viewing Issues

# List issues
gh issue list

# List my issues
gh issue list --assignee @me

# List by label
gh issue list --label bug

# View issue details
gh issue view 456

# View in browser
gh issue view 456 --web

Managing Issues

# Close issue
gh issue close 456

# Reopen issue
gh issue reopen 456

# Edit issue
gh issue edit 456 --title "New title"
gh issue edit 456 --add-label bug
gh issue edit 456 --add-assignee @user

# Comment on issue
gh issue comment 456 --body "Update"

# Create branch to work on issue
gh issue develop 456 --checkout

Repository Operations

Repository Info

# View repository
gh repo view

# View in browser
gh repo view --web

# Clone repository
gh repo clone owner/repo

# Fork repository
gh repo fork owner/repo

# List repositories
gh repo list owner

Repository Management

# Create repository
gh repo create my-repo --public
gh repo create my-repo --private

# Sync fork
gh repo sync owner/repo

# Set default repository
gh repo set-default

Search

Search across all of GitHub for repositories, issues, and pull requests.

Search Repositories

# Search for repositories
gh search repos "machine learning" --language=python

# Search with filters
gh search repos --stars=">1000" --topic=kubernetes

Search Issues

# Search issues across GitHub
gh search issues "bug" --label=critical --state=open

# Exclude results (note the -- to prevent flag interpretation)
gh search issues -- "memory leak -label:wontfix"

Search Pull Requests

# Search PRs
gh search prs --author=@me --state=open

# Search with date filters
gh search prs "refactor" --created=">2024-01-01"

Labels

Manage repository labels for issue and PR organization.

List and View Labels

# List all labels in repository
gh label list

Create and Edit Labels

# Create new label
gh label create "priority: high" --color FF0000 --description "High priority items"

# Edit existing label
gh label edit "bug" --color FFAA00 --description "Something isn't working"

Clone Labels Between Repos

# Clone labels from another repository
gh label clone owner/source-repo

Codespaces

Manage GitHub Codespaces directly from the terminal.

List and Create Codespaces

# List codespaces
gh codespace list

# Create new codespace
gh codespace create --repo owner/repo

Connect to Codespaces

# SSH into codespace
gh codespace ssh

# Open in VS Code
gh codespace code

# Open in JupyterLab
gh codespace jupyter

Manage Codespace Files

# Copy files to/from codespace
gh codespace cp local-file.txt remote:~/path/
gh codespace cp remote:~/path/file.txt ./local-dir/

# View logs
gh codespace logs

Releases

Creating Releases

# Create release
gh release create v1.0.0

# Create release with notes
gh release create v1.0.0 --notes "Release notes"

# Create release with files
gh release create v1.0.0 dist/*.tar.gz

# Create draft release
gh release create v1.0.0 --draft

# Generate release notes automatically
gh release create v1.0.0 --generate-notes

Managing Releases

# List releases
gh release list

# View release
gh release view v1.0.0

# Download release assets
gh release download v1.0.0

Gists

# Create gist
gh gist create file.txt

# Create gist from stdin
echo "content" | gh gist create -

# List gists
gh gist list

# View gist
gh gist view <gist-id>

# Edit gist
gh gist edit <gist-id>

Configuration

# Set default editor
gh config set editor vim

# Set default git protocol
gh config set git_protocol ssh

# View configuration
gh config list

# Set browser
gh config set browser firefox

Quick Reference

Common gh operations at a glance:

Operation	Command	Common Flags
Create PR	`gh pr create`	`--draft`, `--fill`, `--base`, `--title`
List PRs	`gh pr list`	`--author @me`, `--label`,

Additional Resources

Reference Guides

For detailed patterns and advanced usage, see:

Workflows& Actions - GitHub Actions workflows, runs, cache management, and CI/CD integration patterns
Advanced Features - Aliases, API access, extensions, secrets, SSH/GPG keys, organizations, projects, and advanced scripting
Automation Workflows - Common automation patterns, daily reports, release automation, and team collaboration workflows
Troubleshooting - Solutions for authentication, permissions, rate limiting, and common errors

Example Scripts

Practical automation scripts (see examples/ directory):

auto-pr-create.sh - Automated PR creation workflow
issue-triage.sh - Bulk issue labeling and assignment
workflow-monitor.sh - Watch and notify on workflow completion
release-automation.sh - Complete release workflow automation

External Documentation

Official Manual : https://cli.github.com/manual
GitHub Community : https://github.com/cli/cli/discussions
API Documentation : https://docs.github.com/en/rest
Extension Marketplace : https://github.com/topics/gh-extension

JSON Output

Use --json flag for structured output. Always verify field names with--help as they differ from GitHub API names.

# Check available JSON fields for any command
gh repo view --help | grep -A 50 "JSON FIELDS"
gh pr list --help | grep -A 50 "JSON FIELDS"

Common JSON Field Corrections

Wrong (API-style)	Correct (gh CLI)
`stargazersCount`	`stargazerCount`
`forksCount`	`forkCount`
`watchersCount`	`watchers`
`openIssuesCount`	`issues`

Repository View Fields

# Common fields for gh repo view --json
gh repo view owner/repo --json name,description,stargazerCount,forkCount,updatedAt,url,readme

Tips

Use --web flag to open items in browser for detailed view
Leverage interactive prompts by omitting parameters - most commands support interactive mode
Apply filters with --author, --label, --state to narrow down lists efficiently
Add --json flag to enable scriptable output for automation
Always check--help for valid JSON field names - they differ from GitHub API
Use gh repo create --template to scaffold from template repositories
Enable auto-merge with gh pr merge --auto for PRs that pass checks

Weekly Installs

265

Repository

paulrberg/agent-skills

GitHub Stars

First Seen

Feb 9, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn

Installed on

codex247

claude-code103

opencode91

gemini-cli91

github-copilot91

amp91

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

102,600 周安装

GitHub CLI (gh) 命令行工具使用指南 - 安全操作与自动化工作流

🇨🇳中文介绍

GitHub CLI (gh)

概述

安全规则

相关 Skills

安装与设置

拉取请求

创建 PR

查看 PR

管理 PR

PR 检查

问题

创建问题

查看问题

管理问题

仓库操作

仓库信息

仓库管理

搜索

搜索仓库

搜索问题

搜索拉取请求

标签

列出和查看标签

创建和编辑标签

在仓库间克隆标签

代码空间

列出和创建代码空间

连接到代码空间

管理代码空间文件

发布

创建发布

管理发布

Gists

配置

快速参考

额外资源

参考指南

示例脚本

外部文档

JSON 输出

常见 JSON 字段更正

仓库查看字段

提示

🇺🇸English

GitHub CLI (gh)

Overview

Safety Rules

Installation & Setup

Pull Requests

Creating PRs

Viewing PRs

Managing PRs

PR Checks

Issues

Creating Issues

Viewing Issues

Managing Issues

Repository Operations

Repository Info

Repository Management

Search

Search Repositories

Search Issues

Search Pull Requests

Labels

List and View Labels

Create and Edit Labels

Clone Labels Between Repos

Codespaces

List and Create Codespaces

Connect to Codespaces

Manage Codespace Files

Releases

Creating Releases

Managing Releases

Gists

Configuration

Quick Reference