メニュー
Side-by-side target vs base assembly comparison with mismatch annotations. Shows aligned instructions with match markers, register swap details, and offset deltas. Use when diagnosing the last few percent of a function.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Orchestrate a multi-wave, doc-synced investigation loop into (1) AUDIO CORRECTNESS — record the game's output and measure how far it diverges from the expected/ground-truth source audio (the "clipped noise" problem), and (2) ASSET-LOAD PERFORMANCE — profile and attribute the load-time stutters. You act as orchestrator/coordinator: each wave plans+reviews, fans out subagents (via the Workflow tool / ultracode) over independent hypotheses, converges, builds, re-measures, then plans the next wave. Agents hand off through on-disk docs. Use when iterating on web/native audio fidelity or load-stutter perf.
Verify the game's recorded audio is the SAME audio as the source song AND is played CORRECTLY (right pitch/speed, not clipped/noise/silent). Decrypts+decodes the source mogg into a ground-truth reference, captures the game output headless, then measures identity (mix-robust chroma cross-correlation + Chromaprint fingerprint), playback rate (resample-search → speed ratio; catches the 'chipmunk' bug), and distortion (reference-free clip/flat-top/wrap). Use after any audio change (mixer, limiter, resampler, decode, gain) to confirm the right song still plays correctly, or to investigate an audio-fidelity report. Native-first; works for web captures too.
Diff stack-frame layouts between target and base for a function. Labels base-side slots with source variable names from a MWCC DWARF recompile. Identifies SWAPPED pairs (decl-reorder candidates), SHIFTED slots, DIFFER (different variables in same slot), and TGT_ONLY / BASE_ONLY (extra/missing locals). Filters out callee-save slots.
Diff a DATA symbol (vtable, pointer/jump table, string pool, static initializer) between the target and the decompiled build, showing byte differences and — for each relocation slot — which function/symbol each side points to. Use when a data symbol is below 100%, or to see exactly where your decompiled vtable diverges from the target (which slot resolves to the wrong function). This is the diff counterpart to /vtable and /resolve-vcall, which only read the target.
Resolve a single virtual-call slot to its function symbol. Given `class, sub-object offset, slot`, returns the mangled symbol at that slot of the named class's MWCC vtable. Use when objdiff shows a vcall mismatch and you have the three numbers off the asm but don't want to dump the whole vtable.
Dump a class's MWCC vtable from build/SZBE69_B8/obj/*.o. Shows every sub-object table (primary + each base), slot index, byte offset, and the mangled function symbol. Use when objdiff shows a `lwz r12, OFF(r12)` mismatch and you need to map the offset to a virtual method, or when verifying a header's virtual-function order against the compiled binary.
| name | compare-asm |
| description | Side-by-side target vs base assembly comparison with mismatch annotations. Shows aligned instructions with match markers, register swap details, and offset deltas. Use when diagnosing the last few percent of a function. |
| argument-hint | <symbol_name> |
| allowed-tools | Bash(python3 scripts/analysis/diff_inspect.py *), Bash(bin/objdiff-cli *), Read, Grep, Glob |
Side-by-side target vs base assembly comparison with annotations.
$ARGUMENTS - The function symbol name (MetroWerks mangled).
Run the comparison:
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --compare-asm --project-dir .
Read the output:
= equal, ~ diff_arg (same opcode, different args), ! diff_op, + insert (target only), - delete (base only), X replace[reg:rN->rM] annotations show register swap details[off:+N] annotations show offset/immediate deltasDiagnosis summary at the end shows:
The diff_inspect.py script supports several modes:
# Root cause diagnosis
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --diagnose --project-dir .
# Mismatch clusters (insert/delete regions)
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --clusters --project-dir .
# Register swap pairs
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --regswaps --project-dir .
# Offset shift analysis
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --offsets --project-dir .
# Summary counts by match type
python3 scripts/analysis/diff_inspect.py --symbol "$ARGUMENTS" --summary --project-dir .
--offsets first to see the delta histogram, then --compare-asm for full context/ghidra-decompile to map registers to variable names