技能介绍

要解决的问题

Claude Code 的一次任务往往不是单次工具调用，而是一连串工具执行、子代理派生、上下文压缩的异步过程。出问题时，很难凭印象回答几个基本问题：是哪一步先失败的？子代理是谁派的？token 实际消耗在哪个模型上？这个技能要补的就是这块观测盲区——把运行时事件从 Claude Code 内部流出来，投到一个可以随时打开的本地面板上。

技能如何工作

它依赖 Claude Code 原生的 hook 机制：不改动 agent 本身的逻辑，而是把会话、工具、子代理、工作流四类事件旁路采集下来，转发到本地 dashboard 服务。dashboard 用 Node.js + Express + React 构建，数据落在本地 SQLite，因此进程崩溃或网络抖动都不会丢历史记录。

面板分两块：

Session Detail · Agents：单会话的实时概览。包括事件数、工具调用次数、子代理数量、压缩次数、错误数和耗时；附 Top 工具使用条形图、子代理类型分布、token 流向和代理层级视图。
Analytics：跨会话的聚合视图。按模型统计 token 用量，统计工具频次，画活动热力图和会话趋势，并标记在线/离线状态。

排查问题时可以先翻错误数和工具调用序列定位失败环节，再从 token 流向和模型用量判断成本集中在哪个模型上。

适用边界

这套方案是旁路观测，不是运行时治理：它能看到调用，但不能拦截或改写调用，权限管控仍然要靠 Claude Code 自身配置。本地 dashboard 服务需要常驻，事件依赖 hook 上报，进程未启动时产生的事件不会被回填。接入 MCP host 属于可选能力，不是默认链路。它展示的是 hook 覆盖范围内的事件，超出该范围的行为需要另找观测手段。