跳到文章正文
Grok 实用教程

Grok Build怎么隔离修改?worktree基准、未提交内容与清理检查

使用Grok Build工作树隔离文件编辑,核对默认基准与--ref行为;说明detached …

Grok Build怎么隔离修改?worktree基准、未提交内容与清理检查

多个任务都要改代码时,独立工作树可减少文件互相覆盖。Grok Build的基准与清理行为有自己的规则,不能直接套用Claude或Codex。本文从练习仓库开始,只说明隔离与验收,不实际启动多个代理或合并代码。

第一步:保存当前仓库状态

需要Git仓库,先记录HEAD、当前目录和未提交修改。官方说明默认工作树从当前HEAD开始并包括未提交变化,使用–ref则可从指定ref干净检出;这两者会得到不同输入状态,必须主动选择。

工作树隔离文件目录,不自动隔离数据库、远程接口或共享缓存。两个任务即使目录不同,也可能写同一服务;先限定任务范围,不将worktree当作全部安全沙箱。

第二步:创建有辨识度的工作树

官方提供-w与–worktree名称,等号可避免后续提示被误当名字。以下仅展示命令形状,真实执行前确认基准和本机权限,不把main当作所有仓库默认分支。

grok -w
grok --worktree=demo-docs "只检查文档并提出计划,不修改"

# 已确认需要指定干净基准时:
grok -w --ref main "只检查练习项目"

第三步:核对实际目录与基准

Grok工作树保存在其管理目录下,是真实Git checkout,官方说明在基准提交处detached。进入后检查路径、提交和文件状态,不能只看到会话名字就判断正确。

默认带入未提交变化时,任务应区分原有与新产生修改。用–ref时原工作树的未提交文件可能不在新目录,先核对再让模型分析,不将缺少文件误判成项目删除。

进入检查:真实路径;HEAD;是否detached;所选ref;带入的未提交内容;任务允许文件;共享外部资源。任何不一致先停止改动并报告。

第四步:明确交付与合并策略

在隔离目录完成后查看diff、未跟踪文件及实际验证记录。工作树不是自动合并器,落地改动仍依赖正常Git流程;提交前确认处于正确分支或采用合适保留策略,避免detached状态成果难以追踪。

不要同时让两个任务在主目录修改同一文件,再称使用了隔离。会话切换与文件隔离是不同概念,界面中fork或new的可用选项也受配置影响,应以实际状态为准。

第五步:列出与预览清理

官方说明结束或删除会话仍保留工作树,gc也只在手动调用时运行。用grok worktree list查看跟踪项,show检查目标详情,rm配合–dry-run预览。正式删除前核对命令帮助、准确目标和有无运行中任务。

grok worktree list

清理前核对:结果已保存;未提交修改已处理;无进程使用目录;目标身份准确;预览没有包含其他任务;需要保留的提交可追溯。

第六步:不要把会话结束当回滚

工作树目录、Git提交和外部动作各自有生命周期。移除一个工作树不会撤销已发出的网络请求,删除会话也不能证明目录消失。完成标准是隔离范围、基准、交付与清理都明确,而不是终端退出后猜任务已经结束。

官方资料

资料核对日期:2026年11月18日。

本文地址:https://www.163264.com/21722