تشغيل أي مهارة في Manus بنقرة واحدة

asm-guru

النجوم٠

التفرعات٠

آخر تحديث٢٨ يناير ٢٠٢٦ في ٠٤:٠٨

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

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·SOC 15-1252

SKILL.md

readonly

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/

المزيد من هذا المستودع

نفس المستودع

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/