cc-harness-patterns

npx skills add majiayu000/claude-skill-registry --skill cc-harness-patterns --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Harness Engineering 設計模式 `Harness = Tools + Knowledge + Observation + Action Interfaces + Permissions` 基於 Claude Code v2.1.88（92,500 行 TypeScript）逆向分析。 ## 1. Agent Loop：Async Generator 模式 Claude Code 的 agent loop 用 async generator 實作： ```typescript async function* queryModel(...): AsyncGenerator<StreamEvent | AssistantMessage> { // yield 每個 stream event，呼叫端按需消費 } ``` **核心循環**：`queryModel()` → 檢查 `stop_reason` → `tool_use` 時呼叫 `runTools()` → 結果回注 messages → 再次 `queryModel()` **stop_reason 分支**：`end_turn`（結束）、`tool_use`（執行工具）、`max_tokens`（context 滿了，觸發 compaction） ## 2. Tool Orchestration：讀寫分離 ```typescript function isConcurrencySafe(input): boolean { // 工具自己聲明是否可並行 } ``` - `partitionToolCalls()` 把一批工具呼叫分成可並行組和必須串行組 - **讀工具自動合批並行**（FileRead、Grep、Glob） - **寫工具強制串行**（FileEdit、FileWrite、Bash） - 決策權在工具端（Single Responsibility），不在 orchestrator ## 3. 工具執行 7 層管道 ``` Schema Validation → Custom validateInput() → Input Sanitization → PreToolUse Hooks → Permission Resolution → Execution → PostToolUse Hooks ``` 每層只問一個問題：「能否拒絕？」拒絕即停，不往下走。執行邏輯永遠在最後一層。 ## 4. Cache 穩定性模式 **Sticky Latch**：影響 cache key 的欄位一旦啟用就不在 session 內關閉。 ```typescript if (!fastModeHeaderLatched && isFastMode) { fastModeHeaderLat