用途
本技能面向构建生产级 AI Agent 系统的开发者，提供基于 Claude Code 架构分析总结出的 Agent Harness（智能体运行框架）设计知识。它帮助开发者理解并实现 Agent 的核心机制，包括对话循环、工具系统、权限管控、上下文压缩、长期记忆、钩子扩展和多智能体编排等工程主题。
主要能力覆盖
技能的知识范围包括以下方向：
- 核心 Agent Harness 模式：对话循环、工具系统、权限管线
- 上下文与记忆管理：token 预算、压缩策略、长期记忆
- 多智能体编排：fork 模式、协调器模型、子智能体派生
- 集成模式：MCP 协议、hooks 系统、skill/插件架构
- 生产环境关注点：流式处理、性能优化、安全护栏
获取与安装
知识库提供两种访问方式：
- 在线书籍：https://lintsinghua.github.io
- GitHub 仓库：https://github.com/lintsinghua/claude-code-book
离线参考可通过以下命令克隆：
git clone https://github.com/lintsinghua/claude-code-book.git
cd claude-code-book
书籍包含 15 章正文与 4 个附录，配 139 张架构图，主要目录分区包括：
- 第一部分-基础篇/
- 第二部分-核心系统篇/
- 第三部分-高级模式篇/
- 第四部分-工程实践篇/
- 附录/（工具、标志、术语）
内容结构（按架构模块）
1. 对话循环（Agent 心跳）
以 while(true) 异步生成器模式驱动所有 Agent 交互，包含上下文准备、调用带工具的 LLM、按事件类型产出结果、权限检查后执行工具、终止条件判断等步骤。产出五种事件类型：text_delta、tool_use、tool_result、context_compression、done。资料列出十种终止原因：end_turn、max_tokens、stop_sequence、tool_use、content_filter、timeout、user_interrupt、error、rate_limit、context_overflow。
2. 工具系统（Agent 的手）
工具遵循五要素协议：schema（Zod v4 输入校验）、handler（执行逻辑）、metadata（LLM 可见描述）、properties（执行特征：readOnly、destructive、concurrencySafe）、permission（权限级别）。资料给出 buildTool 工厂模式示例，并列出工具类别（12 类、共 50+ 工具），如文件 I/O、Shell、搜索、编辑、浏览器、Git、记忆、Agent、配置、MCP 等。并发执行采用分区贪心算法：只读且并发安全的工具并行执行，有副作用的工具串行执行。
3. 权限管线（四阶段护栏）
四阶段为：classification（推测性 2 秒预批准）、validation（schema 与安全检查）、authorization（需要时征得用户同意）、execution（实际工具调用）。资料列出五种权限模式：safe、normal、relaxed、auto、custom，并给出 safe 模式下的 Bash 安全规则示例（允许命令白名单、拒绝模式如 rm -rf、sudo、管道到 shell、直接磁盘访问，以及命令长度上限）。
4. 上下文管理（Token 预算）
有效窗口计算公式考虑总上限、系统提示、工具定义、预留输出缓冲。四级渐进压缩依次为：裁剪旧图像内容、micro-compact（合并相邻同角色消息）、collapse（摘要工具结果）、auto-compact（LLM 摘要）。另有熔断器模式防止无限压缩。
5. 记忆系统（长期记忆）
记忆类型为封闭集合，仅四类：code_patterns、user_preferences、project_context、task_progress。遵循“只存无法推导之物”原则，资料给出 MEMORY.md 索引结构示例，以及 fork 记忆机制（子智能体按字节级继承消息、选择性复制记忆类型、新任务状态重置）。
6. 钩子系统（生命周期扩展）
覆盖 5 大类共 26 个生命周期事件：lifecycle、tool、content、system、agent。钩子接口包含 event、handler、config（priority、async、timeout）。响应协议支持 allow（before_* 钩子可否决执行）、modify（内容钩子可转换数据）、metadata。资料给出审计钩子示例，并提到三层沙箱：进程隔离、权限限制、超时强制。
7. 子智能体 Fork 模式
Agent 来源有三类：builtin（四种内置：coordinator、worker、researcher、reviewer）、skill（定义在 SKILL.md 中）、fork（从当前 Agent 克隆）。fork 时进行字节级上下文继承，并设有递归深度保护（示例中最大 fork 深度为 3）。
适用场景
- 设计和实现自研 AI Agent 框架或 Harness
- 为现有 Agent 系统补充权限、记忆、压缩、钩子等能力
- 研究 Claude Code 的架构模式并借鉴到自有工程实践
限制
资料仅以在线书籍与 GitHub 仓库形式提供，未提供该技能的收费、价格、平台或具体使用步骤；部分示例代码在资料末尾被截断（“Four built-in ag...”），完整内容需查阅原始仓库。