菜单
Scaffold a new translation unit before decompiling any of its functions -- move the raw asm under decompiled/, create the empty C file and test dir, and wire it into both Makefiles, run_tests.sh, and tests.php. Use when starting on a fresh src/asm/<addr>.src, before the decompile-function skill.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add serial debug logging (LOG_TRACE/DEBUG/INFO/WARN/ERROR/FATAL from serial_debug.h) to a decompiled C unit, so the running code can be observed and proven to be the decompiled one in the emulator. Use when asked to add/instrument logging, trace flow, or verify which build is running.
Incrementally decompile one SH4 function (or block) into C with mirroring unit tests. Use when porting a function from src/asm/<addr>.src to src/<addr>.c, adding tests under tests/<unit>/, or continuing a partially-decompiled translation unit.
Moves global data ownership between pre-data asm files and unit files (C or decompiled asm), including exports/imports, section B allocations, and test visibility gating. Use when relocating variables between groups like 012f44_game/013ae8/0149b0, fixing undefined extern symbols after moves, or converting private globals to STATIC/AIFDEF UNIT_TESTING patterns.
| name | setup-unit |
| description | Scaffold a new translation unit before decompiling any of its functions -- move the raw asm under decompiled/, create the empty C file and test dir, and wire it into both Makefiles, run_tests.sh, and tests.php. Use when starting on a fresh src/asm/<addr>.src, before the decompile-function skill. |
One-time scaffolding for a src/asm/<addr>.src you are about to start decompiling.
This precedes the decompile-function skill: it makes
the unit build from C (non-matching) and from the archived asm (matching), and gives
tests somewhere to live. No functions are ported here.
A name may not be chosen yet -- keep everything hex-only (018644.src, 018644.c,
tests/018644/). Rename to <addr>_name.* later, once a ShortUnit is decided.
Given <addr> (e.g. 018644):
Move the asm into the decompiled archive (use git mv, the matching build
reads it from here):
git mv src/asm/<addr>.src src/asm/decompiled/<addr>.src
Create src/<addr>.c -- just the include, no functions yet:
#include <shinobi.h>
Create the test dir (plain mkdir, starts empty):
mkdir tests/<addr>
run_tests.sh -- add an assemble/compile stanza next to the others (before the
final $sh4objtest suite line):
# <addr>
assemble src/asm/decompiled/<addr>.src
compile src/<addr>.c
Makefile (non-matching) -- swap the SRCS entry from asm to C:
src/asm/<addr>.src \ -> src/<addr>.c \
Makefile.matching -- swap the SRCS entry to the archived asm path:
src/asm/<addr>.src \ -> src/asm/decompiled/<addr>.src \
tests.php -- add a group at the end of groups. Objects are named
<addr>_src.obj / <addr>_c.obj (basename of the asm/C files). The tests array
starts empty; the first .php file lands here once you decompile a function:
[
"tests" => [
],
"objects" => [
"build/output_test/<addr>_src.obj",
"build/output_test/<addr>_c.obj",
]
],
./docker-run.sh ./scripts/run_tests.sh
The new object should assemble and compile with 0 errors/warnings and the suite still pass -- an empty test group builds its objects but asserts nothing.
Do not run a full make (non-matching): steps 5-6 intentionally break it until
every function in the unit is decompiled, because other units still import symbols the
empty C file doesn't yet define. Use the test suite to verify in the meantime.