用途:当用户要求新建本地 git 分支并开始处理某个 issue(如“create branch”或“start working on issue XYZ”)时使用该技能。
主要能力:确认 issue 目标;依据 issue 标签推断分支类型(feature、bugfix、chore、docs、refactor、test、release);从 issue 元数据或用户输入获取 scope;由 issue 标题生成小写、去停用词与标点的简短描述,最终拼成 type/scope-short-description,例如 bugfix/api-auth-token-refresh。
使用方式:先确保仓库有 origin remote 与 origin/main,且工作区干净;执行 git fetch origin main,切换到 main(不存在时执行 git switch -c main --track origin/main),再 git pull --ff-only origin main,随后 git switch -c "<branch-name>" 创建分支。可用 gh issue view <issue> --json number,title,labels 补全元数据;开始编码前用 gh issue edit 添加 agent/in-progress 标签、移除冲突标签并发表评论说明分支名,最后用 git status -sb 报告。
限制:仅创建本地分支,未明确要求不推送;必须从与 origin/main 一致的最新本地 main 分支;缺少 main 或 origin/main 时停止并询问基线分支;工作区脏时不 stash、reset 或 rebase,而是停下询问;未标记进行中前不开始实现,除非用户明确表示不改动 GitHub;路径须使用会话列出的绝对路径,如 ~/.codex/skills/branch/SKILL.md。该技能的收费、价格与效果暂未提供。