用途:插件更新后,worktree 技能(compound-engineering 的 git-worktree、superpowers 的 using-git-worktrees)会丢失自定义补丁,导致 Claude Code 不再提示在新 worktree 目录中启动新实例。本技能用于核验这些补丁是否仍然完好。
主要检查项:compound-engineering SKILL.md 中的“Claude Code + Worktree Working Directory”章节;compound-engineering worktree-manager.sh 在 create 后输出的“Open a NEW Claude Code instance”提示;superpowers SKILL.md 第 5 步报告中的“Launch Claude Code”;PreCompact 钩子的 getWorktreeContext 函数(用于压缩后保留 worktree 上下文)。marketplace 与最新缓存版本都会检查。
使用方式:运行 bash ~/.claude/scripts/verify-worktree-plugins.sh 进行核验;若有检查失败,运行 bash ~/.claude/scripts/verify-worktree-plugins.sh --patch 重新应用补丁。--patch 无法自动修复 TypeScript 钩子;若 PreCompact 钩子缺少 worktree 检测,需手动重新生成 ~/.claude/hooks/context-compression-hook.ts,加入 getWorktreeContext():通过 git rev-parse --git-dir 判断当前目录是否为 worktree(路径含 /worktrees/),是则输出分支、worktree 路径与主仓库路径,该输出会在压缩期间作为 <system-reminder> 注入;不在 worktree 时返回 null。最后向用户展示核验输出,并说明哪些文件需要打补丁。
背景与限制:Claude Code 的 statusline、git 上下文与系统提示在启动时确定,Bash 工具中执行 cd 不会改变进程 CWD,自动压缩后会回到启动目录的上下文,因此每个 worktree 需从该目录启动独立实例(cd /path && claude)。补丁确保创建 worktree 后提示用户新开终端并从 worktree 目录启动。建议在更新 compound-engineering 或 superpowers 插件后、worktree 创建不再显示启动说明时,或定期作为检查运行。资料未提供脚本安装方式、版本与具体兼容范围。