mcpField
S
sending-pull-request

sending-pull-request

github.com/wkentaro开发0225 次安装2 天前更新
代码仓库

关于 sending-pull-request

此技能规定了准备和提交代码审查请求的流程,涵盖分支与差异检查、PR 文案、证据评估及草稿状态管理。也区分仅撰写或审阅 PR 文案的请求,避免修改仓库或远程平台。

主要功能

  1. 01检查远程分支、提交和工作区变更
  2. 02按规范整理工作分支
  3. 03根据差异撰写 PR 标题和正文
  4. 04评估证据并管理草稿 PR 状态
  5. 05仅文案请求不修改仓库或远程平台

适用场景

  1. 01将本地工作提交审查
  2. 02更新现有 PR 的标题和正文
  3. 03仅起草或审阅 PR/MR 文案
  4. 04根据证据状态决定 PR 是否就绪

安装

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

$npx skills add https://github.com/wkentaro/agent-skills --skill sending-pull-request

安装后在 Claude Code 中输入/sending-pull-request确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

BODY.md
MEDIA.md
evals/
evals.json

详细介绍

发送拉取请求

如果用户只要求撰写或审阅 PR/MR 标题或正文,请检查提供的上下文,阅读 BODY.md,并返回文案,不要更改仓库或代码托管平台。如果用户要求提供证据,请阅读 MEDIA.md 了解格式指南,仅使用提供的证据,并将未经验证的证据标记为待处理。对于仅要求撰写文案的请求,不要运行捕获或发布工作流。

要提交工作以供审阅:

  1. 获取 origin,确定当前分支和默认分支,并检查相对于 origin/<default> 的提交和工作树变更。如果没有要提交的工作,则停止。

  2. 将工作放到符合 <type>/<short-kebab-description> 规范的分支上,不要暂存或更改工作:

    • 保留符合规范的非默认分支。

    • 如果当前处于默认分支,则根据工作内容及其 Conventional Commit 类型选择分支名,然后在重置本地默认分支前保留所有提交和工作树变更:

      git switch --no-track -c <new-branch>
      git branch -f <default> origin/<default>
      
    • 使用 git branch -m <new-branch> 重命名明显由工具自动生成的占位分支。

    • 如果当前处于其他不符合规范的分支,则停止,除非用户要求重命名。

  3. 确认分支和工作未发生变化。如果任何预期变更尚未提交,则停止。

  4. 检查相对于默认分支的提交和差异。撰写一条不超过 70 个字符的 Conventional Commit 标题,阅读 BODY.md,并根据差异无法说明的内容撰写正文。在下方的证据评估完成前,保留任何现有的 `` 块。

  5. 检查当前分支是否有未关闭的 PR。推送并设置跟踪;只有在有意改写历史后,才使用 --force-with-lease。

  6. 使用临时 --body-file 创建草稿 PR,或更新现有 PR 的标题和正文,并在完成后删除临时文件。证据待处理时,保持现有 PR 为草稿;必要时使用 gh pr ready --undo。

  7. 每次创建或更新 PR 时都要评估证据,包括非视觉变更,并遵循 MEDIA.md。此技能负责证据决策、文本证据、验证和恢复。对于需要捕获或发布的截图或录屏,调用现有的 before-and-after 技能;无需修改该技能,也无需制定新的结果约定。

  8. 证据验证通过或有意跳过后,按预期设置就绪状态:用户直接调用时,使用 gh pr ready 将 PR 标记为就绪;自主调用时,除非用户另有要求,否则保持草稿状态。若失败,则将 PR 保持为草稿,并通过 PR URL 报告缺失的证据或阻碍。绝不合并或批准 PR。

评论

支持 Markdown