SuperAPI AI 工具集

pr-creation

编程与开发

查看项目

更新于 10-16 04:02

技能介绍

用途

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 平台范围、收费信息或效果数据,相关内容暂未提供。