用途:为 claude-forge 框架提供结构化执行轨迹捕获与 token 基线,理念是“优化前先度量”。
主要能力:extract 将会话 JSONL 解析为轨迹 JSONL;count-tokens 统计各文件 token;baseline 生成完整 harness token 基线(TSV,含 tier 分类)。提取优先使用 tool_use 块(高精度),解析 Agent、Bash、Edit/Write、WebFetch、AskUserQuestion 等信号,文本正则仅作回退。轨迹 schema v2 含 rejected_alternatives、PERMISSION_EVENT、ROUTE 及 SUMMARY 中的 6 维 metrics。
使用方式:cd skills/harness-trace;uv sync;uv run -- harness-trace extract ~/.claude/projects/PROJECT/SESSION.jsonl;uv run -- harness-trace count-tokens rules/;uv run -- harness-trace baseline --base-dir /path/to/claude-forge。
适用场景:分析编排步骤、统计 token 占用、建立基线以评估优化效果。
限制:结果缺失或截断时对应轴为 unknown,不臆造计数;异步 reviewer 可能无 findings;SCORE 需按协议字面报告;超大或畸形 JSONL 可能缓慢或挂起。