Coding Harness

定义

Coding Harness（编码框架）是 Agent Harness 的一个特化形态——专门围绕"写代码/改代码"任务设计的软件脚手架。它在 LLM 之上封装仓库上下文、工具定义、权限闸门、上下文压缩和会话记忆，让模型能够在真实代码仓库里循环地观察→分析→选择→执行。

要点

• 六大核心组件（Raschka）：
  1. Live Repo Context — 启动时收集仓库"稳定事实"（分支、README、AGENTS.md）
  2. Prompt Prefix + Cache Reuse — 稳定前缀复用，避免每轮重建完整 prompt
  3. Structured Tools + Validation + Permissions — 命名工具、参数校验、审批闸门
  4. Context Reduction / Output Management — 剪裁、去重、摘要
  5. Transcripts + Memory + Resumption — 完整流水 + 工作记忆两层
  6. Bounded Subagent Delegation — 受限子代理并行处理侧任务
• 代理 vs 框架：严格讲 agent 是模型驱动的决策循环，harness 是围绕它的代码脚手架；日常可互换
• Harness 是体验差异的关键：同样的基座模型放进不同 harness，用户感受差异巨大（Claude Code / Codex / 普通 Chat UI）
• Harness-specific 后训练：OpenAI 为 Codex 单独训练过 GPT-5.3-Codex 变体，说明模型可以针对特定 harness 微调

示例

• Claude Code、Codex CLI 是典型的 Coding Harness
• Mini Coding Agent（Raschka）是一个纯 Python 的 <300 行参考实现，把六个组件在代码注释里对应标注
• OpenClaw〔待补〕 不是 coding harness 而是更通用的本地 Agent 平台，虽然也能写代码

相关概念

• Agent Harness - 父概念
• Prompt Prefix Caching - 组件 2
• 上下文压缩 - 组件 4
• 工作记忆与完整会话 - 组件 5
• 受限子代理 - 组件 6
• Claude Code 架构与工程实践〔待补〕
• AI原生CLI
• AGENTS
• Ralph Loop
• Harness 协同进化

参考资料

• Sebastian Raschka, Components of A Coding Agent (2026-04-04)