用途:为任何新功能、缺陷修复或故事开发提供隔离的 Git 工作树工作流,所有工作通过 Worktrunk(wt)管理,禁止直接在 main 分支上操作。
主要能力:创建隔离工作树、切换与列出工作树、生成提交信息、合并回 main 并自动清理。
使用方式:开始工作时运行 wt switch --create <branch-name> 创建 worktree,分支命名约定为 story/STORY-ID、feat/<description>、fix/<description> 或 refactor/<description>。随后执行 pnpm install、pnpm build、pnpm test 验证基线,若测试在未改动前失败应报告用户而非继续。开发中使用 git add 与 git commit 提交,遵循 conventional commits,也可用 wt step commit 生成提交信息;用 wt list 查看工作树状态,用 wt switch <branch-name> 切换。完成时依次运行 pnpm check-types、pnpm test、pnpm build,全部通过后 git push -u origin <branch-name> 并用 gh pr create 创建 PR,最后 wt merge 执行 squash 合并、清理工作树并删除分支。若合并冲突,手动解决后 git add、git rebase --continue,再重试 wt merge;必要时用 wt remove 清理。
适用场景:功能开发、缺陷修复、重构、执行计划任务或调度子代理前创建隔离工作区。
限制与规则:不得直接在 main 工作;合并前必须验证测试;一个 worktree 对应一个功能;频繁提交小粒度变更;合并后由 wt merge 自动清理。该技能替代 superpowers:using-git-worktrees 与 superpowers:finishing-a-development-branch。