AgentSkillsCN

trace-operations

捕获并回放3Lens轨迹，用于调试、性能分析以及回归测试。在录制轨迹、打开/回放已保存的轨迹，或导出轨迹数据以供分享时使用。

SKILL.md
--- frontmatter
name: trace-operations
description: Capture and replay 3Lens traces for debugging, performance analysis, and regression testing. Use when recording traces, opening/replaying saved traces, or exporting trace data for sharing.

Trace Operations

Trace operations are the foundation of 3Lens analysis. Use these commands to capture, replay, and export render traces.

When to Use

  • •Recording a baseline before making changes
  • •Capturing a performance spike reproduction
  • •Sharing traces for debugging or collaboration
  • •Comparing before/after states

Commands

Record a Trace

bash
# Record for a specific duration
3lens trace:record --duration 10s --out ./traces/runA.json

# Record a specific number of frames
3lens trace:record --frames 300 --out ./traces/runA.json

# Record until frame time stabilizes
3lens trace:record --until-idle --out ./traces/runA.json

Options:

OptionDescription
--duration <seconds>Record for specified time
--frames <count>Record specified number of frames
--until-idleRecord until frame time stabilizes
--mode <MINIMAL|STANDARD|DEEP>Capture mode
--contexts <ids>Specific contexts to record

Open/Replay a Trace

bash
# Open in trace viewer UI
3lens trace:open ./traces/runA.json

# Open for headless analysis
3lens trace:open ./traces/runA.json --headless

Export Trace

bash
# Export with minimal profile
3lens trace:export ./traces/runA.json --profile MINIMAL --out ./report.json

# Export with full redacted profile (safe for sharing)
3lens trace:export ./traces/runA.json --profile FULL_REDACTED --out ./share.json

Export Profiles: MINIMAL, STANDARD, FULL, FULL_REDACTED

Agent Use Cases

  1. •Before refactoring: "Record a baseline trace before the shader refactor"
  2. •Bug reproduction: "Capture a trace when the memory spike occurs"
  3. •CI regression: "Record traces for baseline comparison"

Additional Resources