SuperAPI AI 工具集

issue-worktree-agent

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:issue-worktree-agent 是一个通过 git worktree 管理隔离工作区环境的技能,确保针对特定 issue 的智能体工作在 .worktrees/issue-NNN 下的独立分支中进行,不污染或干扰主工作目录。仅用于设置、列出、移除用于 issue 执行分支的隔离 git worktree;不适用于管理本地临时任务(应使用 task-agent),也不适用于管理 GitHub PR 生命周期(应使用 issue-pr-lifecycle-agent)。

主要能力:路径隔离,所有创建的工作树严格限定在 .worktrees/issue-NNN 内;分支管理,自动基于指定基底分支(默认 main)创建名为 issue-NNN(或自定义名称)的特性分支;安全清理,移除工作树需显式调用,支持 --force 标志清理未提交更改。

使用方式:通过辅助脚本 plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py 操作。创建:python3 plugins/dev-utils/skills/issue-worktree-agent/scripts/issue_worktree_manage.py create --issue 123 --base main;列出:python3 .../issue_worktree_manage.py list;移除:python3 .../issue_worktree_manage.py remove --issue 123。也提供 Python API:create_worktree、list_worktrees、remove_worktree。

限制:移除需显式调用;强制清理会丢弃未提交更改。其他细节暂未提供。