Worktrees 是 pokayokay 中管理 git worktree 的指南技能,用于在任务开发过程中创建隔离的工作树。
用途 该技能用于在 pokayokay 工作流中管理 git worktree,按任务类型决定是否创建独立工作树,并处理创建、复用、依赖安装与清理等环节。
主要能力
- 按任务类型决定工作树策略:feature、bug、spike 默认创建 worktree,可用 --in-place 覆盖;chore、docs 默认就地开发,可用 --worktree 覆盖;test 类型继承所属 story 的 worktree,同一 story 中的任务共享该工作树,也可通过显式标志指定。
- 基于 story 复用:同一 story 中的任务共享一个 worktree,便于处理相关改动。
- 自动安装依赖:创建 worktree 时根据检测到的 lockfile 自动安装依赖。
- 干净完成:使用 finishing-branch 选择合并、提交 PR、保留或丢弃,并附带验证证据。
- 隔离:所有 worktree 位于 .worktrees/ 目录,由 git 自动忽略。
使用方式 快速开始清单包括:任务类型决定使用 worktree 还是就地开发(见上表);story 工作树在相关任务间复用;依赖根据检测到的 lockfile 自动安装;完成时使用 finishing-branch 验证并选择合并、PR、保留或丢弃;如遇问题可用 git worktree list 排查。
适用场景 适用于 pokayokay 工作流中需要隔离开发的任务,尤其是 feature、bug、spike 类任务,以及同一 story 下多个相关任务的开发。
限制
- 不适用于启动工作会话:应使用 work-session,worktree 创建会在 /work 期间自动发生。
- 不适用于在 pokayokay 之外使用 git worktree:该技能专属于 pokayokay,通用 git worktree 请直接使用 git。
参考资料
- worktree-management.md:生命周期、完成选项、依赖安装、故障排查。
- cleanup-strategies.md:清理标准、检测、磁盘管理、计划清理。
- parallel-worktrees.md:并行执行的 worktree 隔离、冲突预防。