用途：在同一个仓库中并行开发多个功能。每个功能分支使用一个 git worktree，配合 Portless 命名本地 URL 与隔离的本地状态，安全完成合并与清理，避免破坏无关工作。
主要能力：优先使用仓库本地脚本（如 wt:create、wt:list、wt:doctor、wt:runtime、wt:overlap、wt:finish、wt:clean、wt:prune）；创建同级 worktree 目录 ../<repo>.worktrees/<branch-slug>；集成检出使用 https://<project>.localhost，功能 worktree 使用 https://<branch-slug>.<project>.localhost；隔离数据库、缓存、队列、对象存储、浏览器配置等可变状态；提供重叠检查、完成策略（默认 merge，可选 squash）与清理流程。
使用方式：先阅读 AGENTS.md、.agents/skills/worktree/SKILL.md、package.json 脚本等仓库说明；创建前运行 pnpm wt:doctor，创建时运行 pnpm wt:create feature/my-task，并在新 worktree 内执行依赖安装（如 pnpm install）；通过 pnpm dev 等 Portless 脚本启动；完成后运行 pnpm wt:finish feature/my-task。Portless 为必需配套，可通过 npx skills add https://github.com/vercel-labs/portless --skill portless 安装。
适用场景：需要同时推进多个功能分支、需要稳定回调 URL（OAuth、webhook）、需要隔离本地数据库与运行时状态的日常开发。
限制：若仓库缺少 worktree 工作流，需按 generic-worktree-commands.md 回退；若无法为每个 worktree 提供独立本地数据库，涉及 schema、迁移、种子数据或持久状态的工作应视为阻塞；不得在脏 worktree 上合并或强制清理；不得绕过共享后端运行时守卫；Portless 不可用时仅可临时使用数字端口，且不适用于 OAuth、webhook 或浏览器自动化交接。安装技能与项目初始化是分开的步骤，安装技能不会自动修改仓库。