用途:为已完成的 React Router 工作创建并打包拉取请求(PR)。默认创建以 main 为基线的草稿 PR,除非用户明确要求就绪 PR 或其他基线分支。
主要能力与流程:检查 git status --short --branch 和 git branch --show-current;不混入无关的脏文件,若有则保持未暂存并说明;若处于 detached 状态,则从当前 HEAD 新建分支,命名优先用用户指定名、仓库既有约定或 <author>/<semantic-name>;确认已有或已添加适当的自动化覆盖;若涉及面向用户的功能更新,检查相应包在 packages/<package>/.changes/ 下是否有变更文件(仅文档、GitHub Actions/工作流或依赖维护类 PR 通常不需要)。
上下文与提交:整理改了什么、为何改、影响谁,关联相关 issue、讨论或 PR 并附链接;小改动优先用 git diff --stat 加聚焦的 git diff。仅暂存目标文件,用简洁的祈使句提交主题,推送分支后再创建 PR。
PR 创建:把 PR 正文保存到临时文件,然后执行 gh pr create --draft --base main --head <branch> --title "<title>" --body-file <file>。仅在用户明确要求时就绪 PR 才省略 --draft;仅在用户明确要求时才改 --base。正文以一两句说明变更目的开头,不用 ## Summary 标题;需要时补充要点、新功能用法示例或替换/改进的前后对比示例;仅在有人工检查等情况下加 Testing 小节。不要在正文列出 lint、类型检查、单元或集成测试命令。
标签:PR 创建后用 gh pr edit <number-or-url> --add-label "<label>" 打标签,失败时用 gh label list --limit 200 查看真实标签并据实调整。按改动路径添加对应 pkg:* 标签(如 packages/react-router/ 对应 pkg:react-router),按行为领域添加 feat:* 标签(如路由核心 feat:router、routes.ts、Vite、SPA 模式、预渲染等),文档、工作流、依赖分别用 docs、github-actions、dependencies。
限制:gh pr create 失败时尽量保留已推送分支,并向用户提供可直接打开的 compare URL 及准备好的标题和正文。最终报告分支名、提交哈希、PR URL 及是否为草稿、基线分支、已应用标签、执行或跳过的验证。具体收费、价格、平台等信息暂未提供。