Skip to content
Skills Library
Programming · Automation

gh-cli

/gh-cli

使用 GitHub CLI (`gh`) 执行非交互式 GitHub 协作与自动化任务(PR、Issue、Actions、Release、API 查询/修改)。当用户要求“用 gh 命令完成任务”、需要结构化 JSON 输出(`--json`/`--jq`)、批量处理 PR/Issue(如“批量 review 多个 PR”)、按策略合并(如“检查通过后自动 squash 合并”)时使用此 skill。

Repository
mtga ↗
Licence
AGPL-3.0
Last repository change
18.06.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
38
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 18.06.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

使用 GitHub CLI (`gh`) 执行非交互式 GitHub 协作与自动化任务(PR、Issue、Actions、Release、API 查询/修改)。当用户要求“用 gh 命令完成任务”、需要结构化 JSON 输出(`--json`/`--jq`)、批量处理 PR/Issue(如“批量 review 多个 PR”)、按策略合并(如“检查通过后自动 squash 合并”)时使用此 skill。

Triggers from the description

用 gh 命令完成任务批量 review 多个 PR检查通过后自动 squash 合并
Original author description

使用 GitHub CLI (`gh`) 执行非交互式 GitHub 协作与自动化任务(PR、Issue、Actions、Release、API 查询/修改)。当用户要求“用 gh 命令完成任务”、需要结构化 JSON 输出(`--json`/`--jq`)、批量处理 PR/Issue(如“批量 review 多个 PR”)、按策略合并(如“检查通过后自动 squash 合并”)时使用此 skill。

How it works

  1. Overview
  2. Workflow
  3. Operation Decision
  4. Command Rules
  5. Failure Handling
  6. Safety Checklist
  7. Output Format
  8. Reference
Original SKILL.md headings · 78 lines, 201 words
SKILL.md preview
---
name: gh-cli
description: 使用 GitHub CLI (`gh`) 执行非交互式 GitHub 协作与自动化任务(PR、Issue、Actions、Release、API 查询/修改)。当用户要求“用 gh 命令完成任务”、需要结构化 JSON 输出(`--json`/`--jq`)、批量处理 PR/Issue(如“批量 review 多个 PR”)、按策略合并(如“检查通过后自动 squash 合并”)时使用此 skill。
---

# gh-cli

## Overview

以可复现、可审计的方式调用 `gh`。默认输出结构化数据,优先使用非交互命令,避免依赖浏览器或 TUI。

## Workflow

1. 确认认证与仓库上下文。
2. 如果命令参数不确定,先运行 `gh <subcommand> --help` 或 `gh help <topic>`。
3. 先生成“只读探测命令”,再生成“变更命令”。
4. 变更命令明确影响范围(仓库、PR/Issue 编号、merge 策略、是否删除分支)。
5. 执行后返回关键输出与下一步建议。

## Operation Decision

1. 用户只问“现状/列表/状态”:只执行只读命令(`list`/`view`/`status`/`api GET`)。
2. 用户要求“评论/审查/合并/触发工作流”:先只读确认对象存在与状态,再执行变更命令。
3. 用户同时要“查询+修改”:拆成两段,先回显查询结果,再给修改命令并执行。
4. 用户目标不完整(缺编号、缺仓库、缺 merge 方法):先补齐参数,不直接变更。
5. 用户要求“整体审查结论”(`approve`/`request-changes`/`comment`):使用 `gh pr review`。
6. 用户要求“按文件/按行评论”:使用 `gh api repos/{owner}/{repo}/pulls/{num}/reviews` 或 `gh api repos/{owner}/{repo}/pulls/{num}/comments`,不要把 `gh pr review` 当作行内评论接口。

## Command Rules

- 默认使用非交互模式;不要依赖手动输入。
- 优先输出 JSON:使用 `--json` + `--jq/-q` 精简结果。
- 需要批量查询时,优先 `gh api --paginate`。
- 需要复杂参数时,优先 `gh api -f/-F` 或 `--input` 传文件。
- `gh pr diff` 不支持按文件路径直接过滤;按文件获取 patch 使用 `gh api repos/{owner}/{repo}/pulls/{num}/files --paginate` 再筛选。
- 提交行内评论前,必须先查询 `headRefOid`,并保证请求里的 `commit_id` 与其一致;否则常见 `422`。
- 构造复杂 JSON 时,优先内存对象后通过标准输入喂给 `gh api --input -`,避免在工作区落地临时文件。

## Failure Handling

- 认证失败:先执行 `gh auth status`,返回失败原因并给出最小修复命令。
- 权限不足(repo/org/token scope):明确缺失权限,不尝试重复写操作。
- 资源不存在(PR/Issue 编号错误):先回显查询命令与空结果,再请求更正目标。
- 分支保护或检查未通过导致无法 merge:返回阻塞项(review/check/protection),并给出可执行下一步。
- 二次执行冲突(已 merge、已关闭、已评论):识别幂等场景并停止重复变更。

## Safety Checklist

执行任何写操作前,先确认:

- 目标仓库(`owner/repo`)。
- 目标对象(PR/Issue 编号或 workflow 名称)。
- 操作类型(comment/review/merge/run 等)。
- 关键策略(merge 方法、是否 `--delete-branch`、是否 `--auto`)。
- 若为行内评论:`headRefOid` 与 `commit_id` 一致。
- 预期结果(状态变化、评论内容、触发记录)。

缺任一关键项时,先补信息,再执行。

## Output Format

统一按以下结构输出:

1. `Plan`: 本次要做的动作(1-2 行)。
2. `Commands`: 实际执行的命令(先只读,后变更)。
3. `Result`: 关键字段(如 `number`、`state`、`url`、`reviewDecision`)。
4. `Next`: 若失败或受阻,给最短可执行下一步。

## Reference

按需读取参考文档,避免一次加载全部命令:

- 入口索引:`references/commands.md`
- 认证:`references/auth.md`
- 仓库上下文:`references/repo.md`
- PR:`references/pr.md`
- Issue:`references/issue.md`
- Workflow:`references/workflow.md`
- Run:`references/run.md`
- API:`references/api.md`
- 细粒度子命令:`references/commands.md` 列出的 `*-*.md` 文件(如 `pr-diff.md`、`run-watch.md`)
Files in this package (38)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/api-graphql.md 1 KB
  • references/api-rest.md 1 KB
  • references/api.md 1 KB
  • references/auth-logout.md 1 KB
  • references/auth-status.md 1 KB
  • references/auth-switch.md 1 KB
  • references/auth-token.md 1 KB
  • references/auth.md 1 KB
  • references/commands.md 1 KB
  • references/issue-comment.md 1 KB
  • references/issue-create.md 1 KB
  • references/issue-list.md 1 KB
  • references/issue-view.md 1 KB
  • references/issue.md 1 KB
  • references/pr-checkout.md 1 KB
  • references/pr-checks.md 1 KB
  • references/pr-comment.md 1 KB
  • references/pr-diff.md 1 KB
  • references/pr-list.md 1 KB
  • references/pr-merge.md 1 KB
  • references/pr-review.md 1 KB
  • references/pr-status.md 1 KB
  • references/pr-view.md 1 KB
  • references/pr.md 1 KB
  • references/repo-list.md 1 KB
  • references/repo-view.md 1 KB
  • references/repo.md 1 KB
  • references/run-list.md 1 KB
  • references/run-rerun.md 1 KB
  • references/run-view.md 1 KB
  • references/run-watch.md 1 KB
  • references/run.md 1 KB
  • references/workflow-list.md 1 KB
  • references/workflow-run.md 1 KB
  • references/workflow-view.md 1 KB
  • references/workflow.md 1 KB

Versions

RepositoryScoreLicence
This page · bifangknt/mtga90AGPL-3.0
trailofbits/skills100CC-BY-SA-4.0
tenequm/skills100MIT
caarlos0/dotfiles100MIT
yamcodes/arkenv100MIT
benchflow-ai/skillsbench100Apache-2.0
farm-fe/farm100MIT
hamsurang/kit100MIT
fredrikaverpil/dotfiles95MIT

Database snapshot: 13.11.2026 · package version ffc5fb8bb729 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95github-cli
    MUST USE for GitHub-related operations, including a GitHub URL, repository or code search, Issues, pull requests, Actions, Releases, permissions, and API requests. Use the local GitHub CLI (`gh`).
  • 100github-gh-cli
    Inspect GitHub pull requests, issues, workflow runs, and API data with the gh CLI. Use when the user wants repository facts from GitHub without opening the browser, especially for PR status, CI failures, issue lists, or structured JSON output.
  • 100github
    GitHub CLI operations via `gh` for issues, PRs, Actions, releases, and REST/GraphQL API with `--json`/`--jq` parsing. Triggers on: "create an issue", "submit a PR", "check CI status", "why did CI fail", "merge a PR", or pasted GitHub URLs.
  • 95github
    Work with GitHub using the gh CLI. Use when creating/managing pull requests, reviewing code, managing issues, viewing GitHub Actions runs, creating releases, or making API requests. Triggers on GitHub-related tasks like "create a PR", "list open issues", "check CI status",…
  • 100github
    Drive GitHub via the official `gh` CLI — repos, issues, pull requests, releases, gists, Actions runs, and raw REST through `gh api`. Use when the user asks to inspect or manage GitHub.
  • 100github
    Interact with GitHub using the `gh` CLI. Use when users ask about pull requests, issues, CI/CD status, workflow runs, repository information, or want to create, review, or merge PRs. Covers `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, pull requests, actions, checks,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.