Agents Observe 多智能体运行观测台
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/agents-observe-claude-code-observability-skillhub。
技能介绍
要解决的具体问题
当你在 Claude Code 里跑多智能体任务时,Agent 的执行链会迅速变得不透明:你不知道哪个子代理调用了 Write 或 Bash 工具、改了哪个文件、嵌套任务卡在了哪一步,往往只能通过日志片段事后猜测。这种黑盒状态让调试变得异常困难,因为你无法直观看到代理实际执行的操作顺序和影响范围。
技能如何工作
Agents Observe 为 Claude Code 操作员提供一个实时仪表板,聚焦四类关键信息:
- 多智能体会话:展示当前运行的多个 Agent 及其层级关系
- 工具调用:记录每个代理调用的工具名称、参数与返回结果
- 文件活动:追踪文件读写、创建、删除等变更操作
- 嵌套任务进度:可视化子任务的完成状态与依赖关系
该技能通过本地钩子捕获 Claude Code 的执行事件,将原始数据聚合到仪表板中,使调试从「查看代理实际做了什么」开始,而不是从日志文件里反推。
适用边界与注意点
该技能依赖以下环境组件:
- Docker:服务器作为容器运行
- Node.js:钩子脚本通过
node执行 - 本地浏览器:用于访问仪表板界面
如果主机上未安装 docker 或 node,插件将无法正常加载。此外,该技能聚焦于运行观测,不涉及代理逻辑的修改或性能优化,适合在开发和调试阶段使用,而非生产环境的监控工具。
使用场景
- 多智能体流水线跑完后报错,需要查看哪个子代理调用了哪个工具导致失败
- Claude Code 执行复杂任务时,想实时看到文件被谁修改以及修改顺序
- 嵌套任务执行超时,需要定位卡在哪个子任务及其依赖关系上
- 调试 Agent 行为异常,需要检查它实际调用了哪些工具并传入了什么参数
适合人员
- 使用 Claude Code 开发多智能体应用的工程师,需要快速定位执行链中的失败节点
- 构建 Agent 调试工具的开发者,想集成运行时观测能力到现有系统中
- 负责维护 Claude Code 多智能体工作流的技术负责人,需要在任务出错时快速复盘执行过程
- 研究多智能体协作行为的研究人员,需要记录和分析 Agent 之间的交互细节