用途:worktree-workspace 用于将同一个项目下的多个 Git worktree 集中到一个 VS Code 窗口里打开,方便集中查看、审阅或管理这些 worktree。
主要能力:运行该技能提供的脚本,会生成一个 .code-workspace 文件并在 VS Code 中打开。文件中的每个文件夹会按对应 agent 会话的最新标题进行标注;主检出目录排在最前,标注为 <repo> · <branch>。如果某个 worktree 没有自己的会话,则显示文件夹名和最后一次提交的主题;如果两个文件夹共享同一标签,会追加 · <folder> 加以区分。脚本默认只列出 <checkout>/.claude/worktrees 下的 worktree,使用 --all 可加入其余 worktree。会话标题可来自 --sessions 指定的 JSON 文件(每个会话包含 cwd 和 title,Claude Code 桌面版的 list_sessions 输出可用),否则从 Claude 桌面应用的会话存储读取;该存储格式为私有格式,脚本在格式变化时会报错停止,而不是写入无标签文件夹。
使用方式:在任意文件夹运行 node <this skill>/scripts/workspace.mjs --repo <checkout> --open。脚本会写出 <checkout parent>/<repo>-worktrees.code-workspace 并打开。需要刷新标签时重新运行命令即可,VS Code 会重新加载已打开的工作区文件。脚本会打印路径和标签列表。
适用场景:需要在一个窗口中审阅多个 worktree、按 agent 会话标题识别各分支工作区、或统一管理项目 worktree 时使用。
限制:脚本不会移动文件夹,因为应用通过工作文件夹跟踪会话,而标题会随阶段变化。默认仅列出 .claude/worktrees 下的 worktree;会话存储格式为私有格式,发生变化时脚本会报错停止。标题来源依赖 --sessions 文件或 Claude 桌面应用会话存储,若两者均不可用则无法正常标注。