spike-trap

SpikeTrap Profiling Skill

Run an automated CPU profiling session using SpikeTrap. $ARGUMENTS

Modes

Determine which mode to use based on the user's request:

• profile (default): Enter play mode, collect spike frames, stop, analyze, and report.
• analyze: Skip profiling — analyze already-cached data or a loaded .data file.

If the user provides a spike threshold (e.g. "33ms", "16.6ms"), use it. Default: 33ms. If the user provides a GC threshold (e.g. "100KB"), use it. Default: 0 (disabled). If the user provides a duration (e.g. "10 seconds"), wait that long before stopping. Default: 10 seconds.

Profile Workflow

Step 1: Check prerequisites

using SpikeTrap.Editor;
return $"ViewActive={SpikeTrapApi.IsViewActive}, Collecting={SpikeTrapApi.IsCollecting}, Cached={SpikeTrapApi.CachedFrameCount}";

If IsViewActive is false, tell the user to open the Profiler window and select the SpikeTrap CPU module, then stop.

Step 2: Enter play mode

Use mcp__uLoopMCP__control-play-mode with Action=Play. Wait for Unity to be ready.

Step 3: Enable profiler and start collecting

using UnityEditorInternal;
using SpikeTrap.Editor;
ProfilerDriver.enabled = true;
SpikeTrapApi.StartCollecting(spikeThresholdMs: <THRESHOLD>f, gcThresholdKB: <GC_THRESHOLD>f);
return $"Collecting: spike>{<THRESHOLD>}ms, gc>{<GC_THRESHOLD>}KB";

Step 4: Wait for the requested duration

Tell the user profiling is running. Use ScheduleWakeup or repeated checks to wait.

Step 5: Stop and save

using SpikeTrap.Editor;
string path = System.IO.Path.Combine(UnityEngine.Application.dataPath, "..", "spike-trap-capture.data");
bool saved = await SpikeTrapApi.StopCollectingAndSaveAsync(path);
return $"Saved={saved}, Path={path}";

Then stop play mode with mcp__uLoopMCP__control-play-mode Action=Stop.

Step 6: Analyze (same as Analyze Workflow below)

Analyze Workflow

Step 1: Get spike frames

using SpikeTrap.Editor;
var spikes = SpikeTrapApi.GetSpikeFrames(<THRESHOLD>f);
if (spikes == null || spikes.Length == 0) return "No spike frames found.";
var sb = new System.Text.StringBuilder();
sb.AppendLine($"Found {spikes.Length} spike frames (>{<THRESHOLD>}ms):");
for (int i = 0; i < System.Math.Min(20, spikes.Length); i++)
    sb.AppendLine(spikes[i].ToString());
return sb.ToString();