Repository navigation
Description
提交前确认 · Pre-submission checklist
- 我已搜索过现有 issue,确认这不是重复提议 / I searched existing issues and confirmed this isn't a duplicate.
- 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · Category
工具调用 / MCP · Tool use / MCP
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
使用场景 · Use case
我已经看过issue 132,我们说的不是第一个东西
类别 · Category
功能需求 / Feature request · 平台能力(Platform capability)
是否已有相关 issue
相关但不重复:#132。#132 聚焦于给现有 using-git-worktrees skill 补 UX(worktree
切换器 + 减少权限弹窗),其原文也指出 "No native worktree tool available in ZCode
platform"。本 issue 的诉求更根本:希望 worktree 成为平台一等公民,而不仅是 skill,
并提供原生命令与"并行工作模式"。
背景与动机 · Motivation
当前要在 ZCode 里并行跑多个 agent(不同特性、实验性改动、长任务),它们会共享同一个
工作目录与 git 索引,极易互相覆盖文件、争抢同一分支。git worktree 是解决这类并行隔离
的事实标准,但目前在 ZCode 中:
- 没有原生命令,只能依赖 skill 用
gitfallback 拼出来; - 该 fallback 会触发 4+ 次连续权限弹窗(见 [Feature] Improve git worktree UX in ZCode Desktop — add worktree switcher and reduce permission prompts #132);
- 每个 worktree 也没有与 agent 上下文 / 后台任务的一等绑定,隔离体验割裂。
结果:用户要么放弃并行,要么手动在终端建 worktree 再 File → Open Folder 打开,发现性
和可用性都很差,无法体现 ZCode 作为 ADE(Agentic Development Environment)在多 agent
编排上的优势。
建议方案 · Proposal
期望 · Proposed Behavior
提供原生 /worktree 命令族(不依赖 skill 的 git fallback),并把 worktree 作为
"并行工作模式"的基础单元,且提供给LLM对它的调用能力(参考ClaudeCode的WorkTree相关功能):
/worktree create [<name>] [-b <branch>]:创建隔离工作树(单次授权完成"建树 + 切分支- 项目初始化"),消除多段权限弹窗。
/worktree list:列出当前仓库的所有 worktree 及其绑定状态(分支、关联 agent / 任务)。/worktree switch <name>:在 app 内一等切换(非Open Folder)。/worktree remove <name>:清理工作树与分支(带保护:有未提交改动时阻断或提示)。/worktree run <name> ...(进阶):在指定 worktree 中启动一个独立 agent / 后台任务,
实现"一个 worktree 绑一个 agent 上下文"的并行隔离。
配套的"并行工作模式"开关:进入后,新开的 agent 默认落到独立 worktree,互不干扰,状态/
日志在统一的 worktree 面板里聚合查看。
与现有能力的衔接
- 与 subagent / 后台任务 / 任务调度 协同:每个 worktree 作为独立执行环境,绑定独立
agent 上下文与权限作用域。 - 与 [Feature] Improve git worktree UX in ZCode Desktop — add worktree switcher and reduce permission prompts #132 互补:[Feature] Improve git worktree UX in ZCode Desktop — add worktree switcher and reduce permission prompts #132 的 worktree 切换器与批量授权可作为该原生能力的 UI 呈现层;
本 issue 提供底层的原生命令与并行模式。
参考 · References
- [Feature] Improve git worktree UX in ZCode Desktop — add worktree switcher and reduce permission prompts #132(worktree skill UX,相关项)
- devflowinc/uzi:CLI 用 git worktree + tmux 并行跑多个 coding agent
- Claude Code / Codex 社区中 worktree 并行隔离的成熟用法
环境 · Environment
- ZCode Desktop,Windows
- 模型:builtin:bigmodel-coding-plan/GLM-5.2
预期价值 · Expected value
将明显加快开发速度
一般的使用情况是,在同一个目录里,一个Agent在修改代码的时候,其他Agent往往不能并行修改,如果有了worktree来进行隔离,那么多个功能就可以同时开展,当完成后把它们合并到主分支当中即可。我就可以一次做更多的事情,而不需要我手动创建副本分支目录再去对应目录里启动Agent了
你认为的优先级 · Your perceived priority
高 · High
你使用的 ZCode 版本 / 环境 · ZCode version / environment
Windows/ 8月6日的最新版本,工具未提及具体版本号
补充材料 · Additional context
No response
Activity
github-actions commentedon Aug 6, 2026
👋 感谢你的反馈,我们已经收到。
status: 待评估,你可以随时补充信息。needs: 更多信息标签并 @ 你。👋 Thanks — we've received your issue.
status: 待评估(Triage); feel free to add context.needs: 更多信息and ping you.AI-Chef commentedon Aug 30, 2026
期待
Lparksi commentedon Aug 30, 2026
有相同的需求,希望支持
EtienneLescot commentedon Sep 1, 2026
支持!我按这个思路实现了一个社区插件 git-worktree(PR:zcode-plugins#4),可以作为原生实现落地前的过渡方案,也可以当作实现参考:
/git-worktree:worktree命令:无参数默认"创建隔离 worktree"(自动命名分支、基于默认分支、同级目录、绝不占用 main),另有list/open/remove/prune子命令@提及挂载到自由表述的请求上实际使用中验证了两个痛点:skill 回退到裸 git 命令确实会产生一串权限确认;原生分支切换器会把
branch is already used by worktree误报为"git 操作进行中"。如果维护者计划原生实现,很高兴把插件里的经验(错误信息翻译、路径约定、权限收敛)贡献进去。mengjiu-cao commentedon Sep 9, 2026
怎么没反馈的 意见很好啊
cccfeng commentedon Sep 28, 2026
有相同的需求,希望支持
bigjeager commentedon Oct 4, 2026
有相同需求,支持!现在手工在 主区下面建 .workingtree的subfolder,模型莫名其妙经常会改动主区里的内容,忘记自己在workingtree里干活。
XuChen-AI commentedon Oct 10, 2026
求官方支持,很好的提议
Acfufu commentedon Oct 29, 2026
补充一条 3.16.3 实机静态检查证据(2026-10-29,macOS,桌面 3.16.3 / CLI 3.16.3-40),支持本 issue 诉求——底层已预留了一半,只差实现层:
isolation: "worktree",但运行时直接拒绝:workflow agent 配置里该选项会抛"workflow agent isolation 'worktree' is not implemented yet.";EnterWorktree/ExitWorktree(零实现);git worktree add后打开目录,项目配置/skills/commands 均能正确解析(findWorktreeRoot),桌面可识别 linked worktree 与.claude/worktrees/约定。即「打开已有 worktree」今天就能用,缺的正是本 issue 提议的创建/切换/管理层(
/worktree create/switch+ 单次授权)。希望能提上排期。相关:#132、zcode-plugins#4