Agents Observe：Claude Code 多智能体观测

要解决的问题

Claude Code 的多智能体工作流一旦跑起来，可观测性往往就断档了。单个代理的终端输出淹没在日志里，子代理的调用链、工具调用顺序、文件读写动作散落在各处。出问题时，你只知道"某个任务失败了"，却很难回答"它到底执行了什么、改了哪些文件、在哪一步偏离了预期"。Agents Observe 的目标就是把这个调试的起点拉回代理的实际执行动作上。

核心能力与工作方式

这个技能通过 Claude Code 的钩子（hook）机制抓取事件，在本地运行一个服务器（容器形式），把事件流汇聚到实时仪表板中呈现。它关注四类信息：

• 多智能体会话：谁被启动了、何时结束、上下文是否嵌套
• 工具调用：每次调用的输入与结果
• 文件活动：读写、修改发生在哪个路径
• 嵌套任务进度：子代理任务的层级推进

机制上，钩子脚本通过 node 运行，负责把 Claude Code 执行过程中产生的事件推送到本地仪表板服务；仪表板容器接收后做聚合展示。调试时你不再依赖猜测，而是直接回放代理的执行轨迹，从实际动作入手定位问题。

适用边界与注意点

• 依赖本地基础设施：Docker 是必需的（服务器以容器形式运行），Node.js 也是必需的（钩子脚本依赖它执行）。两者任一缺失，插件就无法正常加载。
• 需要本地浏览器访问仪表板，属于开发机上的旁路观测，不适合无 GUI 的远程 CI 场景。
• 事件捕获依赖 Claude Code 的钩子配置，属于侵入式观测：钩子注册会进入你的工作流配置，需要确认与现有工具链无冲突。
• 它只负责"看到发生了什么"，不改变代理的行为或策略本身。