ewrogers/sgdk-skills

sgdk-multitasking

Schedule spare-time CPU work with SGDK's single user task, including background decompression, procedural calculations, safe publication and cancellation.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/ewrogers/sgdk-skills --skill sgdk-multitasking

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

SGDK multitasking

Use time left after foreground work. The Mega Drive still has one 68000: a background task makes a long calculation interruptible; it does not make that calculation cheaper or guarantee a completion deadline.

Start from the user's game and its existing ownership and frame loop. Spare Time Lab demonstrates execution contracts, not a prescribed game, UI or architecture.

Workflow

  1. Pull ewrogers/sgdk:latest and inspect its task.h, task.s, frame waits and

startup stack setup. Record versions. Online master may differ from the image.

  1. First consider a small bounded step each frame. Use the SDK task when a pure

CPU routine, such as a synchronous decoder, needs to continue across frames without rewriting its internal state machine. Short jobs may not justify it.

  1. Reserve foreground time first: gameplay, input, rendering preparation, audio

commands and VBlank service. Choose a deadline/fallback for late results. A busy foreground may leave the worker no useful time.

  1. Keep one persistent, non-returning callback. Give it an audited stack and one

explicitly owned job. Preserve its PC/stack when holding work; TSK_stop() followed by TSK_userSet() is not pause/resume.

  1. Restrict worker code to immutable inputs and private RAM. Audit every called

routine for global state and hardware access. Keep VDP, DMA, input, audio, allocation and interrupt control in the foreground. Keep ROM mappings stable.

  1. Publish complete output through a documented single-CPU handshake. Cancellation

is a request until the worker acknowledges it. Keep queued DMA sources alive and immutable until the foreground knows transfers have drained.

  1. Test deterministic bytes, rejected requests, cancellation boundaries, retry,

guards and publication. Build release/debug on ARM64 and AMD64. Check actual frame pacing, input, stack headroom and PAL/NTSC behavior in an emulator; console interrupt timing and audio contention still need hardware.

Read SDK execution and stacks before using TSK APIs or combining them with interrupts. Read jobs and ownership when designing the mailbox, cancellation, deadlines and output handoff.

Spare Time Lab unpacks verified APLIB data and computes a weather map while a small foreground activity continues. It includes its own source generator and build instructions; no other installed skill is required.

Boundaries

  • sgdk-compression selects codecs, verifies decoded bytes and measures costs.

This skill controls when CPU work runs; ordinary unpack() remains synchronous to its caller even when that caller is a background task.

  • sgdk-streaming owns caches, residency and bounded graphics uploads. A worker

can prepare bytes; the foreground streaming owner decides when to publish them.

  • sgdk-ai owns detection/pathfinding algorithms; prefer bounded searches before

using spare-time execution. Never apply an obsolete result to a changed world.

  • sgdk-memory, sgdk-performance, sgdk-testing own broader budgets and QA.

Supply stack/buffer costs and completion measurements, not a competing clock.

  • sgdk-raster, sgdk-audio, sgdk-cartridge own raster timing, sound drivers and

bank mappings. A task is not permission to access those subsystems concurrently.

These links describe responsibilities, not mandatory companion installations.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
ewrogers
社区

sgdk-ai

Implement enemy behavior in SGDK games with patrol/chase/attack states, sight cones, target selection, bounded pathfinding and staggered updates. Use when enemies see through walls, get stuck, switch targets erratically, return stale paths or cause frame spikes while searching.

1小时安装量
1
GitHub Stars
0
最近更新
10月20日
ewrogers
社区

sgdk-assets

Prepare, import and troubleshoot Mega Drive graphics, palettes, spritesheets, tiles, maps, fonts and audio resources with SGDK ResComp in Docker. Use for .res files, palette or tile budgets, broken imports, sprite cutting and asset pipeline changes.

1小时安装量
1
GitHub Stars
0
最近更新
10月20日
ewrogers
社区

sgdk-best-practices

Write or review SGDK C for defined arithmetic, clear module boundaries, resource lifetimes, safe queued transfers and interrupt sharing. Use for implementation quality and project code organization, rather than toolchain setup, game design or performance profiling alone.

1小时安装量
1
GitHub Stars
0
最近更新
10月20日
ewrogers
社区

sgdk-cartridge

Plan and implement large SGDK cartridges with Sega/SSF bank switching, FAR resources, pinned shared code and audio, and safe SRAM access. Use when a ROM exceeds the linear address window, stage assets live in separate banks, a FAR pointer becomes invalid, or saving interferes with banked content.

1小时安装量
1
GitHub Stars
0
最近更新
10月20日