github

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

GitHub

GitHub operations via

gh

通过

gh

执行GitHub操作。

Router

路由

User says	Load reference	Do
help / gh help / flags / options	`references/cli-help.md`	show CLI help safely
auth / login / token	`references/auth.md`	authenticate gh
repo / clone / fork / sync	`references/repo.md`	repository operations
issue / issues	`references/issue.md`	issue triage and management
pr / pull request / review	`references/pr.md`	PR create/review/merge workflows
actions / workflow / run	`references/actions.md`	GitHub Actions (workflows + runs)
ci / monitor ci / check ci / ci status / watch ci	`references/ci-monitor.md`	monitor CI checks with live polling (if user says bare "ci", ask: monitor checks or view workflows?)
pr dashboard / pr overview / open prs / my prs / pr status	`references/pr-dashboard.md`	PR overview with status classification
release / publish release	`references/release.md`	releases + assets + verification
release strategy / release format / versioning	`references/release-strategy.md`	versioning, title/description format, generation protocol
secrets / variables	`references/secrets-vars.md`	manage secrets and variables
project	`references/projects.md`	projects operations
gist	`references/gists.md`	gist operations
search	`references/search.md`	search repos/issues/prs/code
api	`references/api.md`	gh api (advanced)
extension	`references/extensions.md`	manage gh extensions
config	`references/config.md`	gh config basics

用户指令	加载参考文档	执行操作
help / gh help / flags / options	`references/cli-help.md`	安全展示CLI帮助信息
auth / login / token	`references/auth.md`	认证gh
repo / clone / fork / sync	`references/repo.md`	仓库操作
issue / issues	`references/issue.md`	议题分类与管理
pr / pull request / review	`references/pr.md`	PR创建/评审/合并流程
actions / workflow / run	`references/actions.md`	GitHub Actions（工作流 + 运行）
ci / monitor ci / check ci / ci status / watch ci	`references/ci-monitor.md`	通过实时轮询监控CI检查（如果用户仅输入"ci"，询问：监控检查还是查看工作流？）
pr dashboard / pr overview / open prs / my prs / pr status	`references/pr-dashboard.md`	带状态分类的PR概览
release / publish release	`references/release.md`	发布版本 + 资产 + 验证
release strategy / release format / versioning	`references/release-strategy.md`	版本控制、标题/描述格式、生成协议
secrets / variables	`references/secrets-vars.md`	管理密钥与变量
project	`references/projects.md`	项目操作
gist	`references/gists.md`	Gist操作
search	`references/search.md`	搜索仓库/议题/PR/代码
api	`references/api.md`	gh api（高级功能）
extension	`references/extensions.md`	管理gh扩展
config	`references/config.md`	gh基础配置

Safety Rules

安全规则

Confirm before any state-changing operation (create/edit/delete/merge/close).
Never upload secrets as assets.
Treat
```
gh api
```
as powerful: confirm before any write operation.
Never delete or move published releases/tags unless explicitly requested.
When creating PRs, always set an assignee: default to
```
@me
```
unless the user explicitly names someone else.
When creating PRs, apply relevant existing labels when possible; auto-pick from PR context (title/body/branch + changed paths) and avoid creating new labels unless truly necessary.
If labels must be created, retrieve existing labels first (
```
gh label list
```
), propose the minimal set consistent with repo naming, and confirm before
```
gh label create
```
.

在执行任何会改变状态的操作（创建/编辑/删除/合并/关闭）前需确认。
切勿将密钥作为资产上传。
注意
```
gh api
```
功能强大：在执行任何写入操作前需确认。
除非用户明确要求，否则切勿删除或移动已发布的版本/标签。
创建PR时，始终设置经办人：默认设为
```
@me
```
，除非用户明确指定其他人。
创建PR时，尽可能应用现有相关标签；从PR上下文（标题/内容/分支 + 变更路径）自动选择标签，除非必要否则避免创建新标签。
如果必须创建新标签，先获取现有标签列表（
```
gh label list
```
），建议使用与仓库命名一致的最少标签集，并在执行
```
gh label create
```
前确认。

Confirmation Policy

确认政策

Read-only commands are always OK.

Require confirmation:

gh issue create/edit/close/reopen/delete

```
gh pr create/edit/close/merge/review
```

gh repo create/edit/rename/archive/delete/sync

gh release create/edit/delete

gh release upload

gh release delete-asset

gh secret set/delete

gh variable set/delete

```
gh run rerun
```
,
```
gh run cancel
```
```
gh api
```
calls that mutate state (POST/PATCH/PUT/DELETE)

只读命令无需确认即可执行。

需要确认的操作：

gh issue create/edit/close/reopen/delete

```
gh pr create/edit/close/merge/review
```

gh repo create/edit/rename/archive/delete/sync

gh release create/edit/delete

gh release upload

gh release delete-asset

gh secret set/delete

gh variable set/delete

```
gh run rerun
```
,
```
gh run cancel
```
会修改状态的
```
gh api
```
调用（POST/PATCH/PUT/DELETE）

Read-Only (No Confirmation Needed)

只读操作（无需确认）

bash

gh auth status
gh release list
gh release view <tag>
gh release view <tag> --web
gh help
gh pr checks <number> --json ...
gh run list --branch <branch> --json ...
gh run view <run-id>
gh run view <run-id> --log-failed

bash

gh auth status
gh release list
gh release view <tag>
gh release view <tag> --web
gh help
gh pr checks <number> --json ...
gh run list --branch <branch> --json ...
gh run view <run-id>
gh run view <run-id> --log-failed