依 live model catalog 規劃 Grok Build 工作

從有日期、依帳號而變的 catalog 開始

2026-08-10 擷取的 Grok Build 1.0.0 authenticated grok.com runtime，執行 grok models 只回傳 grok-4.5，並標示為 default。該次 model metadata 支援 low、medium、high reasoning effort，default high。

這是 release/account snapshot，不代表所有帳號或未來版本。Automation 或 evaluation 前先記錄 grok --version，再立即執行 grok models。若 live 結果不同，以實際帳號 catalog 為準；不可發明記憶中的 model ID 或 effort。

grok --version
grok models

Continuity first 再路由

目前 Grok session/repository 已保存 decisions、tool results、uncommitted state 時，優先留在原處。只有另一個 CLI 有具體 native workflow、使用者明確要求 independent review，或當前 session 無法滿足 boundary，才切換 CLI 或建立新 session。

在本次 captured catalog，mechanical inventory/formatting 用 low；刻意覆寫 default 的 bounded ordinary work 可用 medium；ambiguous architecture、hard debugging、security-sensitive review 或維持 model default 則用 high。增加 effort 是讓同一 model 投入更多 reasoning，不會建立 subagents。

• Continuity first: 切換前計入 context-transfer 與 verification cost。
• Effort != delegation: --agents/subagents 分開設定；必須 single-agent 時使用 --no-subagents。
• Permission invariant: 選 model/effort 永遠不會升級 sandbox、tools、approval 或 credentials。

One-shot 不擴大 authority

已發布的 -p/--single 是 single-turn prompt：輸出 response 後離開；它不是 model preset、permission flag 或 delegation mode。

Read-only analysis 同時指定 read-only sandbox 與 plan permission mode；已授權 implementation 則保留 workspace sandbox 與正常 default permission decisions。選 high effort 絕不構成 --always-approve 或 bypass 的理由。

grok --model grok-4.5 --reasoning-effort low --sandbox read-only --permission-mode plan -p "Inspect the repository and report evidence only."

grok --model grok-4.5 --reasoning-effort high --sandbox workspace --permission-mode default -p "Implement the scoped change, run affected tests, and report the diff."

先向 Knowledge MCP 取得 catalog evidence

連接 AI Worlds Knowledge MCP 後，要求 plan 前先用 worlds_list_cli_models 查 grok-build。讀取 capture date、supported efforts、availability warning、selectors 與 sources，再和實際帳號的 grok models 比對。

呼叫 worlds_plan_cli_work 時傳入 active CLI 與真正 available 的 CLIs。Workstream 預設 read-only；只有已授權的 implementation 才使用 execution_intent may-edit。輸出只是 advisory；檢查 assignments、dependencies、model fallback、permission boundary、verification gate。工具不會啟動 Grok、授權 permission 或證明 live entitlement。

worlds_list_cli_models
{"products":["grok-build"]}

worlds_plan_cli_work
{"task":"Inventory the repository, implement the bounded fix, and verify it","current_cli":"grok-build","available_clis":["grok-build"],"workstreams":[{"id":"implementation","goal":"Implement the bounded fix and run affected tests","execution_intent":"may-edit"}],"strategy":"continuity-first","risk_tolerance":"low","execution_environment":"local-workspace","require_independent_review":false}

Catalog/capability drift 時 fail closed

Explicit selector 不在 live catalog 時，launch 前停止；只能改用 grok models 實際回傳的 ID，或省略 --model 保留 live default。無法確認 effort support 時，省略 override，不要猜。

任何 write 後重跑 repository tests 並檢查 diff。Model response 成功不代表 task 通過；更換 model 也不能重寫 project policy 或暴露 credentials。

• Malformed/empty model output 是 uncertainty，不是使用 stale ID 的許可。
• Plan 中分開記錄 model、effort、delegation、permission evidence。
• CLI update、account change、policy change 後重新查 catalog。

Durable configuration 維持最窄 scope

Settings reference 的 models.default 與 models.default_reasoning_effort 作用於 new sessions；--model、--reasoning-effort/--effort 控制 current launch，/model、/effort 則是 TUI controls。團隊驗證 shared default 前，先使用 one-run choice。

Custom model 可用 model.<id>.env_key 指向環境變數名稱，優先於 api_key 或 extra_headers 中的 literal credential；同時限制可讀取它的 logs、debug files、environment 與 child processes。