89jobrien-git-workflow Skill 技能

技能简介

89jobrien-git-workflow 是 Joseph O'Brien 为 Claude、Codex、Claude Code 编写的一套 Pull Request 与分支命名工作流 Skill，针对"PR 描述只有一行标题""分支名随意起""merge 策略拍脑袋"等真实协作场景。它把团队级 PR 模板、分支命名规则、merge 策略推荐、breaking change 迁移说明整合成可重复调用的提示模板，让编码 Agent 起草 PR 描述时自动补齐 Summary / Motivation / Changes / Test Plan / Checklist / Breaking Changes 六大段落。Skill 同时给出 squash、merge、rebase 三种合并策略的判定逻辑（基于提交历史、审计需求、是否需要线性历史），帮助团队在 PR 评审会上快速决策。Quality Score 79、版本 v1.0.1、安全审计完整。

核心能力

• 生成结构化 PR 描述：自动填充 Summary（变更摘要）、Motivation（动机）、Changes（具体改动列表）、Test Plan（测试方案）、Checklist（评审清单）、Breaking Changes（破坏性变更说明）六大段。
• 推荐规范的分支命名：type/issue-number/short-description，type 涵盖 feat/fix/chore/refactor/test/docs 等。
• 给出 squash / merge / rebase 三种合并策略的决策树：当需要保留审计痕迹→merge commit；当希望线性历史→rebase 或 squash；当 fixup 过多→squash。
• 帮助编写 breaking change 文档，包括迁移步骤、影响面、版本号变更建议（major bump）。
• 提供 feature / bugfix / refactor 三类 PR 模板，覆盖日常 PR 80% 场景。
• 在 PR 描述中自动插入 issue 链接、截图位、文档更新提示，减少评审来回。

安装配置

• 通过 npx skillstore add joseph obrien/89jobrien-git-workflow 一行命令安装。
• 建议团队预先在 GitHub/GitLab 启用分支保护规则（要求 PR、强制 reviewer），让 Skill 给出的 review checklist 与分支策略真正落地。
• 可在 Skill 调用前准备好 ticket 编号（如 JIRA-1234）、变更摘要、本地测试结果，让 Skill 一次性产出完整 PR 描述。
• 配合 GitHub Actions 的 pull-request-template 目录使用，把 Skill 输出的 PR 描述贴入模板即可。

使用步骤

• 第一步：执行 Create a pull request description for this change. Include a summary, motivation, changes, test plan, checklist, and breaking changes section.，让 Skill 基于当前 diff 生成 PR 描述草稿。
• 第二步：执行 Suggest a branch name for this work using type, issue number, and a short description. Explain why the type fits.，确认分支命名是否符合团队规范。
• 第三步：执行 Review this pull request description for clarity, missing test details, breaking change notes, screenshots, and issue links.，让 Skill 走一遍自检，避免评审时反复补充。
• 第四步：执行 Recommend a merge strategy for this branch. Consider commit history, audit needs, review size, and whether a linear history matters.，由 reviewer 与作者一起决定合并方式。
• 第五步：把最终 PR 描述复制到 GitHub/GitLab PR 模板中，附上截图、文档链接，等待 reviewer 通过。

适用场景

• 中小团队日常 PR 模板统一化，减少 reviewer 与 author 之间的来回沟通。
• 跨仓库协作（如微服务 monorepo）时统一分支命名规范与 PR 描述结构。
• breaking change 发布（数据库迁移、API 协议升级）前生成规范的迁移说明。
• 与 Conventional Commits、semantic-release 流水线协同：branch type 直接喂给 commit type。
• 团队新人 onboarding：把 Skill 作为活文档，学习规范的 PR 描述应包含哪些段。

适用人群

• 任何需要在 GitHub/GitLab 上发起 PR 的开发者。
• 关注代码评审效率、希望减少评审来回的 Tech Lead 与 Staff Engineer。
• 维护 GitFlow、Trunk-based development、GitHub Flow 等工作流的研发团队。
• DevRel 与开源项目维护者：标准化的 PR 描述让外部贡献者更容易被接受。

工作原理

Skill 通过提示模板工程把"PR 描述应包含的元数据"显式列举，让编码 Agent 在生成文本时不会遗漏关键字段。分支命名遵循 Conventional Branch 模式（type/issue/short-desc），与 Conventional Commits 保持同源 type 词汇表。Merge 策略决策基于 commit 数量、是否需要保留审计追溯（合规场景）、是否追求线性历史（changelog 友好）三个维度。Skill 自身不执行 Git 命令，所有结果都以建议形式产出，由人类 reviewer 与 author 决定最终策略，符合"AI 提建议，人类守门"的原则。风险因素仅声明 external_commands + network，无 prompt injection 或恶意行为。

官方链接

• Skill 详情页：https://skillstore.io/skills/89jobrien-git-workflow
• Manifest：https://skillstore.io/api/skills/89jobrien-git-workflow/manifest
• 源仓库：https://github.com/89jobrien/steve/tree/main/steve/skills/git-workflow
• 安装命令：npx skillstore add joseph obrien/89jobrien-git-workflow