SuperAPI AI 工具集

land

部署与运维

查看项目

更新于 10-15 22:14

技能介绍

WT Land 是 wt 工作流中的收尾技能,用于工作通过评审、被明确丢弃,或用户要求对已关闭的 wt 工作做复盘时。它不用于监控活跃智能体或请求修复,那属于 work 的职责。在 LEAF 模型中,它负责评审/同步之后的最终关闭与反馈:证明集成或丢弃、执行适用的工作流 pass、在关闭安全后再清理,并记录应反馈到下一周期的复盘经验。

使用前需预检:用 wt inspect、wt agent status、git status、git log 检查目标,确认工作树干净、父分支前有有效提交、检查已通过、工作流 landing 策略已知、集成分支明确、分支可无冲突合并。工作流工作须遵循准备好的策略快照:landing=manual 时除非用户明确指示否则评审后停止;landing=auto 时评审通过即可继续,但仍需执行各项安全门。非工作流任务需用户明确指示或仓库策略。集成分支不假设 main/master,按用户指示、wt inspect 父分支、当前分支顺序选择,冲突时先询问。

落地前先用 git merge-base --is-ancestor 证明是否已集成;未集成则先在临时集成工作树中试合并。硬性规则:协调者不在落地时解决任务分支合并冲突,冲突须中止合并并交回任务智能体,通过规范收件箱路由(优先评审反馈)通知。仅当用户明确要求协调者接管时才在协调者检出中解决冲突。无冲突后从干净集成检出执行 git switch、git pull --ff-only、git merge --ff-only。

栈模式按从底到顶顺序落地,每个子切片合并前须将 PR base 重新指向集成分支(用 gh api PATCH base),否则 squash 提交会落到栈父分支而非集成分支。若已错误合并,可用 cherry-pick 到集成分支的恢复流程,但应视为回退方案。

清理仅在落地被证明后进行:git merge-base --is-ancestor、wt done、git worktree list、git branch --list。丢弃清理须说明并确认无有用未合并工作。复盘在落地或丢弃清理后、报告生命周期完成前写入 <repo-root>/.wt/execution/retrospectives/YYYY-MM-DD-<slug>.{md,toml},默认不提交。报告需包含落地分支、集成分支与合并提交、pass 命令、清理命令、复盘路径、检查与遗留缺口、剩余工作树或分支。