用途:该技能在 Git 仓库中创建并初始化一个新的 worktree,自动完成分支创建与命名,并把新目录放在源仓库的同级目录中,便于在不影响当前工作区的情况下开展新任务。
主要能力:创建 worktree 前先做前置校验,要求当前目录是 Git 仓库(git rev-parse --is-inside-work-tree),且仓库根路径必须位于 ~/github 之下;若仓库位于其他位置会停止并提示,需人工明确确认。若仓库对应 Dart SDK(如 ~/github/dart-sdk),会停止并询问是否改用专用 Dart SDK 流程。执行时优先使用 upstream 远程(若存在),再动态解析远程默认分支(<remote>/HEAD、main 或 master),并用 git fetch 获取最新状态。命名规则:分支名由用户请求生成,形如 issue-12345 或 fix-auth-crash;worktree 目录名为 _[原仓库目录名]-[分支名],位于源仓库的父目录下。创建命令为 git worktree add -b {branch_name} {sibling_worktree_path} ${TARGET_BASE}。创建后会进入新目录并执行 gh repo set-default origin。最后以 [link text](file:///绝对路径) 形式给出可点击链接。
使用方式:在 ~/github 下的目标仓库中调用该技能并说明任务,例如修复 issue 或添加检查。示例:在 ~/github/flutter 修复 #12345 会创建分支 issue-12345 与 worktree ~/github/_flutter-issue-12345;在 ~/github/kevmoo/kevmoo_skills 添加 lint 检查会创建分支 add-lint-check 与 worktree ~/github/kevmoo/_kevmoo_skills-add-lint-check。创建前会检查目标路径或本地分支是否已存在,必要时运行 git worktree prune 清理陈旧元数据。不要求当前工作区干净。
适用场景与限制:适合位于 ~/github 下的普通 Git 仓库。不适用于非 Git 目录、~/github 之外的位置(需人工确认)、Dart SDK 仓库,以及需要特殊工具链或 gclient 检出的仓库。官方未提供更多安装方式、收费与平台信息。