name	github-workflow
description	当用户要操作 GitHub PR / Issue / CI、代码审查、合并 PR、查看工作流运行、读取或更新远程仓库文件时使用。
version	2.1.0
metadata	{"zhiwei":{"tags":["github","pr","issue","ci","code-review","gh-cli","actions"],"suggested_tools":["shell_exec","web_fetch","file_read","file_write"],"requires":{"bins":"[Truncated]","env":"[Truncated]"}}}

GitHub 协作指南

gh CLI + REST/GraphQL API 管理 GitHub PR / Issue / CI / 代码审查。

操作	路径
本地 commit + push + 创 PR	`shell_exec(command="git add ... && git commit -m '...'")` → `shell_exec(command="git push")` → `gh pr create`
仅 GitHub 侧（看 / 评论 / 合并 PR）	`shell_exec` + `gh pr ...`
Issue 创建 / 查询 / 评论	`shell_exec` + `gh issue ...`
CI 状态 + 失败排查	`shell_exec` + `gh run list / view --log-failed`
代码审查（拉 diff + 留意见）	`gh pr diff` + `gh pr review`
远程文件直改（不 clone）	`shell_exec` + `gh api`（Contents API）
复杂查询（跨仓 / 批量）	`gh api graphql` 或 `web_fetch` GraphQL

各路径要点：

CI 通过才合并：合 PR 前 gh pr checks <pr> 看全绿
git 操作走 shell_exec：所有 git 命令（status/diff/log/commit/push 等）统一用 shell_exec 执行
Contents API 整体解码：返回的 Base64 含换行，必须先去空白再整体 base64 解码；逐行解会破坏多字节 UTF-8
时间窗口收窄：since / until 限定范围；结果太多缩窗口而不是 --paginate
token 走 env：GITHUB_TOKEN 由系统注入，命令里不写明文

gh CLI 命令速查（PR / Issue / CI / 审查）：{skill_dir}/references/gh-cli-reference.md
Contents API 文件更新（Bash / PowerShell）+ 时间范围查询：{skill_dir}/references/content-api.md

github-workflow