项目性质
该项目是对 AI Agent Harness（智能体运行框架）设计的系统性架构分析，以 Claude Code 作为参考实现。资料称其为约 420,000 字的架构分析，提供构建智能体系统的生产级模式，覆盖对话循环、工具执行、权限管理、上下文压缩、记忆系统与多智能体编排。
主要能力（据资料列出的关键能力）
- 智能体对话循环架构（异步生成器模式）
- 工具系统设计，含 50+ 工具实现
- 四阶段权限管线
- 上下文管理与压缩策略
- 记忆系统与 fork 机制
- MCP（Model Context Protocol）集成
- 子智能体编排模式
- 流式架构与性能优化
核心架构模式
1. 对话循环（智能体心跳）
对话循环是一个驱动智能体执行的异步生成器。资料给出的模式包含：调用 LLM 生成响应、产出流式事件、处理工具调用并回环继续、检查终止条件。定义了五种 yield 事件类型（text_delta、tool_call、tool_result、thinking、done）与十种终止原因（max_turns、user_interrupt、explicit_stop、error、context_overflow、permission_denied、natural_completion、timeout、sub_agent_complete、plan_complete）。
2. 工具系统（智能体的手）
工具遵循五要素协议，工具定义接口包含 name、description、inputSchema（Zod）、execute、metadata。metadata 含 readOnly、destructive、concurrencySafe、requiresConfirmation、category。资料提供 buildTool 构建器，流程包括输入校验、权限检查、带超时执行、错误处理；示例工具为 read_file。
3. 权限管线（智能体的护栏）
四阶段权限管理：静态规则匹配、推测式分类（含 2 秒 Promise.race 与 LLM 分类器）、用户审批、审计日志。权限模式包括 autonomous、interactive、strict、read_only、sandbox。
4. 上下文管理（工作记忆）
采用带熔断的渐进式压缩。定义有效窗口公式，含 total、reserved（system、tools、recent）、available。四级渐进压缩：snip（0.7）、micro_compact（0.8）、collapse（0.9）、auto_compact（0.95）；超出预算仍无法压缩时抛出 ContextOverflowError。
5. 记忆系统（长期记忆）
四类闭式记忆：facts（不可变事实）、preferences（用户设置）、context（会话状态）、learned（累积知识）。资料强调「只保存无法推导的内容」的保存原则，并给出 fork 父记忆的能力，包含事实引用共享、可变状态克隆、学习知识全新初始化，以及通过 MEMORY.md 更新索引。
6. 子智能体 Fork 模式
递归生成智能体并支持继承。SubAgentConfig 支持 custom/builtin 类型，builtin 含 coordinator、specialist、reviewer、planner；可配置 inheritContext、inheritMemory、inheritTools。资料描述 coordinator-worker 模式，并含通过 forkDepth 与 maxForkDepth 防止递归 fork。
7. MCP 集成
模型上下文协议桥接外部工具。资料列出八种传输协议（stdio、http、websocket、grpc、ipc、sse、stdio+stderr、custom）与五态连接生命周期（disconnected、connecting、connected、error、reconnecting）。MCP 工具以三段式命名注册：mcp.{server}.{tool}，并含重连逻辑。
8. 技能系统
基于 frontmatter 元数据的插件架构。Skill 含 metadata、content、tools、hooks；元数据含 name、description、triggers、version、dependencies。资料描述三级参数替换：环境变量、配置值、运行时值。
配置
资料提及智能体配置遵循六层优先级链，从高到低包括：运行时覆盖、环境变量（AGENT_*）、项目配置（.agentrc.json）、用户配置（~/.config/agent 等），其余层级在资料截断处未完整提供。
安装与使用方式
资料给出的安装命令为：
git clone https://github.com/lintsinghua/claude-code-book.git
cd claude-code-book
并建议在线阅读（便于查看交互式图表）：访问 https://lintsinghua.github.io
适用场景与限制
适用于需要理解或自行实现 AI 智能体运行时（会话循环、工具协议、权限、上下文与记忆管理、多智能体编排、MCP 集成）的工程参考。限制方面：资料未提供许可协议、版本号、维护状态、兼容的 Claude Code 版本、运行环境依赖与具体性能指标等信息，暂未提供。