ntygod 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