GitHub 协作管家（生成即用·GitHub 协作）
> 触发词：GitHub、PR、Pull Request、Issue、代码审查、仓库管理、合并请求、release、GitHub Actions
> 适用场景：创建分支并发起 PR 等（详见下文）
> 连接与鉴权：官方两条路径：① gh CLI（GitHub 官方命令行，已登录即可用）；② GitHub 官方 MCP Server（@modelcontextprotocol/server-github 或 GitHub 托管 MCP）。二者任选其一。
一、核心用途
将 GitHub 的日常协作动作标准化为可执行步骤：创建/合并 PR、开 Issue、指派审查、查 CI 状态、打 tag 发布。用户自然语言描述意图，本 skill 通过 gh CLI 或 GitHub MCP 完成，并回显结构化结果。
二、适用场景
- 创建分支并发起 PR
- 列出/筛选 Issue 并指派
- 查看 PR 审查意见与 CI 状态
- 合并分支、打 tag、创建 release
- 查询某人/某仓库近期活动
三、连接与鉴权（R-去个人化：凭证一律走环境变量，绝不写死 Key/appid/token）
- 接入路径：官方两条路径：① gh CLI（GitHub 官方命令行，已登录即可用）；② GitHub 官方 MCP Server（@modelcontextprotocol/server-github 或 GitHub 托管 MCP）。二者任选其一。
- 所需凭证（环境变量占位）：
GITHUB_PERSONAL_ACCESS_TOKEN：GitHub Personal Access Token（repo/workflow 权限）；gh CLI 也可用gh auth login登录，无需明文 Token- 免 Key 说明：gh CLI 在已
gh auth login的机器上即用，无需额外 Key；MCP 方式需要一个 PAT（免费申请）。 - 国内可达性：GitHub 为海外服务，国内调用需正常网络出口；企业内网可用自托管 GitHub 同理。
四、执行流程
- 接收意图与必要参数（如账号、地址、偏好、查询条件）。
- 校验参数完整性，缺失则询问或以默认偏好补全（不自行臆造未知信息）。
- 调用官方 MCP/API（通过 mcporter 或对应客户端工具）执行对应动作。
- 解析返回，格式化输出（订单号/链接/状态/费用/来源等）。
- 涉及支付、下单、删除、改写等敏感动作 → 展示预览并二次确认后执行；异常时 fail-open 不崩溃。
五、输入 / 输出
- 输入：自然语言指令 + 必要参数（账号、地址、偏好、时间等）。
- 输出：结构化结果（订单号、支付链接、状态、费用、来源 URL 等）+ 下一步建议。
六、异常处理（三级）
- 一级（可恢复）：参数缺失 → 询问补全后重试。
- 二级（需确认）：支付/下单/删除/改写 → 展示预览，用户确认后执行。
- 三级（终止）：Key 无效 / 无权限 / 服务不可达 → 报错并给出申请与排查指引，fail-open 不崩。
七、反模式（禁止）
- 禁止写死任何个人 Key / Token / appid / corpid / mch_id（R-去个人化）。
- 禁止未确认就自动支付、下单、删除或改写远端资源。
- 禁止编造平台不支持的能力、精确的 URL 或数值（R-TEST T3）。
- 禁止越权读取他人账号数据。
八、FAQ
Q：没有 Token 能用吗？
A：能。装好 gh 并 gh auth login 后零配置可用；MCP 方式才需要 PAT。
Q：会动我的仓库吗？
A：涉及 push/merge/close 等写操作前，本 skill 会展示预览并请你确认，不会静默改写。
九、领域参考
- 详见
references/connect.md：官方端点、申请步骤、MCP 客户端配置样例与最小权限提示。
