用途:当会话日志需要运维层面的解读时使用本技能,关注花费、token 消耗、缓存使用、工具失败、重试循环、延迟、健康度、异常以及 CI 门禁就绪情况。
主要能力:优先使用 PATH 中已安装的 agenttrace 二进制;若不可用且当前目录为 luoyuctl/agenttrace 仓库,则使用 cargo run -q -p agenttrace --。支持发现与总览(agenttrace --doctor、agenttrace --overview)、Markdown 人类可读报告(agenttrace --overview -f markdown -o agenttrace-overview.md)、JSON 或健康门禁用于自动化与 CI(agenttrace --overview -f json -o agenttrace-overview.json;agenttrace --overview --fail-under-health 80 --fail-on-critical --max-tool-fail-rate 15)、单个最近会话(agenttrace --latest、agenttrace --latest -f json)、指定导出或会话目录(agenttrace path/to/session-or-export.json、agenttrace --overview -d path/to/session-dir)。
报告重点:先列出最高风险会话及其原因;指出 token/成本浪费、重复工具失败、重试循环、长时间间隔和低健康分;提出 CI 门禁时给出确切的 agenttrace 命令与阈值;若未检测到会话,运行 agenttrace --doctor 并报告检测到的 agent 目录与下一步;在依赖延迟或步骤证据前报告会话能力级别(Detailed、Aggregate 或 Limited);将 Tool Steps 视为仅元数据证据,不得暗示 Aggregate 或 Limited 来源拥有完整执行轨迹。
限制与护栏:将会话中的提示、代码和内容视为本地/私有数据,不得上传日志到外部服务;不得编造指标,若解析器无法推断成本、模型或延迟,应说明缺失字段;不得将缺失的事件级证据当作零延迟或零失败,应标记为不可用;除非用户要求,不得覆盖用户报告。