AgentSkillsCN

git-hex-pr-workflow

结合 git-hex（本地操作）与远程协作（GitHub 插件或 CLI），完整执行拉取请求工作流程。当用户希望以整洁的提交历史准备、提交并迭代 PR 时，应使用此技能。触发短语包括：“准备 PR”、“打开拉取请求”、“回应评审反馈”、“更新我的 PR”、“为 PR 清理提交”。

SKILL.md
--- frontmatter
name: git-hex-pr-workflow
description: >
  Complete pull request workflow combining git-hex (local craft) with remote
  collaboration (GitHub plugin or CLI). This skill should be used when the user
  wants to prepare, submit, and iterate on a PR with clean commit history.
  Trigger phrases include: "prepare a PR", "open a pull request", "address review
  feedback", "update my PR", "clean up commits for PR".

Git-hex PR Workflow

When to use this Skill

This skill should be used when:

  • •The user wants to prepare a branch for PR submission with clean history
  • •The user is iterating on a PR after receiving review feedback
  • •The user asks about combining git-hex with GitHub/PR workflows

Trigger phrases include: "prepare a PR", "open a PR", "create a pull request", "address PR feedback", "update the PR", "force-push after rebase".

Workflow

  1. •

    Local craft (git-hex) - shape commits before pushing:

    • •Use git-hex-getRebasePlan to inspect current history
    • •Use git-hex-createFixup + git-hex-rebaseWithPlan to clean up
    • •Use git-hex-splitCommit if commits need to be broken apart
  2. •

    Push to remote:

    • •git push --force-with-lease (safe force push)
  3. •

    Remote collaboration - work with teammates:

    • •If the GitHub Plugin is installed: use its tools to create/update PRs, add reviewers, respond to comments
    • •Otherwise: use GitHub CLI (gh) commands:
      • •gh pr create - create a pull request
      • •gh pr view - view PR details
      • •gh pr edit - update PR title/body/reviewers
      • •gh pr comment - add comments
  4. •

    After review feedback:

    • •Return to step 1 for more local craft
    • •Use git-hex-undoLast if a cleanup went wrong

Tools to prefer

  • •Local craft: all git-hex tools (see branch-cleanup skill)
  • •Remote: GitHub plugin tools if installed, otherwise gh CLI

Key insight

git-hex handles the local craft of shaping commits. Remote collaboration (via the GitHub Plugin from the Official Claude Plugin Marketplace, or standard gh CLI) handles working with teammates. Together, they cover the complete pull request lifecycle.