mcpField
O
open-pr

open-pr

github.com/robsonrung开发248 次安装4 天前更新
代码仓库

关于 open-pr

open-pr 是用于准备和创建可审阅拉取请求的仓库工作流技能。它将提交限制在任务文件内,并检查分支及请求状态,最后返回验证依据和链接或草稿。

主要功能

  1. 01检查仓库与拉取请求状态
  2. 02仅暂存明确指定的文件
  3. 03创建、推送或更新拉取请求
  4. 04依据完整变更范围撰写说明

适用场景

  1. 01只起草说明而不更改远程仓库
  2. 02为已完成的改动创建拉取请求
  3. 03按要求更新现有请求说明

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/robsonrung/rar-skills --skill open-pr

安装后在 Claude Code 中输入/open-pr确认已加载。

附带文件references/branch-creation.mdreferences/pr-description-writing.md

详细介绍

打开拉取请求

选择分支后再选择模型。此工作流使用当前协调器和直接工具运行,不会分派工作者。

创建一个便于审查的拉取请求,其标题、正文和提交都能说明变更及其依据。下一位使用者是审查者。完成的标准是已返回所需说明,或已确认远程拉取请求 URL。

职责范围

仅要求撰写说明的请求属于只读操作。要求打开拉取请求的请求授权在需要时创建功能分支,仅暂存任务涉及的文件,提交这些文件、推送分支,并创建或更新其拉取请求。此请求不授权暂存无关工作、改写其他贡献者的工作、合并,或更改远程设置。

工作流

  1. 检查仓库状态、当前分支、预期变更文件、远程仓库、默认分支,以及当前分支头对应的任何未关闭拉取请求。若拉取请求查询失败,应视为状态未知,而非证明不存在拉取请求。
  2. 选择处理方式:
    1. 仅撰写说明:拟定并返回标题和正文。不要修改远程仓库。
    2. 已有拉取请求:推送限定范围内的提交;仅当请求包含更新正文时才更新正文。
    3. 新建拉取请求:若当前分支是默认分支或处于分离状态,则创建功能分支,然后提交、推送并创建拉取请求。
  3. 若必须从默认分支创建分支,请阅读 references/branch-creation.md。不要自动暂存、重置,或在有冲突的本地更改时切换分支。
  4. 仅暂存明确指定的文件。不要将工作树中的无关更改纳入提交。只有在变更明确包含具有独立审查价值的部分时才拆分提交。
  5. 阅读 references/pr-description-writing.md。根据完整变更范围撰写,而非仅依据最新提交。先说明结果,交代验证情况或其限制,并保留项目要求的模板字段。
  6. 在推送或创建拉取请求之前,立即重新检查分支和现有拉取请求。如果状态仍未知,请停止并报告阻碍因素,以免创建重复的拉取请求。
  7. 通过临时文件应用正文,确保其原文内容在命令执行后保持不变。平台允许时,确认生成的 URL、标题和正文。

边界

遵循仓库当前采用的提交消息和拉取请求结构规范。提交消息、标题或正文中不得添加生成说明、作者身份声明或共同作者尾注。除非有捕获的输出作为证据,否则不得声称某项检查已运行。

输出

以拉取请求 URL 或拟定标题开头。说明分支、已完成的提交、验证依据和任何已知限制。对于仅撰写说明的任务,返回标题和正文,不要应用它们。

评论

支持 Markdown