用途
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 提供更便捷的接口和更好的错误处理。
操作步骤:
- 收集信息:与用户确认或从上下文推断源分支、目标分支(默认 master 或 main)、PR 的核心目的(若未说明,则从提交信息或文件变更推断)、是否关联 Issue(可选)。
- 分析变更:使用 compare_branches_tags 获取源分支与目标分支的 diff,base 为目标分支,head 为源分支;分析变更的核心文件、新增或修改的功能、是否存在破坏性变更。
- 生成 PR 标题:遵循 Conventional Commits 格式。
- 生成 PR 描述:使用模板,包含 Summary、Changes、Testing、Related Issue、Notes。
- 创建 PR:使用 create_pull,参数包括 title(第 3 步生成的标题)、body(第 4 步生成的描述)、head(源分支)、base(目标分支)。创建成功后输出 PR 链接。
适用场景
- 需要向 Gitee 仓库提交 Pull Request 时。
- 希望自动生成规范、结构化的 PR 标题与描述时。
- 需要将 PR 与特定 Issue 关联并在合并后自动关闭 Issue 时。
限制
- 依赖 Gitee MCP Server 及指定工具,未配置时无法使用。
- 需要用户提供仓库所有者、仓库名称、源分支、目标分支等必要信息。
- 若用户提供的信息不足,应先询问再创建,避免生成空描述的 PR。
- PR 标题应保持简洁(50 个字符以内),详细信息放在描述中。
- 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。