关于 sending-pull-request
此技能规定了准备和提交代码审查请求的流程,涵盖分支与差异检查、PR 文案、证据评估及草稿状态管理。也区分仅撰写或审阅 PR 文案的请求,避免修改仓库或远程平台。
主要功能
- 01检查远程分支、提交和工作区变更
- 02按规范整理工作分支
- 03根据差异撰写 PR 标题和正文
- 04评估证据并管理草稿 PR 状态
- 05仅文案请求不修改仓库或远程平台
适用场景
- 01将本地工作提交审查
- 02更新现有 PR 的标题和正文
- 03仅起草或审阅 PR/MR 文案
- 04根据证据状态决定 PR 是否就绪
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ wkentaro/ agent-skills --skill sending-pull-request安装后在 Claude Code 中输入/sending-pull-request确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
BODY.mdMEDIA.mdevals/evals.json详细介绍
发送拉取请求
如果用户只要求撰写或审阅 PR/MR 标题或正文,请检查提供的上下文,阅读 BODY.md,并返回文案,不要更改仓库或代码托管平台。如果用户要求提供证据,请阅读 MEDIA.md 了解格式指南,仅使用提供的证据,并将未经验证的证据标记为待处理。对于仅要求撰写文案的请求,不要运行捕获或发布工作流。
要提交工作以供审阅:
-
获取
origin,确定当前分支和默认分支,并检查相对于origin/<default>的提交和工作树变更。如果没有要提交的工作,则停止。 -
将工作放到符合
<type>/<short-kebab-description>规范的分支上,不要暂存或更改工作:-
保留符合规范的非默认分支。
-
如果当前处于默认分支,则根据工作内容及其 Conventional Commit 类型选择分支名,然后在重置本地默认分支前保留所有提交和工作树变更:
git switch --no-track -c <new-branch> git branch -f <default> origin/<default> -
使用
git branch -m <new-branch>重命名明显由工具自动生成的占位分支。 -
如果当前处于其他不符合规范的分支,则停止,除非用户要求重命名。
-
-
确认分支和工作未发生变化。如果任何预期变更尚未提交,则停止。
-
检查相对于默认分支的提交和差异。撰写一条不超过 70 个字符的 Conventional Commit 标题,阅读 BODY.md,并根据差异无法说明的内容撰写正文。在下方的证据评估完成前,保留任何现有的 `` 块。
-
检查当前分支是否有未关闭的 PR。推送并设置跟踪;只有在有意改写历史后,才使用
--force-with-lease。 -
使用临时
--body-file创建草稿 PR,或更新现有 PR 的标题和正文,并在完成后删除临时文件。证据待处理时,保持现有 PR 为草稿;必要时使用gh pr ready --undo。 -
每次创建或更新 PR 时都要评估证据,包括非视觉变更,并遵循 MEDIA.md。此技能负责证据决策、文本证据、验证和恢复。对于需要捕获或发布的截图或录屏,调用现有的
before-and-after技能;无需修改该技能,也无需制定新的结果约定。 -
证据验证通过或有意跳过后,按预期设置就绪状态:用户直接调用时,使用
gh pr ready将 PR 标记为就绪;自主调用时,除非用户另有要求,否则保持草稿状态。若失败,则将 PR 保持为草稿,并通过 PR URL 报告缺失的证据或阻碍。绝不合并或批准 PR。