01 / DECIDE
架構決策
當 parallel agent、長時間 review 或排程執行在共用或容量受限的磁碟上累積 isolated checkout 時採用。
Worktree session 是位於 ~/.grok/worktrees 的真實 git checkout,從目前 HEAD 建立,存活時間長於建立它的 session,只有在你主動移除時才會被回收。 先把 input、output、state、tool 與 side effect 畫成一條可觀察路徑,再決定 把 worktree 儲存當成必須自行回收的 state 的 owner。
02 / OPERATE
三步野戰程序
- 01
鎖定合約
寫下 caller、資料分類、成功條件、timeout、取消與 ownership。當 parallel agent、長時間 review 或排程執行在共用或容量受限的磁碟上累積 isolated checkout 時採用。
- 02
執行有界路徑
只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。Worktree session 是位於 ~/.grok/worktrees 的真實 git checkout,從目前 HEAD 建立,存活時間長於建立它的 session,只有在你主動移除時才會被回收。
- 03
驗證訊號
把驗收變成可重跑的 fixture、contract test 或 browser test。記錄已安裝版本與其 release notes、該版本實際提供的 worktree 指令 help 輸出、dry-run 預覽,以及移除後回收的路徑。
03 / BOUND
Operation 邊界
結束或刪除 session 不會移除其 worktree,回收只在你呼叫時執行;未經預覽的移除可能丟棄尚未用 git 落地的變更。
04 / PROVE
驗收證據
記錄已安裝版本與其 release notes、該版本實際提供的 worktree 指令 help 輸出、dry-run 預覽,以及移除後回收的路徑。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://docs.x.ai/build/features/worktrees' | sed -n '1,5p'