执行轨迹采集器

解决什么问题

当某个 skill 在 IDE 会话里跑完后，工程师往往很难拿到一份可复盘的执行记录：哪些 tool_pair 真正触发了目标 skill、每步消耗多少 token 与金额、哪些产物是最终交付物、哪些失败或重试值得排查。trace-collector 针对这个问题，把会话消息、IDE 日志、产物目录和后端上报串成一条可审计链路。

如何工作

该技能分为两条独立流程：init skill 上报本地 skill 目录并生成版本；collect trace 在目标 skill 执行后采集当前 session 的完整 trace。后者以最近一次 use_skill、load_skill 或 skill_loader 调用为起点，自动剥离之前的历史，因此通常不需要新开对话。脚本会先提取 trace_raw.jsonl，再从 IDE 日志解析每次 LLM 调用的真实 usage、cache 命中、credit、耗时、bash 字节与压缩事件；随后基于 trace_compact.json 让主 agent 只写 step outline 和 target_skill_outputs，由 hydrate 脚本按事件索引透传完整 args 与 result 摘要。最终生成 trace_steps.json、facts.json、产物拷贝 output/，并按白名单上传到后端。

适用边界

它适合已发生的目标 skill 执行，不适合边跑边收集实时 trace；若同一 session 多次调用同一 skill，只会采集最近一次。未检测到 skill 调用时会保留全部历史并给 warning，需要人工核对。API key 必须每次手输，上传失败不做降级，应重跑幂等上传。