GitHub CLI (gh)

概述

使用gh用于在终端中执行经过身份验证的GitHub操作。偏好使用明确、幂等的命令，并将URL报告给用户。

快速检查

• 认证状态：

gh auth status

• 当前仓库上下文：

gh repo view --json nameWithOwner,url,defaultBranchRef

核心工作流

仓库创建（默认私有）

gh repo create OWNER/NAME --private --confirm --description "..."

如果在本地仓库内运行，请使用--source . --remote origin --push。

克隆 / 复刻

gh repo clone OWNER/NAME

gh repo fork OWNER/NAME --clone

议题

• 列表：

gh issue list --limit 20

• 创建：

gh issue create --title "..." --body "..."

• 评论：

gh issue comment <num> --body "..."

拉取请求

• 从当前分支创建：

gh pr create --title "..." --body "..."

• 列表：

gh pr list --limit 20

• 查看：

gh pr view <num> --web

• 合并（使用明确的方法）：

gh pr merge <num> --merge

发布

gh release create vX.Y.Z --title "vX.Y.Z" --notes "..."

安全注意事项

• 在执行破坏性操作（删除、强制推送）前，请确认目标仓库/所有者。
• 对于私有仓库，请确保在创建时设置--private参数。
• 在自动化流程中，建议使用--confirm参数以避免交互式提示。