Harness Engineering(代理治理工程)
设计围绕 AI Agent 的系统、约束和反馈回路的技术学科。已取代 Prompt Engineering 成为 AI 落地的关键护城河。模型是'马',Harness 是'缰绳、马鞍与衔铁'。
生产方式:人写签发:晓黎学习复核:2026年7月7日被 6 个词条引用
一句话定义
Harness Engineering = 不是"让 AI 做什么",而是"设计 AI 运行的整个环境"——约束系统、反馈循环、验证网关和操作基础设施。
为什么 Prompt Engineering 不够了
Prompt Engineering → 只控制输入
Context Engineering → 控制模型看到什么
Harness Engineering → 控制整个运行时环境
三层架构演进
| 层级 | 时代 | 核心问题 | 代表技术 |
|---|---|---|---|
| Prompt | 2023-2024 | 我该怎么问? | Few-shot, Chain-of-Thought |
| Context | 2025 | 模型应该看到哪些 Token? | RAG, MEMORY.md, System Prompt |
| Harness | 2026 | 如何设计整个运行环境? | 权限控制、编排恢复、审计追踪 |
生产级 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 Engineering
02_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日。词条由知识库编译而来, 修正要回到概念卡改,再重新编译。