SuperAPI AI 工具集

harness-worktrees

测试与质量

查看项目

更新于 10-15 19:57

技能介绍

用途:面向采用「每个编码 harness 一个 git worktree」的仓库,提供 pi 原生的 worktree 维护能力,核心是让当前 worktree 与最新 origin/main 保持一致(Mode C)。

主要能力:当用户说「mode C」「get current with me」「reset this worktree to main」「sync this worktree with latest main」「after merge, make this worktree current」等时,视为明确指令,直接执行同步;也支持只做状态检查(是否落后、领先、有未提交改动或已同步)。

使用方式:执行同步运行脚本: ~/.pi/agent/skills/harness-worktrees/scripts/reset-worktree-to-main.sh --confirm 随后验证: ~/.pi/agent/skills/harness-worktrees/scripts/reset-worktree-to-main.sh 仅状态检查时只运行后一条(dry-run)。完成后报告分支、HEAD、ahead、behind、dirty 状态。

设计原因:多 worktree 场景下 main 可能已被其他 worktree 检出,git switch main 可能失败或违反所有权预期;因此应保留当前分支,fetch origin 后将当前分支重置到 origin/main。

限制与安全:脚本默认拒绝脏 worktree,除非传入 --stash;仅当用户明确要求保留或 stash 本地改动时才使用 --confirm --stash。不得切换到 main、不得强推、不得删除分支、不得手动执行 git reset --hard。Mode C 可能丢弃分支本地提交,这属于用户明确要求同步后的预期行为。控制台遗漏内容暂未提供。