SuperAPI AI 工具集

pr-creator

通用与其它

查看项目

更新于 10-16 06:46

技能介绍

用途:创建或更新 GitHub PR 的标题、正文、草稿状态和审阅人,并可为 UI 改动附加图片或视频,让评审者无需检出分支即可看到变化。不负责修改 diff 中的代码或评审 bug(用 tidy),不监控 PR 创建后的 CI 与评论(用 pr-babysitter),也不做 npm 发布(用 autoship)。

主要能力与规则:标题带 Linear ID 时为“ABC-123: Add auth flow”,无 ID 则省略前缀,控制在 60 字符内且不加句号;仓库若配置了 PR 标题校验工作流,则按其格式并把 ID 放在末尾。正文为一段简短说明,讲清改了什么和为什么重要,长度随改动规模而定。理由若不在提示、issue、分支、提交或 diff 中,就不编造。仅在涉及迁移、计费、认证、权限、不可逆写入、大影响范围或细微行为变化时写一行 Risk;仅在 diff 中仍有待决决策时写一行 Input wanted;只写实际运行过的测试;不写 Test plan 章节和复选框。部分完成时标题不放 issue ID,正文写 Part of ABC-123。仅在用户要求时加 --draft 或 --reviewer。仓库存在 PR 模板时按其标题结构作答,正文写在第一个标题下。

使用方式:先检查分支与相对基线的三方 diff,已存在 PR 用 gh pr view --json url,state,isDraft 判断是编辑还是新建;有噪声提交或超过 500 行 diff 时先参考 pr-polish。推送后创建:git push -u origin HEAD,gh pr create --title "ABC-123: Add auth flow" --body-file /tmp/pr-body.md,再 gh pr view --json url,title 返回 URL。更新用 gh pr edit --title ... --body-file ...(整体覆盖)。附加视觉:gh pr edit 42 --attach ./demo.mp4,并在最后重写正文后再附加,之后读取 gh pr view 42 --json body 确认已上传为 /user-attachments/assets/... 链接。

限制:非交互式 gh pr create 必须提供 --title 与 --body(或 --fill),--fill 会照抄提交信息。--attach 需要 gh 2.99.0 以上、用户令牌、仓库推送权限,且仅支持 github.com 或 GHE Cloud,GHES 不支持附件。不应先请用户确认描述,以提高效率。Linear ID 需从分支推导、不可猜测。首次推送前完成提交重构,避免强推导致既有行内评论失效。相关内容以资料为准,暂未提供其他收费或平台信息。