# 策展 · X (Twitter) 🔥🔥
> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)
> 作者：马东锡 NLP (@dongxi_nlp) · 平台：X (Twitter) · 日期：2026-06-13
> 原始來源：https://x.com/dongxi_nlp/status/2065713612384010332
## 中文摘要
# Agent 的工具箱："/"
Harness 系列文章之 4，斜線（slash）讓 coding agent 超出單純的 prompt box。
> 不是所有的 input，都可以成為 prompt。
每個 coding-agent UI 都從一個簡單想法開始：
輸入請求，發給 model，拿回結果。這是 prompt-box 視角下的 Agent。
普通請求很適合這樣處理：
展開畫面重點
畫面標題為「HARNESS 04 · CONTROL PLANE」，主題為「Ordinary Work Requests」。
左側方框列出了三項工作請求：
- fix the failing tests
- explain this module
- add a config option
右側方框標題為「MODEL PATH」，下方文字說明：「These are work requests. They can become a prompt.」
底部橫幅文字說明：「The control-plane problem starts when every input uses this same path.」
畫面重點在於說明當多樣化的工作請求（如修復測試、解釋模組、新增設定）全部匯流至同一個模型處理路徑時，會產生控制平面（Control Plane）上的效能或架構問題。
展開畫面重點
圖片標題為「HARNESS 04 · CONTROL PLANE」以及「The Agent's Toolkit: "/"（斜槓即工具）」。右側說明指出，這些輸入用於在提示詞（prompt）生成前控制執行環境，斜線指令是該架構獲取工具的方式。畫面中央為一個斜線「/」圖示，周圍分為四個功能區塊：
1. **SESSION（綠色標籤）**：包含 `/status`、`/memory`、`/reset`，用於檢查或變更本地會話狀態。
2. **GOAL（藍色標籤）**：包含 `/goal`、`/goal pause`，用於使用者擁有的生命週期及模型可見的上下文。
3. **CAPABILITIES（橘色標籤）**：包含 `/tools`、`/skills`、`/mcp`、`/hooks`，用於展示該架構可提供的功能。
4. **DIAGNOSTICS（紅色標籤）**：包含 `/audit`、`/doctor`，用於在本地檢查確定性的架構不變量。
展開畫面重點
投影片標題為「HARNESS 04 · CONTROL PLANE」以及「The Naive Prompt Box」。
左側區塊列出了處理流程：
- raw user input
- -> append to transcript
- -> build prompt
- -> call model
- -> parse model output
右側區塊標示為「FAILURE MODE」，說明內容為：
「All text becomes model input, including commands that should control the runtime.」
底部橫幅文字為：
「A slash command should not need the model's permission to inspect or steer the harness.」
這張圖說明了在系統設計中，若未將控制指令（如 slash command）與一般使用者輸入分開處理，會導致模型誤將控制指令視為一般對話內容，進而產生安全或邏輯上的失敗模式。
展開畫面重點
圖表標題為「HARNESS 04 · CONTROL PLANE」及「Slash Command Families」。
左側區塊列出了指令分類與對應的斜線指令：
- session: /status /memory /session /reset /help
- tools: /tools
- goal: /goal /goal pause /goal resume /goal clear
- capability: /skills /mcp /hooks
- policy + diagnostics: /permissions /audit /doctor
- future context: /compact
右側區塊標題為「USER TOOLKIT」，說明文字為：「The slash exposes harness controls without turning every action into a prompt.」
底部橫條文字為：「Command families make the runtime inspectable and steerable.」
畫面重點：此圖展示了一套系統指令集架構，旨在透過預定義的斜線指令（Slash Commands）來管理系統狀態、目標設定、工具調用及診斷功能，讓使用者能更有效率地控制運行環境，而無需將所有操作都轉換為自然語言提示詞（prompt）。
展開畫面重點
畫面標題為「HARNESS 04 · CONTROL PLANE」，主題為「The Input Router」。
左側方框列出了處理原始使用者輸入（raw user input）的邏輯流程：
- 若為空（empty?）：忽略（ignore）
- 若為已知斜線指令（known slash command?）：本地處理（handle locally）
- 若為未知斜線指令（unknown slash command?）：回傳指令說明（return command help）
- 若為本地查詢（local query?）：本地回答（answer locally）
- 若為一般請求（normal request?）：準備訊息並呼叫模型（prepare message and call model）
右側方框標題為「ROUTE FIRST」，說明文字為：「The harness decides what kind of input this is before prompt construction.」（在建構提示詞之前，該架構會先判斷輸入的類型。）
底部橫條文字：「User-input parsing and model-output parsing are different boundaries.」（使用者輸入解析與模型輸出解析屬於不同的邊界。）
展開畫面重點
該圖表標題為「HARNESS 04 · INPUT ROUTER」以及「Not Every Input Becomes A Prompt」，並註明「Slash commands and local queries should be resolved before the model sees the turn.」。
流程圖邏輯如下：
1. **Raw User Input**（原始使用者輸入）：進入判斷程序。
2. **Empty?**（是否為空）：若為「yes」則導向 **Ignore Locally**（不進行模型呼叫）；若為「no」則進入下一步。
3. **Slash Command?**（是否為斜線指令）：
- 若為「known」（已知指令）：導向 **Handle Locally**（處理狀態、工具、目標）。
- 若為「unknown slash」（未知指令）：導向 **Command Help**（不詢問模型）。
- 若為「no slash」（無斜線）：導向 **Prepare Model Request**（建立應用程式訊息）。
4. **Local Query?**（是否為本地查詢）：若為「yes」則導向 **Local**（立即回應）；若為「no」則回到 **Prepare Model Request**。
展開畫面重點
投影片標題為「HARNESS 04 · CONTROL PLANE」以及「Goal Control State」。
左側程式碼區塊內容：
session["goal"] = {
"objective": "...",
"status": "active",
"created_at": "...",
"updated_at": "...",
"events": []
}
user controls:
/goal pause /goal resume /goal clear
model tools:
get_goal()
update_goal(status="complete")
右側說明區塊：
標題為「NARROW MUTATION」。
內容為：「The model can see goal context, but the user owns the lifecycle.」
底部橫幅文字：
「Goal state is control-plane state, not fuzzy chat memory.」
畫面重點解讀：該圖表定義了 AI 代理（Agent）系統中「目標」的資料結構與控制機制。它將目標狀態視為明確的控制平面（Control Plane）資料，而非僅是聊天記錄中的模糊上下文，並透過明確的指令（如 pause, resume, clear）與工具函數（get_goal, update_goal）來管理目標的生命週期。
展開畫面重點
這是一張關於「HARNESS 04 · CONTROL PLANE」的技術簡報，標題為「Diagnostics Stay Local」（診斷資訊保持本地）。
畫面左側列出了 `/audit` 與 `/doctor inspect` 指令所涵蓋的檢查項目：
- session history roles（對話歷史角色）
- tool call / result pairing（工具呼叫與結果配對）
- file-state freshness（檔案狀態時效性）
- tool registry metadata（工具註冊表元數據）
- goal state（目標狀態）
- context projection（上下文投影）
- permission state（權限狀態）
- MCP + hook configuration（MCP 與鉤子配置）
畫面右側標註為「REAL INVARIANTS」，內容為：「The first health check should inspect deterministic harness state.」（首次健康檢查應檢查確定性的 harness 狀態。）
底部橫幅文字強調：「If diagnostics become chat, the agent can hallucinate health.」（如果診斷資訊變成對話形式，代理可能會對健康狀態產生幻覺。）
展開畫面重點
畫面標題為「HARNESS 04 · CONTROL PLANE」及「Control Plane Rule」。
左側方框列出了「A coding-agent harness needs:」的七項需求：
1. typed input router
2. known local command handlers
3. unknown command help
4. session-state commands
5. diagnostic commands
6. narrow model mutation rules
7. tests proving local commands do not call the model
右側方框標題為「PRODUCT BOUNDARY」，內容為：
「The prompt box asks for work. The slash controls the worker.」
底部橫條文字為：
「The agent's toolkit starts with /.」
畫面重點在於定義編碼代理的控制平面架構，強調透過斜線（/）指令來區分工作請求與系統控制，並要求本地指令處理器需具備獨立性，不應呼叫模型。