用途
Open PR 用于在 GitHub 上创建可审查的 Pull Request,让标题、正文和提交记录清楚说明变更内容及其证据。它的下一个消费者是审查者,因此完成标准是返回所请求的描述,或确认远程 PR URL。
主要能力
- 读取仓库状态、当前分支、目标文件、远程仓库、默认分支,以及当前 head 对应的开放 PR。
- 支持三条路线:仅生成描述;推送限定范围的提交并更新已有 PR 正文;创建功能分支、提交、推送并新建 PR。
- 在需要从默认分支创建分支时读取分支创建参考文档;不会自动 stash、reset 或切换经过冲突的本地改动。
- 只暂存明确指定的文件;仅当变更具有明显独立的审查价值时才拆分提交。
- 依据完整的变更范围撰写 PR 描述,而非仅看最新一次提交。
- 推送或创建前重新检查分支和已有 PR,状态未知时停止并报告,避免重复 PR。
使用方式
当用户要求打开 Pull Request、提交并推送工作,或撰写 PR 描述时使用。技能在当前协调器中运行,不派发 worker。选择模型前需先确定分支。描述正文通过临时文件应用,以保留字面内容;平台允许时会确认生成的 URL、标题和正文。输出先给出 PR URL 或草拟标题,再说明分支、提交、验证证据和已知限制;仅描述任务则直接返回标题和正文,不应用。
适用场景
- 用户要求为当前改动打开 Pull Request。
- 用户要求提交并推送工作,并撰写 PR 说明。
- 需要更新已有 Pull Request 的正文。
限制
- 仅描述请求是只读的,不修改远程仓库。
- 不授权暂存无关工作、重写他人工作、合并或修改远程设置。
- 遵守仓库现行的提交信息和 PR 结构约定。
- 不在提交信息、标题或正文中添加生成声明、作者身份声明或共同作者 trailer。
- 未捕获到输出时,不声称检查已运行。
- 该技能的官方文本、定价或收费信息暂未提供。