SuperAPI AI 工具集

linear-worktree

智能体与模型

查看项目

更新于 10-16 06:46

技能介绍

用途:为 Linear 问题创建独立的 git worktree,从 main 分支拉出,作为当前仓库的同级目录,便于按问题隔离开发。

主要能力:解析三种输入——Linear URL(如 https://linear.app/myteam/issue/ABC-58/add-dark-mode-toggle)、Linear 的 copy as prompt(如 ABC-58 Add dark mode toggle to settings page)、仅问题编号(如 ABC-58)。解析后得到小写的 ISSUE_ID 与 BRANCH(编号加 slug)。先解析 REPO_ROOT、REPO_NAME、REPOS_BASE,再执行 git fetch origin main,最后用 git worktree add 创建目录。

使用方式:在 git 仓库内时,REPO_ROOT 取 git rev-parse --show-toplevel,REPO_NAME 为其 basename,REPOS_BASE 为其父目录;不在仓库内但 config.json 有 repos_base 时使用该值并询问仓库文件夹;两者都没有则询问完整仓库路径。创建命令为:git -C $REPO_ROOT fetch origin main,然后 git -C $REPO_ROOT worktree add -b $BRANCH $REPOS_BASE/$REPO_NAME-$ISSUE_ID main。完成后报告 worktree 路径、分支名和 cd 命令。

适用场景:需要按 Linear 问题快速建立隔离工作目录、避免在主仓库切换分支时使用。

限制与注意:分支已存在但未检出时去掉 -b;分支已在其他 worktree 检出时不要用 --force,应运行 git worktree list 并让用户切到已有 worktree;目标目录已存在时先与用户确认再删除;必须先 fetch 以免基线过旧;worktree 是同级目录而非子目录;用户说“创建分支”时也指创建 worktree,用 git worktree add 而非 git checkout -b;最后务必给出 cd 命令。资料未提供收费、平台支持范围等更多信息。