用途:在写入第一个产物之前,先创建功能分支或 worktree,使文件不落在默认分支上。该技能由 /brainstorm 和 /plan 调用,接收的上下文 $ARGUMENTS 可能是功能描述、头脑风暴主题、计划标题,或为空(由调用方对话上下文提供描述)。
主要能力与流程:
- 检测当前分支:运行 git rev-parse --abbrev-ref HEAD,并与 ${CLAUDE_SKILL_DIR}/scripts/detect-base-branch.sh 检测出的基础分支比较。若当前不在基础分支(且不是 HEAD),说明已在功能分支上,静默跳过并返回调用方,不产生输出。
- 推断分支名:格式为 <type>/<kebab-topic>。type 默认 feat/,上下文明显时可使用 fix/、refactor/ 或 chore/。topic 从描述或对话上下文提取核心主题,转为 kebab-case,截断使完整分支名保持在 60 字符以内,并去掉截断后的尾部连字符。
- 呈现选项:通过 AskUserQuestion 确认分支名与工作区类型,选项包括创建分支(推荐,git checkout -b <name>)、创建 worktree(通过 EnterWorktree 获得隔离工作目录)、跳过(留在当前分支)。自动提供的 Other 选项允许输入自定义分支名,自定义名将原样用于 git checkout -b。选择跳过则不做更改返回调用方。
- 创建工作区:普通分支运行 git checkout -b <branch-name>。worktree 创建前先运行 git status --porcelain 检查未提交更改;若输出非空,用 AskUserQuestion 警告未提交更改会留在原工作树、worktree 从干净检出开始,选项为继续 worktree(推荐)、改用普通分支、取消。继续则调用 EnterWorktree;若失败(例如已在 worktree 中),回退到 git checkout -b 并告知用户。
限制与注意:该技能追求快速、非侵入,跳过时不产生输出;不修改文件,只管理 git 状态。资料未提供其他平台、收费或效果信息。