SuperAPI AI 工具集

land

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:将明确选定的一个 GitHub PR 作为“保留证据的落地协议”完成合并,覆盖评审线程清点、评审关闭、合并准入、精确 head 合并、实时终态回读与清理。

主要能力:对每个未解决评审线程给出有证据的处置;head 变更后作废旧 epoch 并重新绑定新 head、重取完整评审清单并重新预检;通过脚本 evaluate_preflight.py 评估合并准入;合并前重复当前 head 评审扫描并重取 headRefOid,传给合并命令的精确 head 守卫;合并成功后按顺序清理关联 worktree、远端与本地分支并做终态验证。

使用方式:仅在用户明确表达合并/落地意图时调用;先绑定不可变 landing epoch(仓库、PR 编号、base、head 仓库/ref/OID 等),按状态模型选择 reconcile-reviews、rebind-successor-head、merge-now、queue-and-wait、auto-merge-and-wait、cleanup-only 或 obstructed 之一。预检命令示例:land_skill_root="$(realpath "$HOME/.agents/skills/land")" 与 uv run python3 "$land_skill_root/scripts/evaluate_preflight.py" <snapshot.json>。退出 0/pass 表示可合并,3/continue 走非终态路线,2/block 保留状态并报告确切阻碍。

适用场景:需要在不丢失证据的前提下安全合并已选定 PR,并处理评审意见与清理。

限制:仅看检查或流程、关闭未合并 PR、无合并目标删分支或 worktree、普通本地同步、打开/更新/推广 PR 均不应使用;不得合并歧义目标;未解决线程不得视为终态;不得用裸线程 ID 批量解决;不得跨 head 变更复用证据;普通 $land 不使用 --admin;不得把排队、已启用 auto-merge 或命令成功当作已合并;未达实时 MERGED 前不得清理。其他收费、平台等信息暂未提供。