用途：让一个刚创建的 git worktree 的开发服务器行为与当前主干（trunk）一致，实现项目无关，适用于任意 JavaScript/TypeScript 仓库，支持 macOS、Linux、WSL。
两种模式（自动检测）：在链接的 worktree 中运行则执行引导——追上主干、复制环境变量、安装依赖、检查 Next.js 固定项；在主检出（非 worktree）中运行则做一次性准备，审计分支级设置（.worktreeinclude 与 turbopack.root / allowedDevOrigins 固定项）并报告缺失项。
为何需要：worktree 的分支在创建时冻结，不会随主干前进，因而落后于提交；且 git worktree add 与 claude --worktree 只检出已跟踪文件，缺少开发服务器需要的被 gitignore 的文件，例如 .env.local/.env 会导致运行时报错，缺少 node_modules 会导致 pnpm run dev 出现 next: command not found。
用法：运行随附脚本，命令为 bash scripts/setup-worktree.sh（不在技能目录时使用该脚本的绝对路径），随后把摘要转达用户；准备模式下应用其建议。脚本幂等，已最新时重跑为无操作。
主要能力：通过 git merge --ff-only 快进到本地主干（动态解析，不硬编码），不安全时跳过继续；复制主检出中顶层被忽略的 .env* 文件，仅缺失时复制且不覆盖、不打印内容；根据锁文件识别包管理器（pnpm-lock.yaml→pnpm、package-lock.json→npm、yarn.lock→yarn、bun.lockb→bun）并执行对应安装；只读检查 next.config.* 是否缺少 turbopack.root 与 allowedDevOrigins 覆盖并打印修复建议。
限制：唯一历史改动是严格快进，若分支已分叉需自行 git rebase；配置固定项属于源代码，真正缺失时需在主干添加一次；monorepo 中应用位于内部时应去掉 turbopack.root: import.meta.dirname 固定项。路径与主干均经 git 解析，不用 eval，仅运行 git、cp 与检测到的包管理器安装命令。费用与平台支持等未提供。