SuperAPI AI 工具集

prepare-pr

通用与其它

查看项目

更新于 10-16 09:58

技能介绍

用途:在 /review-pr 之后把 PR head 分支准备到可合并状态。

主要能力:init 初始化并生成 .local 下评审与准备产物;从强制存在的 .local/review.json 读取结构化评审,列出并修复全部 BLOCKER 与 IMPORTANT 项;更新 changelog 与文档;用 scripts/committer 以明确文件列表提交,主题简洁、不带 PR 编号或致谢;通过 wrapper 运行门禁;安全推送到 PR head。

使用方式:先运行 scripts/pr-prepare init <PR>,按需用 jq 列出待修复项,修复后运行 scripts/pr-prepare gates <PR>,再运行 scripts/pr-prepare push <PR>。也提供一次性路径 scripts/pr-prepare run <PR>。PR 编号或 URL 需询问;缺失时可从 PR worktree 的 .local/pr-meta.env 读取。

安全与限制:禁止推送到 main;仅对已知 head SHA 显式使用 --force-with-lease 推送到 PR head;禁止 git clean -fdx;wrapper 与工作目录无关,可在仓库根或 PR worktree 运行;push 内含 fork 远端解析、推送前远端 SHA 校验、一次自动 rebase 加重跑门禁重试、推送后 API 传播重试、幂等行为与推送后 SHA 校验,并生成 .local/prep.env。本技能不执行 gh pr merge,也不删除 worktree。完成后输出简要修复与门禁结果,并打印:PR is ready for /merge-pr。

适用场景与限制:适用于需要按评审结论、以确定性推送安全方式准备 PR 的仓库流程。具体依赖环境、脚本实现与门禁内容资料未完整提供。