用途
该技能基于约 42 万字的著作《解码 Agent Harness》(御舆:解码 Agent Harness)提炼 Claude Code 的内部架构分析,目标是帮助使用者设计、构建与调试生产级 AI Agent 系统。它是一份架构知识型技能,而非可直接运行的工具。
主要能力(按书中章节主题)
- 对话循环(Conversation Loop):以异步生成器实现的对话控制,包含多种 yield 事件类型(如 thinking、text、tool_call、tool_result、done),并列出终止原因枚举,例如 end_turn、max_tokens、stop_sequence、tool_use、user_interrupt、error、timeout、budget_exceeded、recursion_limit、safety_violation。
- 工具系统(Tool System):描述 45+ 个工具、并发执行与安全协议;给出工具协议的 5 个要素(Zod 校验的 input schema、metadata、可选 parameters、execute 核心逻辑、readOnly/destructive/concurrencySafe 属性),并提供“Fault-Safe Tool Factory”示例,强调捕获错误后返回结构化错误而不抛出。资料还列出 12 类工具分类(文件操作、Shell、浏览器、Git、搜索、记忆、Agent、MCP、Plan、Config、Debug、System)。
- 权限流水线(Permission Pipeline):四阶段访问控制——规则匹配(bash 风格 pattern)、带超时的推测性分类、用户确认提示、默认拒绝兜底;权限模式包括 auto、notify、confirm、reject、interactive,并给出 YAML 规则匹配示例。
- 上下文管理(Context Management):给出有效窗口计算公式,以及四级渐进压缩(Snip、MicroCompact、Collapse、AutoCompact)与熔断器(Circuit Breaker)模式示例。
- 记忆系统(Memory System):四类闭式记忆(fact、preference、context、goal),强调只存不可推导信息、去重、写入 MEMORY.md 与索引、过期过滤,以及 fork 时的记忆继承策略。
- 子智能体与协调者模式(Sub-Agent & Coordinator):Fork 模式支持字节级上下文继承,配置项包括 inheritContext、inheritMemory、inheritTools、inheritGoals、maxDepth,并含递归深度保护;协调者智能体仅做编排、不直接执行工具,通过工具白名单与指令约束双重把关;消息寻址支持 direct、role、capability、broadcast 四种模式。
- MCP 集成:8 种传输协议(stdio、sse、ws、http、ipc、tcp、unix、embedded),五态连接管理(disconnected、connecting、connected、reconnecting、failed)与带指数退避的重连逻辑;工具命名采用三段式
mcp://<server>/<category>/<tool>;Bridge 模式处理 Agent 到 MCP Server 的调用与反向通知。 - Hook 系统:26 个生命周期事件与 5 种 Hook 类型(before、after、transform、validate、observe),Hook 带优先级(0-100)。
- 其他章节主题:技能与插件(11 个核心技能、基于 frontmatter 加载)、流式架构性能优化模式。
使用方式
资料未提供该技能的安装命令、加载方式或具体调用步骤,仅以一个 TypeScript 代码示例展示 Hook 接口,其余使用方式暂未提供。
适用场景
适合需要理解 Agent Harness 内部机制、设计自建 Agent 系统、或调试生产级 Agent 行为的开发者参考,涵盖会话控制、工具治理、权限、上下文压缩、记忆、子智能体协作与 MCP 连接等方向。
限制
资料为架构知识与代码模式说明,未提供可运行产物、性能基准、平台依赖、收费或价格信息;文中代码示例为讲解用途,实际可用性暂未提供。