github

name	github
platforms	["github"]
description	GitHub 全功能适配器技能：通过适配器内置工具完成用户交互操作（Star/Fork/账号绑定/Webhook 订阅/App 安装）， 通过 bash + gh CLI 完成仓库自动化操作（Issue/PR/Release/CI/搜索/文件/Discussion）。 Bot 操作使用 GitHub App 身份，Star/Fork 等用户操作使用个人绑定的 OAuth Token。 每个 Zhin 实例通过 GH_TOKEN 环境变量注入身份，支持多实例协同。 channel ID 格式：owner/repo/issues/N 或 owner/repo/pull/N。
keywords	["github","gh","cli","adapter:github","pr","pull request","issue","merge","review","star","fork","branch","release","CI","workflow","repo","合并","仓库","拉取请求","代码审查","search","搜索","bind","unbind","whoami","绑定","授权","label","assign","file","commit","compare","[Truncated]"]
tags	["github","development","git","ci-cd"]
tools	["bash","github_star","github_fork","github_bind","github_unbind","github_whoami","github_install","github_subscribe","github_unsubscribe","github_subscriptions"]
always	false
requires	{"bins":["gh"],"env":["GH_TOKEN"]}

GitHub 全功能操作指南

本技能提供两种操作方式：

• 适配器内置工具（github_*）：用户交互类操作，具备账号绑定、Device Flow 授权、频道级订阅等适配器专有逻辑
• bash + gh CLI：仓库自动化操作，灵活覆盖 GitHub API 全场景

一、适配器内置工具

以下工具由 GitHub 适配器注册，具有特殊行为（用户 OAuth 绑定、频道绑定等），不能用 gh CLI 替代。

账号与身份

工具	说明
github_bind	绑定用户的 GitHub 账号（Device Flow 授权，无需输入密码）。用户想 star/fork 或操作自己的账号时，先引导使用此工具
github_unbind	解除用户绑定的 GitHub 账号
github_whoami	查看用户已绑定的 GitHub 账号信息
github_install	获取安装 GitHub App 的链接，安装后 Bot 可访问用户的仓库

用户操作（使用绑定账号）

工具	说明
github_star	Star 或取消 Star 一个仓库。优先使用用户绑定的 GitHub 账号，未绑定则降级为 Bot 默认账号
github_fork	Fork 一个仓库。优先使用用户绑定的 GitHub 账号，未绑定则降级为 Bot 默认账号

Webhook 订阅（频道级）

工具	说明
github_subscribe	订阅仓库的 Webhook 事件，推送到当前聊天通道
github_unsubscribe	取消订阅仓库的 Webhook 事件
github_subscriptions	查看当前聊天通道的订阅列表

内置工具执行规则

1. github_star 和 github_fork 优先使用用户绑定的 GitHub 账号，未绑定则降级为 Bot 默认账号
2. 当用户想操作自己的 GitHub 账号时，先引导用户使用 github_bind 绑定
3. Webhook 订阅关联到当前聊天通道，仅在该通道接收事件通知

---

二、gh CLI 全场景速查

当适配器内置工具不能满足需求（如 Release 管理、Workflow 触发、Discussion、gh api 万能调用），或需要更灵活的参数控制时，使用 bash 工具调用 gh CLI。当前进程已通过 GH_TOKEN 环境变量注入身份凭据。

0. 前提检查

gh --version
gh auth status

1. 仓库（gh repo）

gh repo view owner/repo
gh repo list owner -- 10 --json name,description
gh repo  owner/repo
gh repo create owner/new-repo --public --description