一键在 Manus 中运行任何 Skill

romhack-asm-tuner

星标0

分支0

更新时间2026年1月28日 04:08

SNES Assembly (65816) patch manager. Curates ASM snippets, verifies patches with Asar/Z3DK, and manages the code library for Oracle of Secrets.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

scawful

scawful/afs_scawful

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

ROMHack ASM Tuner

Scope

Write, verify, and apply 65816 ASM patches.
Manage a library of ASM snippets (routines, hooks, data tables).
Run asar (or z3asm) to verify syntax and bank limits.
Curate the oracle-of-secrets codebase conventions.

Core Capabilities

1. ASM Verification

Check if a snippet is valid 65816 code.

Uses z3asm (part of Z3DK) to dry-run assembly.
Checks for bank overflow, label collisions, and addressing mode errors.

2. Patch Management

apply <file.asm>: Patches the ROM (using build_rom.sh or z3asm).
revert: Rolls back the last patch (via git or backup).

3. Codebase Curation

Enforce style guides:

Namespaces: Oracle.{Scope}.
Labels: . for local, .. for nested.
Defines: Use !Define for constants.
Long Addressing: $7E access must use STA.l ($8F).

Workflow

Draft: "Write a routine to heal Link."
Verify: asm-tuner verify heal.asm.
Refine: "Fix the bank wrapper (missing PHB/PLB)."
Commit: Save to src/hobby/oracle-of-secrets/Core/Link/Heal.asm.

Dependencies

Z3DK: z3asm binary (~/src/hobby/z3dk/build/src/z3asm/bin/z3asm).
Repo: ~/src/hobby/oracle-of-secrets.
Tool: ~/src/hobby/yaze/scripts/ai/asm_tuner.py.

Example Prompts

"Verify the syntax of src/hobby/oracle-of-secrets/Core/Link/Heal.asm."
"Check this ASM snippet for style violations."
"Does this routine use long addressing for WRAM?"
"Draft a routine to increase Rupees by 50."

Troubleshooting

z3asm Not Found: Check ~/src/hobby/z3dk/build/ for the binary. Rebuild Z3DK if missing.
Syntax Errors: Ensure all labels and defines are declared or included. The verifier runs in isolation, so missing includes will cause errors.
Style False Positives: The regex checker is strict. Use .l suffix explicitly for all $7E/$7F accesses.

同仓库更多 Skills

同仓库

agentic-context

scawful/afs_scawful

Use the Agentic File System (AFS) context model for discovery, mounts, scratchpad memory, and file-based tool workflows. Use when a task involves .context operations, AFS CLI usage, or cross-agent context coordination.

2026-04-280

alttp-disasm-labels

scawful/afs_scawful

Read and interpret the Link to the Past (ALTTP) disassembly with label/symbol context. Use when mapping ROM/CPU addresses to labels, searching usdasm/jpdasm sources, or cross-referencing routines with Hyrule Historian, z3dk label indexes, or z3ed output.

2026-03-190

echo-persona

scawful/afs_scawful

Train, evaluate, and maintain the scawful-echo persona and related avatar models (Echo/Memory/Muse). Use when working on persona voice, dataset prep, A/B testing, deployment, or tool-calling constraints for avatar models.

2026-03-190

hyrule-navigator

scawful/afs_scawful

Autonomous navigation agent for Oracle of Secrets. Uses static map data and dynamic RAM state to localize Link and route him to destinations.

2026-03-190

mesen2-oos-debugging

scawful/afs_scawful

End-to-end Oracle of Secrets debugging using the Mesen2-OOS socket CLI, z3ed, and label/symbol tooling. Use for breakpoint/trace capture, memory inspection, savestate repro, overlays, or crash/regression triage (replaces mesen2-mcp and legacy Lua bridge workflows).

2026-03-190

model-training-expert

scawful/afs_scawful

Expert guidance for LLM model training, synthetic data generation (SDE), Hierarchical MoE (H-MoE) management, and agentic evaluation. Use when setting up training runs (Vast.ai), generating datasets, or performing technical research PDF analysis for ROM hacking and general AI development.

2026-03-190

name	romhack-asm-tuner
description	SNES Assembly (65816) patch manager. Curates ASM snippets, verifies patches with Asar/Z3DK, and manages the code library for Oracle of Secrets.

ROMHack ASM Tuner

Scope

Write, verify, and apply 65816 ASM patches.
Manage a library of ASM snippets (routines, hooks, data tables).
Run asar (or z3asm) to verify syntax and bank limits.
Curate the oracle-of-secrets codebase conventions.

Core Capabilities

1. ASM Verification

Check if a snippet is valid 65816 code.

Uses z3asm (part of Z3DK) to dry-run assembly.
Checks for bank overflow, label collisions, and addressing mode errors.

2. Patch Management

apply <file.asm>: Patches the ROM (using build_rom.sh or z3asm).
revert: Rolls back the last patch (via git or backup).

3. Codebase Curation

Enforce style guides:

Namespaces: Oracle.{Scope}.
Labels: . for local, .. for nested.
Defines: Use !Define for constants.
Long Addressing: $7E access must use STA.l ($8F).

Workflow

Draft: "Write a routine to heal Link."
Verify: asm-tuner verify heal.asm.
Refine: "Fix the bank wrapper (missing PHB/PLB)."
Commit: Save to src/hobby/oracle-of-secrets/Core/Link/Heal.asm.

Dependencies

Z3DK: z3asm binary (~/src/hobby/z3dk/build/src/z3asm/bin/z3asm).
Repo: ~/src/hobby/oracle-of-secrets.
Tool: ~/src/hobby/yaze/scripts/ai/asm_tuner.py.

Example Prompts

"Verify the syntax of src/hobby/oracle-of-secrets/Core/Link/Heal.asm."
"Check this ASM snippet for style violations."
"Does this routine use long addressing for WRAM?"
"Draft a routine to increase Rupees by 50."

Troubleshooting

z3asm Not Found: Check ~/src/hobby/z3dk/build/ for the binary. Rebuild Z3DK if missing.
Syntax Errors: Ensure all labels and defines are declared or included. The verifier runs in isolation, so missing includes will cause errors.
Style False Positives: The regex checker is strict. Use .l suffix explicitly for all $7E/$7F accesses.