菜单
Take screenshots of the native port engine or milo-viewer. Captures headless GPU-rendered PNG frames at specified frame numbers. Use when debugging UI layout, rendering, or verifying visual changes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Run the source permuter on a function to find signed/unsigned and variable extraction improvements. Use when working on a function that isn't matching 100% and you want to automatically try source variations.
Extract assets/materials from RB3 .ark archives and .milo/.dta files. Use when you need game assets for the native port, debugging rendering, or inspecting data.
Side-by-side target vs base assembly comparison with cluster boundaries and mismatch annotations. Shows aligned instructions with match markers, register swap details, and offset deltas. Use when diagnosing the last few percent of a function.
Find DC3 source for a given symbol/string. DC3 is the closest source oracle for rb3-xenon (same compiler, same flags, same engine version family). Use this BEFORE rb3wii-pair when looking for engine code; use rb3wii-pair for game-code logic that DC3 doesn't share.
Decompile and analyze a function from Ghidra. Shows decompiled C code, switch statements, and cast operations. Use when investigating function structure or debugging type issues. Automatically resolves symbol names to correct functions. Need to skip sandbox to access Ghidra over network.
Semantic search over Ghidra decompiled code. Use when looking for similar implementations, finding functions by behavior description, or searching for code patterns. Automatically filters out __unwind$ and other noise.
| name | screenshot |
| description | Take screenshots of the native port engine or milo-viewer. Captures headless GPU-rendered PNG frames at specified frame numbers. Use when debugging UI layout, rendering, or verifying visual changes. |
| argument-hint | [target] [frames] [output-dir] |
| allowed-tools | Bash, Read, Glob |
All Bash calls in this skill MUST use dangerouslyDisableSandbox: true. The script will detect blocked GPU access and tell you if you forgot.
The scripts/gpu/screenshot.sh wrapper handles everything (env vars, headless mode, timeouts).
# rb3-native: default frames (10, 50, 100)
bash scripts/gpu/screenshot.sh native/build/rb3-native
# rb3-native: specific frames, custom output
bash scripts/gpu/screenshot.sh -f 100,500 -o /tmp/my_shots native/build/rb3-native
# milo-viewer: venue scene
bash scripts/gpu/screenshot.sh native/build/milo-viewer \
~/code/milohax/milo-engine-libs/harmonix-repos/milo-rnd-library/rb3/world/gen/venue.milo_xbox
# render-test: specific test scene
bash scripts/gpu/screenshot.sh native/build/render-test --test solid_quads
| Option | Description | Default |
|---|---|---|
-o <dir> | Output directory | /tmp/rb3_screenshots |
-f <frames> | Comma-separated frame numbers | 10,50,100 |
-t <seconds> | Timeout | 30 |
-w <WxH> | Resolution | 1280x720 |
rb3-native screenshots use headless GPU rendering: draw to offscreen texture → GPU readback → PNG.
| Step | Code | What Happens |
|---|---|---|
| Env var parsing | native/src/platform/Rnd_Wgpu.cpp | Reads MILO_SCREENSHOT_DIR, parses frame CSV |
| Frame counter | native/src/platform/Rnd_Wgpu.cpp | mFrameID++ in BeginDrawing() |
| GPU readback | native/src/gfx/GpuDevice.cpp | ReadbackHeadlessFrame() — copies mHeadlessTex → staging buffer → CPU |
| PNG write | native/src/gfx/Screenshot.cpp | stbi_write_png() via WritePNG() |
ReadbackHeadlessFrame() reads from mHeadlessTex — an offscreen texture created only in headless mode. If a window is present (e.g. via a display server), Dawn creates a swapchain instead, and mHeadlessTex is never allocated. Do NOT use a virtual display — screenshots require true headless mode (MILO_HEADLESS=1).
scripts/gpu/screenshot.sh — the wrapper script (auto-sets all env vars, detects GPU access)