用途:在创建 PR、撰写 PR 描述或使用 gh CLI 处理拉取请求时,帮助生成规范、清晰的 Pull Request。
主要能力:强制 PR 标题采用 conventional commit 格式 type(scope): description,类型包括 feat、fix、docs、refactor、test、chore;要求描述至少包含 Summary 与 Testing 两部分,并可用 Closes #N 关联并自动关闭 issue;提倡原子提交,一次提交只做一件事,大改动拆分为多个 PR。
使用方式:通过 gh pr create 创建,例如 gh pr create --title "feat(auth): add OAuth2 login" --body "...";复杂描述可用 HEREDOC 传入;支持 --draft 创建草稿、--web 打开网页编辑器、--reviewer 指定评审人、--label 添加标签。常用命令还有 gh pr status、gh pr diff、gh pr checks、gh pr merge --squash、gh pr edit --add-reviewer。
适用场景:准备提交评审、编写 PR 标题与描述、整理提交历史、使用 gh CLI 管理 PR。
限制:规则要求标题必须符合 conventional commit,模糊标题如 fix bug 或 update 会被拒绝;描述必须含 Summary 和 Testing;每个 PR 需逻辑原子化;不得直接从 main/master 创建 PR,应始终从功能分支使用 gh pr create。具体安装方式与平台支持暂未提供。