用途:pr-branch 是一个 Agent Skill,用于从当前分支打开或更新对应的 GitHub PR;在需要时执行普通推送,不使用强制推送。当用户调用 pr-branch,或明确要求创建、刷新 PR 时触发。
主要能力:调用即视为授权打开/更新匹配的 PR 并执行必要的非强制推送,无需再次询问;但不会据此推断出提交未提交工作、修改实现、改写历史、合并或进入下一流程阶段的权限。显式提出的更窄要求(如仅写描述、不推送)会被遵守。每次调用或恢复时,会读取当前项目指引并检查检出、分支、HEAD、工作状态、远端与 PR 状态,解析仓库、head owner/branch 与 base(含 fork 和堆叠工作)。会按仓库与精确 head/base 身份查找匹配的开放 PR 并更新,而非重复创建;无法提出已提交变更时会说明情况,不创建空 PR。
使用方式:按照 assets/pr-template.md 填充标题与正文,保留两段受众结构、比较表格、分隔符与技术记录;所选语言应用于标题、标题层级、表格标签与正文,命令和代码标识保持原样。保存完整标题与正文后运行结构检查:
node <SKILL_DIR>/scripts/validate-pr-artifact.mjs --title-file <TITLE_FILE> --body-file <BODY_FILE>
其中 SKILL_DIR 指向本已安装包;Node 不可用时需直接检查相同结构并披露脚本未运行。发布使用 gh pr create / gh pr edit 或等价 API,配合 --body-file 等结构化字段,禁止将 PR 文本插值进 shell 代码。发布前重新核对本地 head、远端 base/head 与 PR 内容,只在需要时向已解析的远端分支进行非强制推送。
语言与事实:语言先取当前请求的明确指示,其次取 AGENTS.md、Agent.md、README.md 等项目主指引中的明确规则,二者都没有则默认英文;对话语言、编程语言或 README 使用其他语言不改变该默认。事实依据来自完整已提交历史与 diff,使用 git diff BASE_REV...HEAD_REV 取 PR 变更、BASE_REV..HEAD_REV 统计提交数;未提交变更不计入交付声明并需说明其被排除。
限制:不编造节省、收入、规模、事故、保证或验证;不假设团队或组织角色;不将可能的失败描述为已发生事件。通过命令成功不等于发布成功,需回读并核验 URL、仓库、base、head commit、标题与完整正文。刷新时基于当前证据重写陈旧声明,不追加更新日志,也不添加 AI 署名。