選擇 one-shot surface
已發布 CLI 使用 -p 或 --single 執行 prompt、輸出結果後離開。輸入可來自文字、--prompt-file 或 --prompt-json content blocks;每個 job 應固定一種 contract。
用 --max-turns 限制 agent work;machine consumer 則明確設定 --output-format。共享 release manifest 確認 text、json 與 stream-json。
grok -p "Summarize the staged changes" --output-format json --max-turns 4 保留執行邊界
在正確 repository 執行,並說清是否允許修改。Job 開始前設定 approval、sandbox、tools 與 subagents;non-interactive 並不會讓寬權限變安全。
把 provider/deployment credentials 隔離於 repository-controlled code;不能只靠 prompt 說「不要使用」。
- 記錄 Grok Build release。
- 在 model turn cap 之外另設 timeout。
- Non-zero、malformed output、缺少 evidence 都 fail。
驗證結果,不驗證語氣
依真正 contract 解析 format:json 是單一結果;stream-json 是 event stream,必須增量處理。
Merge/publish 前讀 diff 並跑 repository tests;well-formed response 仍可能描述失敗或不完整變更。