SuperAPI AI 工具集

create-pr

编程与开发

查看项目

更新于 10-16 07:44

技能介绍

用途

create-pr 用于在 Gitee 上创建 Pull Request。当用户提出创建 PR、打开拉取请求、提交合并请求等需求时,该技能会基于当前代码变更生成结构化的 PR 描述并提交。

主要能力

  • 通过 Gitee MCP 创建 Pull Request。
  • 使用 compare_branches_tags 获取源分支与目标分支之间的差异(diff),分析变更的核心文件、新增或修改的功能,以及是否存在破坏性变更。
  • 按 Conventional Commits 格式生成 PR 标题,类型包括 feat、fix、refactor、docs、test、chore,格式为 <type>(<scope>): <subject>。
  • 按固定模板生成 PR 描述,包含 Summary、Changes、Testing、Related Issue、Notes 等部分。
  • 支持关联 Issue:若用户指定关联 Issue,会在描述中追加 closes #N,使 PR 合并后自动关闭该 Issue。
  • 创建成功后输出 PR 链接。

使用方式

前置条件:

  • 已配置 Gitee MCP Server,所需工具包括 create_pull、get_file_content、list_repo_issues、compare_branches_tags。
  • 用户需提供:仓库所有者、仓库名称、源分支、目标分支(通常为 main/master)。
  • 可选:关联的 Issue 编号。

若本地安装了 mcporter,建议使用 mcporter 调用 MCP 工具,而不是直接调用 MCP 工具,因为 mcporter CLI 提供更便捷的接口和更好的错误处理。

操作步骤:

  1. 收集信息:与用户确认或从上下文推断源分支、目标分支(默认 master 或 main)、PR 的核心目的(若未说明,则从提交信息或文件变更推断)、是否关联 Issue(可选)。
  2. 分析变更:使用 compare_branches_tags 获取源分支与目标分支的 diff,base 为目标分支,head 为源分支;分析变更的核心文件、新增或修改的功能、是否存在破坏性变更。
  3. 生成 PR 标题:遵循 Conventional Commits 格式。
  4. 生成 PR 描述:使用模板,包含 Summary、Changes、Testing、Related Issue、Notes。
  5. 创建 PR:使用 create_pull,参数包括 title(第 3 步生成的标题)、body(第 4 步生成的描述)、head(源分支)、base(目标分支)。创建成功后输出 PR 链接。

适用场景

  • 需要向 Gitee 仓库提交 Pull Request 时。
  • 希望自动生成规范、结构化的 PR 标题与描述时。
  • 需要将 PR 与特定 Issue 关联并在合并后自动关闭 Issue 时。

限制

  • 依赖 Gitee MCP Server 及指定工具,未配置时无法使用。
  • 需要用户提供仓库所有者、仓库名称、源分支、目标分支等必要信息。
  • 若用户提供的信息不足,应先询问再创建,避免生成空描述的 PR。
  • PR 标题应保持简洁(50 个字符以内),详细信息放在描述中。
  • 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。