用途:在顺序或并行阶段任务实现完成后,统一完成 git-spice 分支的创建与校验,避免静默失败导致工作丢失。参数包括 RUN_ID(6 位运行 ID)、TASK_ID(阶段任务,如 1-1)、TASK_NAME(短名称)、COMMIT_MESSAGE(完整提交信息)以及 MODE(sequential 或 parallel)。
主要能力与用法:第一步暂存并创建分支,执行 git add . 后执行 gs branch create {RUN_ID}-task-{TASK_ID}-{TASK_NAME} -m "{COMMIT_MESSAGE}"。第二步按 MODE 校验:sequential 模式验证 HEAD 指向预期分支,使用 git rev-parse --abbrev-ref HEAD 并与预期名比较,不一致则报错退出;parallel 模式执行 git switch --detach 分离 HEAD,并校验结果为 HEAD,以便父仓库中的清理流程能访问到该分支。
错误处理:git add 无变更通常说明任务未实现或未完成,应检查文件是否被修改,不要继续建分支;权限问题需检查 .git 属主与 worktree 可访问性并上报编排器;gs branch create 失败可能为分支重名、git-spice 状态异常或分支名非法,可分别用 git branch 过滤、gs repo sync、gs ls 排查,分支名非法时不要自行清洗而应上报;HEAD 校验失败在两种模式下都不应继续,需带上 HEAD 实际状态或 git 版本上报编排器。
限制:资料未提供安装方式、收费、平台支持与性能数据;该技能依赖 git 与 git-spice 环境,并作为子技能被上游任务调用。