用途
PR Creation 用于在实现完成后创建 Pull Request,核心原则是:PR 应讲述此次变更的完整故事。它强调在创建 PR 前完成必要的前置检查,并在 PR 中提供完整文档、正确标签、关联议题和验证摘要。
主要能力
- 创建前验证:要求确认全部测试本地通过、本地构建成功、代码审查完成(comprehensive-review)、所有发现项已处理(apply-all-findings)、提交整洁且原子(clean-commits)、分支与目标分支保持同步。
- 分支同步:提供 git fetch、rebase 或 merge、解决冲突、推送更新分支的命令示例。
- PR 文档结构:标题采用
[类型] 简要描述 (#议题)格式,正文模板包含 Summary、Changes、Related Issues、Verification、Checklist、Notes for Reviewers 等部分。 - 使用 GitHub CLI 创建 PR:示例命令展示如何传入完整正文、指定 base 与 head 分支。
- 标签与审阅者:支持创建后或创建时添加标签,以及请求审阅者。
- 议题关联:支持自动关联关键词(Closes、Fixes、Resolves、Relates to、Depends on),可关联多个议题。
- 验证摘要:可包含测试结果表格与验收标准表格,并链接完整验证报告。
- 特殊场景:草稿 PR(用于进行中或早期反馈)、破坏性变更(需突出警示并提供迁移指南)、大型 PR(提供审阅指南与按类别分组文件)。
- 创建后:监控 PR 状态与 CI 状态,响应审阅反馈,处理反馈并推送修复,必要时重新请求审查,标记对话已解决。
使用方式
该技能由 issue-driven-development 的第 12 步调用,通常在 comprehensive-review、apply-all-findings、clean-commits 之后使用,并先于 ci-monitoring。使用方式为按照模板组织 PR 内容,并通过 GitHub CLI 创建 PR。创建前逐项确认清单,创建后检查状态并响应反馈。
适用场景
适用于在实现完成后需要创建规范 Pull Request 的开发工作流,特别是需要完整文档、议题关联与验证记录的团队协作场景。
限制
资料未提供该技能的具体安装方式、运行环境依赖、支持的 Git 平台范围、收费信息或效果数据,相关内容暂未提供。