GitHub PR 工作流助手
用 gh CLI 管理 PR、堆叠分支与代码合并流程。
提供了 gh、git rebase、force-with-lease 和 squash merge 等会修改远程仓库的操作,但没有明确的逐步用户确认、权限最小化、敏感数据处理、回滚方案或数据流说明;仅在冲突时要求停止并让用户处理,因此扣分。
命令与堆叠 PR 流程基本一致,并说明了冲突处理方式;但依赖已配置认证、远程分支和准确旧基分支,缺少输入校验、失败诊断、测试证据及对分支保护等异常情况的处理,且静态评估不超过10分。
目标场景、受众和触发条件较清楚,覆盖 PR、代码审查、堆叠 PR 和仓库管理;但未明确不适用范围、GitHub CLI 认证要求、非 GitHub 平台限制或中文使用边界,因此扣分。
主文档结构清晰,有快速命令、流程摘要、问题映射、引用文档、MIT 许可证和作者元数据;但缺少技能版本、变更记录、明确维护责任、更新路径、FAQ 和系统化故障排查,因此扣分。
可直接指导创建、查看和合并 PR,堆叠 PR 参考文档也提供了可执行步骤;但关键命令仍需用户填充参数和判断分支关系,缺少验证后的代表性输出,并且自动合并操作可能需要较多人工复核,故按静态上限保守扣分。
命令、流程解释和引用的本地参考文件可审计,且许可证与仓库上下文可核对;但没有提交测试套件、CI 覆盖或第三方执行证据,主要结论只能通过静态阅读验证,因此仅给有限分数。
- 执行 gh pr merge、git rebase 和 git push --force-with-lease 前应确认目标 PR、分支、远程仓库、保护规则和备份/恢复方案。
- 该技能未说明 gh 认证、权限范围、网络可达性或命令失败时的诊断步骤;不要把示例中的占位符直接当作真实参数。
- 堆叠 PR 的 rebase --onto 依赖准确的旧基分支,判断错误可能导致提交遗漏或分支历史改变。
这个 Skill 能做什么,适合哪些场景?
这是 Callstack 的 GitHub 专用 Agent Skill,面向使用 GitHub CLI 的开发任务。它覆盖 PR 创建、状态与检查查看、代码审查相关流程、分支策略及仓库管理。其重点是堆叠 PR 的合并:先合并最底层 PR,再逐个变基、更新目标分支并压缩合并。遇到冲突时,流程要求停止并请用户手动解决。
要求使用 gh CLI 执行 GitHub 操作,包括创建 PR、查看 PR 状态和检查、压缩合并 PR,以及编辑 PR 的目标分支。对于堆叠 PR,它提供使用 Git 将后续分支变基到 main、使用 force-with-lease 推送、更新 PR base 并压缩合并的命令。它还提供一个指向 stacked-pr-workflow.md 的快速参考链接。
- 开发者需要从当前分支创建一个 GitHub PR 时
- 维护者需要查看某个 PR 的状态或 CI 检查结果时
- 团队采用堆叠 PR,并需要按顺序合并到 main 时
- 维护者需要在合并前选择 squash merge、更新目标分支或处理分支变基时
这个 Skill 有哪些优点和局限?
- 提供可直接执行的 gh CLI 和 Git 命令
- 明确描述堆叠 PR 的逐步合并顺序
- 覆盖 PR 创建、检查、合并和目标分支更新
- 依赖 GitHub CLI、Git、网络访问和相应仓库权限
- 冲突处理要求用户手动解决,未提供自动解决方案
- SKILL.md 仅列出一个堆叠 PR 参考文件,未展示测试套件或平台验证信息
- README 的安装示例主要面向整套技能集合,单独安装该技能的复制命令未明确记录
如何安装这个 Skill?
仓库 README 提供了两种相关安装方式:在 Claude Code 中添加 marketplace /plugin marketplace add callstackincubator/agent-skills,再安装 /plugin install github@callstack-agent-skills;在 Codex 中可通过仓库的 bundled plugins 使用该技能。也可以先运行 git clone https://github.com/callstackincubator/agent-skills.git,再按 README 的示例将 agent-skills/skills/* 复制到 .codex/skills/ 或 ~/.codex/skills/。README 没有提供只复制 skills/github/ 的专用安装命令。
如何使用这个 Skill?
在已识别该技能的助手中,提出与 GitHub PR、堆叠 PR、分支变基或仓库管理相关的任务,例如:Create a PR from the current branch and show its checks。常用命令包括 gh pr create --title "feat: add feature" --body "Description"、gh pr status 和 gh pr checks <PR_NUMBER>。合并堆叠 PR 时,先将首个 PR squash merge 到 main,再处理后续 PR;发生冲突时停止并手动解决。