用途:为 alpha-forge 仓库创建与管理 git worktree,统一分支命名规范并处理生命周期(创建、检测已合并的陈旧 worktree、清理与 prune)。技能描述中给出的触发词为 create worktree、new worktree、alpha-forge worktree。
三种运行模式:新模式(用户给自然语言描述,如“create worktree for sharpe validation”,自动派生 slug 并新建分支与 worktree)、远程跟踪模式(输入含 origin/ 前缀,如“create worktree from origin/feat/existing”,创建本地跟踪分支)、本地分支模式(输入已有本地分支名,如“create worktree for feat/2025-12-15-my-feat”,直接在新 worktree 中使用该分支)。
命名约定:slug 采用 kebab-case,去除 the、a、for 等填充词,限 3–5 个词;分支名为 type/YYYY-MM-DD-slug,type 从 feat、fix、refactor、chore 中选择;worktree 目录为 ~/eon/alpha-forge.worktree-YYYY-MM-DD-slug;iTerm2 标签为 AF-{slug 各词首字母}。
关键命令示例:git worktree add -b "${BRANCH}" "${WORKTREE_PATH}" "origin/${BASE}";跟踪远程时同一形式;使用已有本地分支时 git worktree add "${WORKTREE_PATH}" "${BRANCH}";清理用 git worktree remove <path>、git branch -d <branch>、git worktree prune。
流程要点:先确认主 worktree 在 main 上,否则提示用户选择继续或先切换;执行 git fetch --all --prune;通过交互提问确定分支类型与基分支;创建后自动生成 .envrc 并执行 direnv allow,从 ~/eon/.env.alpha-forge 加载共享密钥;随后生成标签名,需重启 iTerm2 才能看到新标签。
限制与前置条件:技能针对 alpha-forge 仓库与 ~/eon 路径,其他仓库不适用;依赖 direnv(经 mise 安装并配置 shell hook)与共享密钥文件;iTerm2 标签依赖 default-layout.py 动态发现。错误处理覆盖分支已存在、远程分支未找到、路径已存在、fetch 网络错误等情形。集成与安装步骤的更多细节资料未提供。