一键在 Manus 中运行任何 Skill

asm-guru

星标0

分支0

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

Expert SNES 65816 Assembly coding assistant. specialized in Oracle of Secrets architecture, memory maps, optimization patterns, and safe routine scaffolding.

安装

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

在 Manus 中运行

来源

scawful

scawful/afs_scawful

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

下载

在 Manus 中运行

ASM Guru

Scope

Write, refactor, and optimize 65816 Assembly code.
Enforce project conventions (namespaces, addressing modes).
Lookup memory addresses and RAM layout.
Verify routine safety (bank wrapping, stack integrity).

Core Competencies

1. Project Conventions

Namespaces: Use namespace Oracle { ... } for core logic.
Labels: Use . for local labels (e.g., .loop), .. for nested.
Long Addressing: Default to STA.l ($8F) for WRAM ($7E/7F) to avoid bank wrapping bugs.
Defines: Prefer !Define over hardcoded magic numbers.

2. Routine Templates

Standard Subroutine:

MyRoutine:
{
    PHB : PHK : PLB   ; Bank wrapper
    REP #$30          ; Default to 16-bit A/X/Y
    
    ; ... code ...
    
    PLB               ; Restore bank
    RTL
}

Sprite Handler:

Sprite_Handler:
{
    LDA.w SprState, X
    JSL JumpTableLocal
    dw .init, .main, .dead
    
    .init
    ; ...
    RTS
}

3. Memory Map Awareness

(Consult Docs/Technical/ or symbols.asm for authoritative values)

WRAM Mirror: $0000-$1FFF mirrors $7E0000-$7E1FFF.
Link State: $7E0010 (GameMode), $7E0011 (Submodule).
Sprite Tables: $0E00-$0EFF (Status), $0D00-$0DFF (State).
Extended RAM: $7EF300+ (Save Data).

4. Optimization Rules

Cycles: Prefer ORA #$00 (2 cycles) over CMP #$00 (2 cycles) when just checking zero flag? No, actually LDA sets flags. Use BIT for non-destructive.
Direct Page: Do NOT assume DP is $0000 unless explicitly set.
Branching: Use BRA (always) instead of JMP for short hops.

Workflow

Lookup: "Where is the timer for Sprite X?" -> Check defines.asm or ram_map.asm.
Scaffold: Create a new file in Sprites/ or Core/ with standard headers.
Implement: Write logic using !Defines.
Verify: Check for mismatched REP/SEP, missing PLB, or clobbered registers.

Commands

asm-guru lookup <term>: Search known RAM defines.
asm-guru template <type>: Generate code skeleton (sprite, hook, routine).
asm-guru audit <file>: Scan for common pitfalls (short addressing to 7E, mismatched stack).

References

~/src/hobby/oracle-of-secrets/Docs/Technical/
~/src/docs/65816-SNES-Assembly-master/

同仓库更多 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	asm-guru
description	Expert SNES 65816 Assembly coding assistant. specialized in Oracle of Secrets architecture, memory maps, optimization patterns, and safe routine scaffolding.

ASM Guru

Scope

Write, refactor, and optimize 65816 Assembly code.
Enforce project conventions (namespaces, addressing modes).
Lookup memory addresses and RAM layout.
Verify routine safety (bank wrapping, stack integrity).

Core Competencies

1. Project Conventions

Namespaces: Use namespace Oracle { ... } for core logic.
Labels: Use . for local labels (e.g., .loop), .. for nested.
Long Addressing: Default to STA.l ($8F) for WRAM ($7E/7F) to avoid bank wrapping bugs.
Defines: Prefer !Define over hardcoded magic numbers.

2. Routine Templates

Standard Subroutine:

MyRoutine:
{
    PHB : PHK : PLB   ; Bank wrapper
    REP #$30          ; Default to 16-bit A/X/Y
    
    ; ... code ...
    
    PLB               ; Restore bank
    RTL
}

Sprite Handler:

Sprite_Handler:
{
    LDA.w SprState, X
    JSL JumpTableLocal
    dw .init, .main, .dead
    
    .init
    ; ...
    RTS
}

3. Memory Map Awareness

(Consult Docs/Technical/ or symbols.asm for authoritative values)

WRAM Mirror: $0000-$1FFF mirrors $7E0000-$7E1FFF.
Link State: $7E0010 (GameMode), $7E0011 (Submodule).
Sprite Tables: $0E00-$0EFF (Status), $0D00-$0DFF (State).
Extended RAM: $7EF300+ (Save Data).

4. Optimization Rules

Cycles: Prefer ORA #$00 (2 cycles) over CMP #$00 (2 cycles) when just checking zero flag? No, actually LDA sets flags. Use BIT for non-destructive.
Direct Page: Do NOT assume DP is $0000 unless explicitly set.
Branching: Use BRA (always) instead of JMP for short hops.

Workflow

Lookup: "Where is the timer for Sprite X?" -> Check defines.asm or ram_map.asm.
Scaffold: Create a new file in Sprites/ or Core/ with standard headers.
Implement: Write logic using !Defines.
Verify: Check for mismatched REP/SEP, missing PLB, or clobbered registers.

Commands

asm-guru lookup <term>: Search known RAM defines.
asm-guru template <type>: Generate code skeleton (sprite, hook, routine).
asm-guru audit <file>: Scan for common pitfalls (short addressing to 7E, mismatched stack).

References

~/src/hobby/oracle-of-secrets/Docs/Technical/
~/src/docs/65816-SNES-Assembly-master/