{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Github Auth

GitHub auth 设置：HTTPS 令牌、SSH 密钥、gh CLI 登录。

Skill 元数据


来源	内置（默认安装）
路径	`skills/github/github-auth`
版本	`1.1.0`
作者	Hermes Agent
许可证	MIT
平台	linux, macos, windows
标签	`GitHub`, `Authentication`, `Git`, `gh-cli`, `SSH`, `Setup`
相关 skill	`github-pr-workflow`, `github-code-review`, `github-issues`, `github-repo-management`

参考：完整 SKILL.md

信息

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。

GitHub 认证设置

此 skill 用于配置认证，使 agent 能够操作 GitHub 仓库、PR、issue 和 CI。涵盖两条路径：

git（始终可用） — 使用 HTTPS 个人访问令牌（personal access token）或 SSH 密钥

gh CLI（如已安装） — 更丰富的 GitHub API 访问，认证流程更简单

检测流程

当用户要求你操作 GitHub 时，首先执行以下检查：

决策树：

若 gh auth status 显示已认证 → 直接使用 gh 处理所有操作

若 gh 已安装但未认证 → 使用下方"gh auth"方法

若 gh 未安装 → 使用下方"仅 git"方法（无需 sudo）

方法一：仅 Git 认证（无 gh，无 sudo）

适用于任何已安装 git 的机器，无需 root 权限。

选项 A：HTTPS 配合个人访问令牌（推荐）

最通用的方法——适用于所有环境，无需 SSH 配置。

第一步：创建个人访问令牌

告知用户访问：https://github.com/settings/tokens

点击"Generate new token (classic)"

填写名称，如"hermes-agent"

选择权限范围（scope）：

repo（完整仓库访问——读、写、推送、PR）

workflow（触发和管理 GitHub Actions）

read:org（如需操作组织仓库）

设置有效期（90 天是合理的默认值）

复制令牌——此后不会再次显示

第二步：配置 git 存储令牌

首次输入凭据后，将被保存并在后续所有操作中复用。

替代方案：cache helper（凭据在内存中过期）

替代方案：直接将令牌写入远程 URL（按仓库设置）

第三步：配置 git 身份信息

第四步：验证

选项 B：SSH 密钥认证

适合偏好 SSH 或已有密钥的用户。

第一步：检查现有 SSH 密钥

第二步：如需则生成密钥

告知用户在以下地址添加公钥：https://github.com/settings/keys

点击"New SSH key"

粘贴公钥内容

填写标题，如"hermes-agent-<machine-name>"

第三步：测试连接

第四步：配置 git 使用 SSH 访问 GitHub

第五步：配置 git 身份信息

方法二：gh CLI 认证

若已安装 gh，一步即可完成 API 访问和 git 凭据配置。

浏览器交互登录（桌面环境）

基于令牌登录（无头环境 / SSH 服务器）

验证

不使用 gh 调用 GitHub API

当 gh 不可用时，仍可使用 curl 配合个人访问令牌访问完整的 GitHub API。其他 GitHub skill 的降级方案均采用此方式。

为 API 调用设置令牌

从 Git 凭据中提取令牌

若已通过 credential.helper store 配置 git 凭据，可提取令牌：

辅助函数：检测认证方式

在任何 GitHub 工作流开始时使用此模式：

故障排查

问题	解决方案
`git push` 要求输入密码	GitHub 已禁用密码认证。请使用个人访问令牌作为密码，或切换至 SSH
`remote: Permission to X denied`	令牌可能缺少 `repo` scope——请重新生成并选择正确的 scope
`fatal: Authentication failed`	缓存的凭据可能已过期——运行 `git credential reject` 后重新认证
`ssh: connect to host github.com port 22: Connection refused`	尝试通过 HTTPS 端口使用 SSH：在 `~/.ssh/config` 中为 `Host github.com` 添加 `Port 443` 和 `Hostname ssh.github.com`
凭据不持久	检查 `git config --global credential.helper`——必须为 `store` 或 `cache`
多个 GitHub 账号	在 `~/.ssh/config` 中为不同主机别名配置不同 SSH 密钥，或使用按仓库设置的凭据 URL
`gh: command not found` 且无 sudo	使用上方方法一（仅 git）——无需安装任何软件

"Github Auth — GitHub auth setup: HTTPS tokens, SSH keys, gh CLI login"

Github Auth#

Skill 元数据#

参考：完整 SKILL.md#

GitHub 认证设置#

检测流程#

方法一：仅 Git 认证（无 gh，无 sudo）#

选项 A：HTTPS 配合个人访问令牌（推荐）#

选项 B：SSH 密钥认证#

方法二：gh CLI 认证#

浏览器交互登录（桌面环境）#

基于令牌登录（无头环境 / SSH 服务器）#

验证#

不使用 gh 调用 GitHub API#

为 API 调用设置令牌#

从 Git 凭据中提取令牌#

辅助函数：检测认证方式#

故障排查#

Github Auth

Skill 元数据

参考：完整 SKILL.md

GitHub 认证设置

检测流程

方法一：仅 Git 认证（无 gh，无 sudo）

选项 A：HTTPS 配合个人访问令牌（推荐）

选项 B：SSH 密钥认证

方法二：gh CLI 认证

浏览器交互登录（桌面环境）

基于令牌登录（无头环境 / SSH 服务器）

验证

不使用 gh 调用 GitHub API

为 API 调用设置令牌

从 Git 凭据中提取令牌

辅助函数：检测认证方式

故障排查