SuperAPI AI 工具集

close-github-worktree-done

通用与其它

查看项目

更新于 10-16 08:35

技能介绍

用途:在用户显式 @ 本技能或明确下达「关闭 worktree 并完成需求」类指令时,关闭指定分支关联的 GitHub Issue(可选并确认),并移除本地 git worktree 目录与本地分支。固定针对仓库 owner = TencentBlueKing、repo = bk-ci,远端为 origin,GitHub MCP server 为 user-github。

主要能力与流程:先确定目标分支,已指定则直接使用,未指定则用 git worktree list 列出附属 worktree(排除主工作树)并经 AskQuestion 让用户选择。随后从分支名解析 Issue 号,分支名约定为 {type}-{keywords}-{issue号} 或 {type}-{issue号},最后一段须为纯数字;无法解析时询问是否仅移除 worktree 并跳过 GitHub 操作。接着解析目标 worktree 路径,确认其不是主工作树,并检查未提交变更;有变更需用户明确同意才可 git worktree remove --force。合并状态检查需在 master 上执行 git fetch origin master、git merge origin/master 与 git branch --merged master,未包含目标分支时须确认是否继续删除。GitHub Issue 部分先通过 user-github 的 issue_read(method: get)读取状态,已关闭则跳过,仍为 open 时经用户确认后调用 issue_write(method: update,state: closed,state_reason: completed)关闭。移除 worktree 后在主仓库根目录执行 git worktree remove [--force] "<TARGET_ROOT>",或使用脚本:Windows 为 powershell -File .cursor/skills/github-worktree/scripts/git-worktree.ps1 -Action Remove -Branch "<目标分支名>",macOS/Linux 为 bash .cursor/skills/github-worktree/scripts/git-worktree.sh remove -b "<目标分支名>";最后用 git branch -d "<目标分支名>" 删除本地分支,未完全合并时需用户明确同意才可用 -D。

限制:必须在 master 分支上执行,否则中止;主工作树不得由此技能关闭;不删除远程分支,不执行 git push --delete 等操作;MCP 或移除任一步失败须如实反馈,已执行步骤不自动回滚。移除后若编辑器仍打开该路径将失效,属预期现象。