用途:用 gh 子命令完成各类 GitHub 操作,覆盖 PR 创建、评审、合并与评论,议题管理,CI/Actions 状态查看,工作流发现,代码/提交搜索和标签管理。核心规则:存在子命令时优先用子命令,它会自动处理分页、错误格式化和仓库识别;仅对子命令未覆盖的操作(如行级 PR 评论、评审线程解决、GraphQL 查询)才用 gh api。只读操作无需用户批准,例如 gh pr view 123、gh pr diff 123 --stat、gh pr checks 123 --watch、gh issue list、gh run view 12345 --log-failed、gh workflow list、gh search code、gh label list。写操作会改变状态,需用户批准,例如 gh pr create --draft --fill、gh pr review 123 --approve、gh pr merge 123 --squash --delete-branch、gh issue create/edit/close、gh run rerun、gh workflow run。可用 --json 和 --jq 抽取结构化数据,如 gh pr list --json number,title,url --jq '.[] | "(.number) (.title)"'。行级评论需用 gh api repos/{owner}/{repo}/pulls/{pr}/comments 携带 body、path、line、side 等字段。资料还给出“检查 PR 评论”的处理思路:获取未解决线程,逐条对照代码与约定验证,再决定修复、回复并解决或留待讨论,不应盲目认同。限制:资料未提供收费、安装步骤及具体平台支持信息,暂未提供;使用前应确认本地已安装并认证 GitHub CLI。
gh-cli-flow
编程与开发
更新于 10-15 21:11