SuperAPI AI 工具集

upstream-pr-staging

通用与其它

查看项目

更新于 10-16 05:06

技能介绍

用途:在向 GitHub 上游提交 PR 前,先在用户 fork 内做低干扰收敛,再整理成正式上游 PR。

主要能力:区分内部 draft 与正式上游 PR 两条路径;内部 draft 默认中文标题正文、低干扰,不触发上游 backlink、mention 或通知,不使用 fixes/closes/resolves 等关键词;正式 PR 使用 repo-native 视角,重写标题、正文与提交历史,只保留动机、行为变化与验证证据。支持正式 PR 重放,从最新上游基准新建分支按阶段重放 red/green/cleanup 提交。

使用方式:先确认 fork 基准分支是否对齐上游,可 fast-forward 则按授权更新,分叉则停下确认;从基准分支新建特性分支,分支名默认不含上游编号;PR repo 指向 fork、base 指向 fork 基准分支。草稿正文写到 /tmp/*.md,再用 gh pr create --body-file 或 gh pr edit --body-file。提交或推送前使用 git-workflow,操作 GitHub PR、checks、workflow、job 时使用 github-cli。

链接策略:内部低干扰场景引用上游 issue/PR/commit/discussion 时用 Markdown 链接配合 redirect.github.com;正式 PR 同仓库引用默认写成 #1050 形式,跨仓库或需自定义文本才用 Markdown URL;同仓库 commit 证据默认裸写完整 40 位 SHA。

Red/Green 证据:仅 bugfix 需证明回归测试有效时使用三阶段,不要一次性推送 red 和 green。Red 只加复现测试,旧实现须能编译,失败须来自行为断言;Green 只加生产代码,不改已确认有效的测试;Cleanup 删除临时 workflow 与调试脚本,保留正式测试和修复。

适用场景:草稿 PR、内部 PR、fork draft、先内部 review/CI、red/green 证据等。

限制:fork 基准分叉、需 force-push、red 失败非行为断言、green 须改 red 测试、无法判断 backlink 时需停下确认。正式 PR 后续修改默认只做本地改动,不自动提交推送。其余细节暂未提供。