用途:把当前分支上的改动整理成可评审的提交并推送到远程,然后向 main 创建 Pull Request,同时可在用户明确要求时生成仓库默认文件。
主要能力:先执行 git status --short 查看状态;不动无关的脏文件;按语义目的分组,必要时把混合改动拆成多个提交;使用简短、带作用域的 Conventional Commit 信息;若当前分支是 main 则先建工作分支,否则留在当前分支;提交全部预期改动后再推送;用 gh pr create 向 main 开 PR,标题遵循 Conventional Commits,正文按 repo-defaults.md 构建,达到可评审标准。一次性交付 PR(原 ship-pr 覆盖的场景)需阅读 one-shot-pr.md 并使用 scripts/inspect_git_state.py。
提交规则:每个语义变更一个提交;提交顺序按评审价值排列:feat、fix、test、docs、refactor、chore;不要 stage 无关文件,也不要使用 git add .,除非整个任务就是一个连贯改动;若工作树混杂到无法干净拆分或归属不明,则应停止。
仓库默认:仅当用户明确要求创建缺失的仓库默认项时,才按 repo-defaults.md 生成文件;否则不添加仓库级模板或 Release Please 文件。资源包括 scripts/inspect_git_state.py、references/one-shot-pr.md、references/repo-defaults.md。限制:资料未提供安装命令、价格、平台、效果及更详细使用步骤。