关于 open-pr
open-pr 是用于准备和创建可审阅拉取请求的仓库工作流技能。它将提交限制在任务文件内,并检查分支及请求状态,最后返回验证依据和链接或草稿。
主要功能
- 01检查仓库与拉取请求状态
- 02仅暂存明确指定的文件
- 03创建、推送或更新拉取请求
- 04依据完整变更范围撰写说明
适用场景
- 01只起草说明而不更改远程仓库
- 02为已完成的改动创建拉取请求
- 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。
职责范围
仅要求撰写说明的请求属于只读操作。要求打开拉取请求的请求授权在需要时创建功能分支,仅暂存任务涉及的文件,提交这些文件、推送分支,并创建或更新其拉取请求。此请求不授权暂存无关工作、改写其他贡献者的工作、合并,或更改远程设置。
工作流
- 检查仓库状态、当前分支、预期变更文件、远程仓库、默认分支,以及当前分支头对应的任何未关闭拉取请求。若拉取请求查询失败,应视为状态未知,而非证明不存在拉取请求。
- 选择处理方式:
- 仅撰写说明:拟定并返回标题和正文。不要修改远程仓库。
- 已有拉取请求:推送限定范围内的提交;仅当请求包含更新正文时才更新正文。
- 新建拉取请求:若当前分支是默认分支或处于分离状态,则创建功能分支,然后提交、推送并创建拉取请求。
- 若必须从默认分支创建分支,请阅读
references/branch-creation.md。不要自动暂存、重置,或在有冲突的本地更改时切换分支。 - 仅暂存明确指定的文件。不要将工作树中的无关更改纳入提交。只有在变更明确包含具有独立审查价值的部分时才拆分提交。
- 阅读
references/pr-description-writing.md。根据完整变更范围撰写,而非仅依据最新提交。先说明结果,交代验证情况或其限制,并保留项目要求的模板字段。 - 在推送或创建拉取请求之前,立即重新检查分支和现有拉取请求。如果状态仍未知,请停止并报告阻碍因素,以免创建重复的拉取请求。
- 通过临时文件应用正文,确保其原文内容在命令执行后保持不变。平台允许时,确认生成的 URL、标题和正文。
边界
遵循仓库当前采用的提交消息和拉取请求结构规范。提交消息、标题或正文中不得添加生成说明、作者身份声明或共同作者尾注。除非有捕获的输出作为证据,否则不得声称某项检查已运行。
输出
以拉取请求 URL 或拟定标题开头。说明分支、已完成的提交、验证依据和任何已知限制。对于仅撰写说明的任务,返回标题和正文,不要应用它们。
评论
支持 Markdown