用途:从 JIRA 工单自动创建 Git 分支和 worktree。用法为 /setup-branch PROJ-123 或 /setup-branch https://mycompany.atlassian.net/browse/PROJ-123。
前置检查:需安装并认证 Atlassian CLI(acli auth status)与 GitHub CLI(gh --version、gh auth status),缺失则停止并提示。用 acli jira workitem view <JIRA-ID> --fields issuetype --json 获取事项类型;获取失败时让开发者手动选择 Bug 或 Story/Task/Other。
分支命名:JIRA ID 转小写,Bug 用 fix/<jira-id>,其他类型用 feat/<jira-id>。随后询问基础分支,默认当前分支,可含 main 或自定义。执行 git fetch origin <base-branch>,不切换或拉取基础分支。
创建:worktree 路径为当前目录上一级加分支名(/ 替换为 -),执行 git worktree add <worktree-path> -b <branch-name> origin/<base-branch>。若本地分支或目录已存在则停止,不强制创建。
后续:在新 worktree 中按 lock 文件安装依赖(bun/pnpm/yarn 用 --frozen-lockfile,package-lock.json 用 npm ci,无 lock 时 npm install 并警告,无 package.json 则跳过);执行 mise trust(未安装则跳过);复制 .env;写入 .agent 文件记录 baseBranch;最后输出结果并提示 cd 与 git push -u origin <branch>。
限制:依赖上述两个 CLI 及网络;安装命令失败不删除 worktree;具体报错需人工处理。