渐进式 Agent Harness 工程化

方法定义

围绕语言模型构建 Agent 时，把工具协议、权限、上下文、状态、错误处理与协作结构视作可独立观察的"层"。每层只新增一个主要机制，对比"新增能力 vs. 复杂度"，最终把所有机制合并回同一个可运行循环。这种方法称为"渐进式 Agent Harness 工程化"。

为什么需要这个方法

• 模型本身不等于可用的 Agent 产品；决定稳定性的更多是 Harness 工程层的质量。
• 把 Harness 拆成多层后，便于读者定位失败模式（是上下文溢出、工具权限过宽还是子 Agent 协调错位）。
• 教学和原型阶段可避免一次性设计大而全的 Agent 平台。

渐进层次（来自 learn-claude-code 仓库）

1. 最小 Agent 循环：模型读取任务 → 决定调用工具 → 获得结果 → 继续推理。
2. 工具注册与 Bash 等基础工具接入。
3. 上下文压缩与会话状态恢复。
4. 计划与任务分解。
5. 子 Agent 协作。
6. Skills 按需加载。
7. MCP（Model Context Protocol）外部工具接入。
8. 团队协作协议（教学版 JSONL 邮箱）。
9. Git worktree 隔离用于并行协作。
10. 综合章节：把上述机制合并回同一循环，并对照生产系统缺失的治理能力。

适用情况

• 自建 coding agent、自动化 Agent 或 Agent 平台。
• 教学：希望从底层解释 Claude Code 类工具的工作原理。
• 原型验证：先在一两个机制上跑通，再扩展。

不适用情况

• 需要生产级权限治理、审计、恢复、凭证管理与错误隔离的系统——这些机制在仓库中被刻意省略。
• 希望模仿 Claude Code 界面或交互方式的产品设计——本方法关注内部机制。

与现有 Wiki 方法的关系

• 与 Claude Code 计划模式工作流（Plan Mode） 相关：仓库以"从零实现"角度覆盖计划机制。
• 与 Claude Code Subagents 多 Agent 协作与统一主计划 相关：仓库讲解子 Agent 协作的原理层。
• 与 用 Hooks 在 Claude Code 生命周期事件上挂接自动化脚本 相关：仓库明确省略完整 Hook 总线，仅教学简化版。
• 与 CLAUDE.md 项目级指令文件（Claude Code 项目宪法） 相关：项目级指令在仓库中以 Skills 形式被教学。
• 与 通过 MCP 接入外部工具（Model Context Protocol） 相关：MCP 作为教学章节之一出现。
• 与 memory bank（用文件体系恢复 coding agent 跨会话上下文） 形成对照：后者用文件体系恢复跨会话上下文，本方法用上下文压缩与会话状态机制。

来源边界

• 来源是社区教学仓库，不是 Anthropic 官方资料；不能据此推断 Claude Code 内部源码或官方架构。
• 团队协作的 JSONL 邮箱是教学协议，非生产通信标准。