用途：让 Agent 不依赖浏览器 UI，通过 cclens trace 完成 trace 定位、Lead/Subagent 选择、Markdown 导出与分析。用户可提供 UUID 会话 ID、时间线索或问题描述，Agent 走 list → show → export → Read markdown 流程。
主要能力：列出候选 session、查看 session 内的 agent、将指定 agent 的 trace 导出为 Markdown 并阅读分析。分析重点包括过大或重复的工具调用、does 与实际行为不一致的 subagent、过长 thinking 路径、Skill 中缺失的约束与决策规则、可减少步骤或交接的机会。
用法：先运行 cclens trace --help 2>&1 确认可用；若输出为 Claude Code 帮助，执行 npm install -g claude-code-lens 升级。始终使用 -f json。常用命令：cclens trace list -f json（支持 --query、--since、--limit、--max-preview）；cclens trace show --session <sessionId> -f json；cclens trace export --session <sessionId> --agent <agentId|lead> -f json，可加 --out /tmp/cclens-<session>-<agent>.md，未指定时默认输出到 ~/.claude-code-lens/exports/trace-<session前8位>-<agentId>.md。随后用 Read 读取 markdownPath。
适用场景：排查整体任务编排、调查单个 subagent 行为或失败原因、对比 Lead 与 Subagent 协作。
限制：仅能分析通过 cclens 启动的 Claude Code 会话；若 trace list 为空或找不到 session，说明该会话缺少 trace，无法获取数据。错误以结构化 JSON 返回，应读取 error.code 决定恢复路径，如 NO_LOGS、SESSION_NOT_FOUND、AGENT_NOT_FOUND、EXPORT_FAILED、UNSUPPORTED_FORMAT、INVALID_ARGUMENT。其他平台支持、费用等信息暂未提供。