TERMINAL + MONTHLY ARCHIVE
Grok Build 野戰手冊
18 份 CLI 手冊與 6 篇 API 指南，現在接上 32 期回顧檔案，涵蓋 API contract、agentic tool、realtime media 與 Grok Build operation。
PRIMARY TRACK / GROK BUILD
完整 CLI 課程
依序完成 01–18：終端、repository 規則、安全邊界、平行工作、extensions、bounded output、設定、sessions、worktrees 與 maintenance。
基礎建置
Repository 上下文
受控執行
Session 操作
平行工程
擴充系統
自動化
有界自動化
設定控制
Agent 組合
Repository 隔離
CLI 維護
COMPANION ARCHIVE / API
Companion archive / xAI API
A01–A06 保留給 API application builders，不列入 18 份 Grok Build CLI curriculum。
建立第一條 API 訊號
從空白專案走到可控的第一個請求，同時避免洩漏金鑰或把短生命週期的模型名稱寫死。
MANUAL / A02 · 進階 API設計可長期維護的文字生成迴路
把 response 視為包含狀態、串流、保存政策與復原的生命週期，而不是一段神奇字串。
MANUAL / A03 · 進階 API建立有邊界的工具系統
分清哪些工具在 xAI 基礎設施執行、哪些會把控制權交回你的程式，以及安全閘門應放在哪裡。
MANUAL / A04 · 進階 API安全關閉 function-calling 迴路
定義精準 schema、依 policy dispatch、回傳結果並持續，直到模型能作答或預算用盡。
MANUAL / A05 · 進階 API把模型輸出變成型別邊界
有意識地使用支援的 JSON Schema、在 runtime 再次驗證，並追求語意而不只是語法正確。
MANUAL / A06 · 進階 API選模型，但不要把時間凍結
把即時 catalog 當庫存、把自己的評估當證據、把設定當替換點。
月度訊號檔案 / 32 期
三十二期回顧式工程訊號。
從 API contract、agentic tool，一路到 realtime media 與 Grok Build operation 的官方來源路線。
- SIGNALS
- 32
- RANGE
- 24—26
- LANG
- 03
SIGNAL BANK / SOURCE-CHECKED
12 ISSUES
- 2024 / 01 API
建立單一 xAI API 邊界
把 authentication、request ID、timeout、normalized error 與 model configuration 集中在 server-owned adapter。
- 2024 / 02 TEXT
把 text generation 當成 typed product contract
定義 instruction、user input、expected output、terminal state 與 retention，不要把 raw completion 暴露到整個 app。
- 2024 / 03 PROMPTS
分開 instruction 與 user data
版本化 durable behavior、分隔 untrusted input，並指定 acceptance format，讓 prompt change 可 review。
- 2024 / 04 STREAM
用 state machine 呈現 streaming
把 start、typed delta、tool activity、completion、cancellation 與 failure 建成獨立 state，而非只累加文字。
- 2024 / 05 REASONING
依 workload 配置 reasoning budget
讓 simple extraction、interactive work 與 deep analysis 各有不同 latency、quality 與 cost profile。
- 2024 / 06 TOOLS
替 custom function 設定窄 schema
讓 model 只提出 call request，由已驗證 application code 驗證 argument、執行並回傳 typed result。
- 2024 / 07 TOOLS
只平行執行獨立 tool call
Tool scheduler 應辨識 dependency、ownership、idempotency、timeout，以及多個 result 如何回到 model loop。
- 2024 / 08 DATA
讓 schema 成為 machine contract
Structured output 能移除一類 parsing 歧義，但 value 是否可接受仍由 domain validation 決定。
- 2024 / 09 VISION
把 image 當成有限證據
保存 original asset、定義 allowed observation，並把 visual extraction 與高影響 decision 分開。
- 2024 / 10 MODELS
依 capability profile 路由
描述 modality、tool support、latency、quality、context 與 budget，再由 configuration 對應 current model。
- 2024 / 11 RELIABILITY
把 rate limit 變成 admission control
依 user 與 workload 做 queue、budget、shed 與 retry，不讓所有 request 在 provider edge 碰撞。
- 2024 / 12 CHANGE
維護 release 與 deprecation ledger
替每個 volatile dependency 記錄 source date、active assumption、pinned identifier、migration owner、test 與 rollback。
SIGNAL BANK / SOURCE-CHECKED
12 ISSUES
- 2025 / 01 PERFORMANCE
替 prompt caching 設計 stable prefix
讓 durable instruction 與 reusable context 保持穩定，volatile user data 放在 request 後段。
- 2025 / 02 ASYNC
把 deferred work 表示成 job
保存 request identifier、explicit status、expiry、cancellation、idempotent retrieval 與可見 terminal result。
- 2025 / 03 BATCH
對帳每個 batch item
使用 immutable input manifest、stable custom ID、per-item status、bounded replay 與明確 partial-result policy。
- 2025 / 04 FILES
替 uploaded file 建立 lifecycle
追蹤 owner、purpose、content type、processing state、retention、expiry、derived index 與 deletion。
- 2025 / 05 RAG
Retrieval 前先治理 collection
Document ownership、metadata、access filter、processing status、freshness、citation 與 deletion 都是 retrieval product 的一部分。
- 2025 / 06 SEARCH
把 web search 當成即時引用證據
保存 source URL、區分 retrieval time 與 event time，並把 citation 放在支持的 claim 附近。
- 2025 / 07 SEARCH
把 social search 當成 volatile signal
分開 post、user、thread、timestamp、engagement 與 model synthesis，避免介面隱藏來源 context。
- 2025 / 08 COMPUTE
把 code execution 當成 disposable compute
送入 bounded input、要求 named artifact，並在 execution environment 外驗證 calculation。
- 2025 / 09 EVIDENCE
分開保存 all citation 與 inline citation
保留完整 source ledger 供 audit，同時在 reader 需要的位置 render claim-level link。
- 2025 / 10 IMAGINE
讓 generated image 通過 asset pipeline
分開 prompt intent、generation、moderation state、storage、metadata、transformation 與 human acceptance。
- 2025 / 11 IMAGINE
把 video generation 當成 async media job
以 durable job metadata 建立 queued、generating、moderated、uploaded、accepted、failed、expired 與 cancelled state。
- 2025 / 12 AGENTIC
用單一 controller 混合 server/client tool
Controller 區分自動執行的 server tool，以及需暫停等待已驗證 application work 的 client function。
SIGNAL BANK / SOURCE-CHECKED
08 ISSUES
- 2026 / 01 RESPONSES
以 Responses 處理 stateful agentic work
Typed output item 與 native server tool 讓 message、reasoning、search、code 與 function call 在單一 request contract 中可觀察。
- 2026 / 02 VOICE
把 voice 設計成 live session
Transport、ephemeral access、turn detection、interruption、tool、reconnect 與 playback state 共同定義體驗。
- 2026 / 03 GROK BUILD
在已知 repository 內啟動 Grok Build
編輯前確認 installation、authentication、working directory、repository state、task 與 verification。
- 2026 / 04 GROK BUILD
信任 configuration 前先 inspect
Environment、user、project、managed 與 requirements scope 都可能提供 setting；current directory 的 effective state 必須可見。
- 2026 / 05 GROK BUILD
分開 permission 與 sandbox enforcement
Permission 決定 call 能否執行；sandbox 在 call 獲准後限制 filesystem/network impact。
- 2026 / 06 GROK BUILD
用窄 trust contract 連接 MCP server
記錄 server identity、transport、authentication、tool namespace、enabled tool、approval 與 diagnostic behavior。
- 2026 / 07 GROK BUILD
用 Skills 封裝方法，用 subagent 隔離工作
Skill 帶 reusable instruction/resource；plugin 封裝 extension；hook 觀察 lifecycle；subagent 擁有獨立 task。
- 2026 / 08 GROK BUILD
用 session 與 isolated worktree 操作 headless work
Headless run 需要 fixed task、bounded permission mode、machine-readable output、session identity、isolated write 與 cleanup ownership。