Grok WorldGrok Build CLI field station

當期期號 / GROK BUILD

把 worktree 儲存當成必須自行回收的 state

Worktree session 是位於 ~/.grok/worktrees 的真實 git checkout,從目前 HEAD 建立,存活時間長於建立它的 session,只有在你主動移除時才會被回收。

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

三步野戰程序

  1. 01

    鎖定合約

    寫下 caller、資料分類、成功條件、timeout、取消與 ownership。當 parallel agent、長時間 review 或排程執行在共用或容量受限的磁碟上累積 isolated checkout 時採用。

  2. 02

    執行有界路徑

    只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。Worktree session 是位於 ~/.grok/worktrees 的真實 git checkout,從目前 HEAD 建立,存活時間長於建立它的 session,只有在你主動移除時才會被回收。

  3. 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'