# Github

> github workflow.

- Skill: `kyrie66nb/github` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kyrie66nb/github`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kyrie66nb/github/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kyrie66nb (https://skillmd.com/u/kyrie66nb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kyrie66nb/github

---


# GitHub 集成

使用 `gh` CLI 识别 GitHub 资源、获取上下文并执行操作。

示例命令中的 `<gh_cmd>` 默认是 `gh`；当 `gh` 出现网络失败时，切换为 `proxy-gh`。

## 命令选择策略
1. 默认 `gh` 执行命令。
2. 若 `gh` 报网络错误（如 `timeout`、`TLS handshake timeout`、`connection reset`、`Temporary failure in name resolution`），且 `command -v proxy-gh` 可用，则使用同一参数改为 `proxy-gh` 重试一次。
3. 仅网络错误触发回退；鉴权、权限、资源不存在等错误不切换命令，按原错误处理流程执行。
4. 若 `proxy-gh` 不可用或重试后仍失败，输出已尝试命令与错误摘要并停止。

## 自动触发
- URL：`github.com/owner/repo/issues/123`、`/pull/456`、`/commit/abc123`
- 短引用：`#123`、`owner/repo#456`
- 关键词+数字：`issue 123`、`pr 456`、`pull request 456`

## 步骤

### 1) 识别资源并获取上下文

| 模式 | 类型 | `<gh_cmd>` 命令 |
|------|------|---------|
| `#123` 或 `/issues/123` | Issue | `<gh_cmd> issue view 123` |
| `#456` 或 `/pull/456` | PR | `<gh_cmd> pr view 456` |
| `/commit/abc123` 或 `abc123` | Commit | `git show abc123` 或 `<gh_cmd> api repos/{owner}/{repo}/commits/abc123` |
| `/releases/tag/v1.0` | Release | `<gh_cmd> release view v1.0` |
| `/actions/runs/123` | Workflow Run | `<gh_cmd> run view 123` |

- 优先使用 `--json` 获取结构化信息并输出摘要
- 仅出现 `#123` 且无法推断仓库时，先询问 owner/repo

### 2) 关联操作（仅 Git 操作场景）
- commit/PR 场景询问关联方式：`Fixes #N` / `Refs #N` / 跳过
- 可根据 issue 标题推断 commit type

### 3) 执行 GitHub 操作

| 操作 | `<gh_cmd>` 命令 |
|------|---------|
| 创建 PR | `<gh_cmd> pr create` |
| 添加评论 | `<gh_cmd> issue comment N --body "..."` |
| 关闭 issue | `<gh_cmd> issue close N` |
| 合并 PR | `<gh_cmd> pr merge N` |
| 添加标签 | `<gh_cmd> issue edit N --add-label "..."` |
| 查看 workflow 日志 | `<gh_cmd> run view N --log-failed` |
| 重新运行 workflow | `<gh_cmd> run rerun N` |

## 错误处理
- `gh` 未安装：提示安装并停止
- 未认证：提示 `gh auth login` 并停止
- 资源不存在：提示检查引用并说明已尝试命令
- 网络错误：按“命令选择策略”切换到 `proxy-gh` 重试一次，仍失败则提示用户检查网络或代理配置
- 引用歧义（如 `#123` 可能是 issue 或 PR）：先询问资源类型

## 退出标准
- GitHub 资源信息已获取并格式化展示
- 用户请求操作已执行，或已明确说明未执行原因（权限/条件不满足）