w-pr 是一个面向 Git 工作流的技能,用于为指定分支创建或更新可评审的拉取请求(Pull Request)。它来自 blockmatic/basilic-skills 技能集,调用时会请求发布目标分支并创建其 PR。
用途 该技能用于在开发任务完成后,将任务相关的改动整理并发布为可评审的 PR。它强调 PR 描述本身就是该流程的一部分,不需要再单独执行生成描述的步骤。
主要能力
- 确保任务相关改动已提交并通过验证,必要时使用 commit。
- 在需要新建分支时,先执行 git fetch origin,再使用 git switch -c <name> --no-track origin/main,避免基于过期的本地 main 分支。
- 使用 push 推送目标分支。
- 撰写独立的 PR 描述,内容涵盖问题、改动后的行为、验证证据和重要限制,并遵循仓库模板,不创建空描述。
- 在仓库要求时使用约定式 PR 标题。
- 复用该分支已有的 PR,而不是重复创建。
- 使用已知且适用的标签和评审人,不编造指派。
- 使用 CLI 时,将多行文本写入临时文件并通过 body-file 选项传入。
- 验证生成的标题、目标分支和描述,并返回 PR 链接。
使用方式 调用该技能后,按照上述流程依次完成提交、分支处理、推送、描述撰写和 PR 创建或更新。若分支已存在 PR,则更新而非新建。完成后返回 PR 链接。
适用场景 适用于需要为某个分支创建或更新可评审 PR 的 Git 协作流程,尤其是需要遵循仓库模板、约定式标题和规范标签/评审人管理的项目。
限制 创建 PR 并不授权合并或部署。该技能不负责合并、部署或发布操作。标签和评审人只能使用已知且适用的,不得自行编造。若仓库没有提供模板或相关要求,则暂未提供更多细节。