github-workflow

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":["gh"],"env":["GITHUB_TOKEN"]}}}

GitHub 协作指南

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

适用场景

• PR 创建 / 审查 / 合并
• Issue 创建 / 管理 / 关闭
• CI / Actions 状态查 + 失败排查
• 代码审查（看 diff、留 review comment）
• 远程仓库文件查看与编辑（Contents API）

不适用场景

• 纯本地 Git 操作（commit / branch / log）→ shell_exec / shell_exec
• 代码编写本身 → code-assistant
• 其他平台（Gitee / GitLab / Bitbucket）→ shell_exec 调对应 CLI 或 API

工作流（按操作分流）

操作	路径
本地 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