Create Pr

基于变更内容自动生成规范的Gitee Pull Request,支持智能标题与描述。

已扫描
适合谁
使用Gitee进行代码管理的开发者、希望提升PR提交效率的团队成员
不适合谁
未配置Gitee MCP服务的用户、不使用Gitee平台的开发者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @oschina/gitee-create-pr

Skill 说明

命令、参数、文件名以原文为准

注意:如果你本地安装了 mcporter,建议使用 mcporter 来调用 MCP 工具,而不是直接调用 MCP 工具。mcporter CLI 提供了更便捷的接口和更好的错误处理能力。

通过 Gitee MCP 创建 Pull Request

根据当前的变更生成结构清晰的 Pull Request 描述,并提交至 Gitee。

前置条件

  • 已配置 Gitee MCP 服务(工具:create_pullget_file_contentlist_repo_issuescompare_branches_tags
  • 用户需提供:仓库所有者、仓库名称、源分支、目标分支(通常为 main/master)
  • 可选:关联的 Issue 编号

操作步骤

步骤 1:收集信息

与用户确认或从上下文中推断以下内容:

  • 源分支(头分支)
  • 目标分支(基分支,默认值:master 或 main)
  • 本次 PR 的核心目的(若未说明,可从提交信息或文件变更中推断)
  • 是否需要关联 Issue(可选)

步骤 2:分析变更

使用 compare_branches_tags 获取源分支与目标分支之间的差异:

  • base:目标分支(如 mainmaster
  • head:源分支

分析返回的差异内容,确定:

  • 哪些核心文件被修改
  • 新增或修改的功能
  • 是否存在破坏性变更

步骤 3:生成 PR 标题

遵循 Conventional Commits 格式:

<type>(<scope>): <subject>

可用类型:

  • feat:新功能
  • fix:修复缺陷
  • refactor:代码重构
  • docs:文档更新
  • test:测试相关变更
  • chore:构建 / 依赖 / 工具链变更

示例:feat(auth): add OAuth2 login support

步骤 4:生成 PR 描述

使用以下模板生成结构化描述:

## 摘要

[清晰描述本次 PR 的目的及其解决的问题]

## 变更内容

- [变更 1]
- [变更 2]
- [变更 3]

## 测试

- [ ] 单元测试通过
- [ ] 功能测试通过
- [x] [已完成的测试项]

## 关联 Issue

closes #[issue number](如有)

## 备注

[破坏性变更、依赖升级、部署注意事项等(如有)]

步骤 5:创建 PR

使用 create_pull 创建 PR,参数如下:

  • title:步骤 3 生成的标题
  • body:步骤 4 生成的描述
  • head:源分支
  • base:目标分支

创建成功后,输出 PR 的链接供用户查看。

注意事项

  • 若用户指定了关联的 Issue,应在描述中添加 closes #N,以便在 PR 合并时自动关闭该 Issue
  • PR 标题应简洁(不超过 50 个字符),详细信息请放入描述中
  • 若用户提供的信息不足,应在创建前主动询问,避免提交空描述的 PR
O
@oschina

已收录 1 个 Skill

相关推荐