Harness Engineering(代理治理工程)

设计围绕 AI Agent 的系统、约束和反馈回路的技术学科。已取代 Prompt Engineering 成为 AI 落地的关键护城河。模型是'马',Harness 是'缰绳、马鞍与衔铁'。

生产方式:人写签发:晓黎学习复核:2026年7月7日被 6 个词条引用

一句话定义

Harness Engineering = 不是"让 AI 做什么",而是"设计 AI 运行的整个环境"——约束系统、反馈循环、验证网关和操作基础设施。

为什么 Prompt Engineering 不够了

Prompt Engineering → 只控制输入
Context Engineering → 控制模型看到什么
Harness Engineering  → 控制整个运行时环境

三层架构演进

层级时代核心问题代表技术
Prompt2023-2024我该怎么问?Few-shot, Chain-of-Thought
Context2025模型应该看到哪些 Token?RAG, MEMORY.md, System Prompt
Harness2026如何设计整个运行环境?权限控制、编排恢复、审计追踪

生产级 Harness 六大组件

组件功能示例
运行时访问控制 (RAC)动态任务范围内数据治理Claude Code 四级权限
工具与技能治理管理可调用的技能目录及生命周期MCP Skills
编排与恢复 (O&R)Checkpoint + 故障优雅降级LangGraph 循环状态图
上下文与存储管理三层自愈记忆架构MEMORY.md + 主题文件 + 原始轨迹
成本与延迟控制缓存策略 + 模型路由小模型分类/大模型推理
审计与合规追踪完整推理链和工具调用轨迹结构化日志

关键实践

会话分叉 (Session Forking)

主干 Session(只做编排,加载 CLAUDE.md)
    │
    ├── 分支 Session A(具体模块,阅后即焚)
    ├── 分支 Session B(具体模块,阅后即焚)
    └── 分支 Session C(具体模块,阅后即焚)
            │
    测试通过 → 代码合入 → 销毁子会话 → 主干更新 Task List

双轨分离回滚

  • Restore Code Only:回滚代码但保留对话记忆
  • Restore Conversation Only:保留代码切掉臃肿上下文

结项审计 (End-of-Session Distillation)

每次会话结束前,AI 梳理:表结构变更、新环境变量、遗留坑点 → 写入 CLAUDE.md → 销毁会话

相关笔记

  • Harness Engineering 原始文献与融合映射 — 原始文章清单、版本关系与逐篇逐观点在课程中的融合位置

  • Agent Harness 课程 — 二十讲系统课程,覆盖 Agent Loop、上下文、工具、路由、任务分发、多专家、通信、治理、恢复、可观测与评估

  • DeepSeek Harness 案例 — 一切皆插件的运行时装配

  • 创业OS Harness 案例 — 业务系统中的权限、路由与治理

  • Harness Engineering — 我的 Harness 工程资料库

  • Context Engineering(上下文工程) — Harness 的核心子集

  • AI安全与治理(AI Safety & Governance) — Harness 中的安全组件

  • Agent Orchestration(Agent调度带宽) — Harness 中的编排组件

  • Session与Memory的调和 — Session/Memory 调和

来源

  • Claude-Code源码泄露-Harness工程范式革命 — Claude Code 源码泄露事件分析
  • Session与Memory的调和 — Session 与 Memory 调和方案

互链

链接来自概念卡正文里的双链,编译时能解到本期词条集的才成为站内链接。

反链(6)

出处

路径是本地知识库(Obsidian 库)里的位置,正文与概念卡逐字对应。

  • 概念卡原文Harness Engineering(代理治理工程)03_RESOURCES/概念/harness-engineering.md
  • 所属知识地图栏目概念页索引 · Agent 架构与 Harness 治理03_RESOURCES/概念/Index.md
  • 正文引用的知识库笔记Harness Engineering 原始文献与融合映射02_AREAS/AI开发/Harness Engineering/原始文献索引与融合映射.md
  • 正文引用的知识库笔记Agent Harness 课程02_AREAS/AI开发/Harness Engineering/Agent Harness 课程/README.md
  • 正文引用的知识库笔记DeepSeek Harness 案例02_AREAS/AI开发/Harness Engineering/Agent Harness 课程/案例库/01-DeepSeek Harness 案例.md
  • 正文引用的知识库笔记创业OS Harness 案例02_AREAS/AI开发/Harness Engineering/Agent Harness 课程/案例库/02-创业OS Harness 总览.md
  • 正文引用的知识库笔记Harness Engineering02_AREAS/AI开发/Harness Engineering/README.md
  • 正文引用的知识库笔记Session与Memory的调和03_RESOURCES/摘录/session-memory-harmony.md
  • 正文引用的知识库笔记Claude-Code源码泄露-Harness工程范式革命03_RESOURCES/摘录/claude-code-harness-leak-2026.md

编译入库:2026年10月6日。词条由知识库编译而来, 修正要回到概念卡改,再重新编译。