本文へ移動
cccskills
無料GitHub で公開

c64-vicii-audit

Validate Commodore 64 VIC-II emulation in EMULATORS, including $D000-$D3FF register behavior, PAL/NTSC timing, raster counters, badlines, BA/AEC bus stealing, video matrix and bitmap fetches, sprites, collisions, borders, IRQs, color RAM usage, and display modes. Use when Codex reviews or edits VICII, Screen, Memory/PLA, raster, sprite, video, or cycle-level behavior for C64 classes.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md3.1 KB
  • agents/openai.yaml222 B
  • references/vicii.md6.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

C64 VIC-II Audit

When compiling, testing, or executing on Windows, use $emulators-windows-build-runtime.

Core Workflow

Use this skill to audit whether EMULATORS simulates the VIC-II as a timing-sensitive bus participant, not only as a frame renderer.

  1. Read references/vicii.md before judging VIC-II behavior.
  2. Inspect the local implementation paths first:
    • include/COMMODORE/VICII/VICII.hpp, src/COMMODORE/VICII/VICII.cpp
    • include/COMMODORE/VICII/VICIIRegisters.hpp, src/COMMODORE/VICII/VICIIRegisters.cpp
    • include/C64/Screen.hpp, src/C64/Screen.cpp
    • include/C64/Memory.hpp, src/C64/Memory.cpp
    • include/C64/ColorMemory.hpp, src/C64/ColorMemory.cpp
    • CIA2 bank-selection code under include/C64/CIA2* and src/C64/CIA2*
  3. When changing C++ code, also use $emulators-framework-cpp-style.
  4. Decide whether the code path is PAL, NTSC, or model-agnostic before asserting exact line/cycle counts.
  5. Treat cycle placement, register side effects, and bus ownership as user-visible behavior. Demos and tests depend on these details.
  6. When changing the VICIIEVENTS overlay, its event meanings, or its colors, update the ;CVICIIEVENTS legend in the canonical projects/COMMODORE/Commodore.fmt. Do not edit distributed formatter copies directly; regenerate them through the normal build/distribution workflow when required.

Audit Priorities

Prioritize correctness in this order:

  • Raster counter and $D011/$D012 high-bit interaction.
  • Badline condition, display enable latch, VC/VCBASE/RC updates, and c-access timing.
  • BA/AEC bus stealing and CPU-visible wait behavior.
  • $D018 video matrix/character/bitmap pointer calculation inside the selected VIC bank.
  • Text, multicolor text, bitmap, multicolor bitmap, ECM, invalid modes, and idle state.
  • Sprite DMA, pointer fetches, expansion, multicolor mode, priority, and collision registers.
  • IRQ flags/masks, collision flag clearing, lightpen, border flip-flops, and open/unconnected read bits.

Validation Hints

Useful local programs and visual tests:

  • emulators/C64Programs/Code/Tests/TESTGRAPHMODES.asm
  • emulators/C64Programs/Code/Tests/TESTHRESMODES.asm
  • emulators/C64Programs/Code/Tests/TESTSPRITESIRQ.asm
  • emulators/C64Programs/Code/Tests/SPRITESPRIORITY.asm
  • emulators/C64Programs/Code/Tests/SP4.asm
  • emulators/C64Programs/Code/Tests/demos/RASTERBARS0.asm
  • emulators/C64Programs/Code/Tests/demos/RASTERBARS1.asm
  • emulators/C64Programs/Code/Tests/demos/RASTERBARS2.asm
  • emulators/C64Programs/Code/Tests/demos/BORDER1.asm
  • emulators/C64Programs/Code/Tests/demos/Sprite.asm

When a visual symptom is involved, prefer a narrow raster/sprite test over a whole-game comparison.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Validate Commodore 1540/1541/1541C/1541-II compatible disk-drive behavior in EMULATORS, including IEC serial bus protocol, device numbers, KERNAL traps, CBM DOS commands/status, D64 image parsing, BAM/directory/file chains, PETSCII filenames, 6502 drive CPU/ROM/RAM expectations, 6522 VIA wiring, GCR/track/sector geometry, motor/head timing, and compatibility boundaries for 1541-like devices. Use when Codex reviews or edits C64, VIC-20, C264, COMMODORE disk, serial I/O, D64, CBM DOS, IEC, VIA, GCR, or 1541 drive code.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 CIA 6526 emulation in EMULATORS, including CIA1/CIA2 $DC00/$DD00 register behavior, ports, DDRs, keyboard/joystick matrix, IEC/user port, VIC bank selection, timers A/B, underflow timing, PB toggle/pulse output, TOD clock/alarm, serial shift register, FLAG, ICR masks and IRQ/NMI lines. Use when Codex reviews or edits C64 CIA, timers, ports, keyboard, joystick, serial bus, interrupts, TOD, or VIC bank control.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 memory map, PLA/bank switching, 6510 port $0000/$0001 behavior, VIC bank selection, color RAM, ROM/RAM overlays, cartridge mapping, and mirrored I/O in the EMULATORS C64 namespace. Use when Codex reviews or edits C64 memory, PLA, CPU-visible address decoding, VIC-visible memory, color memory, char ROM, cartridge, expansion I/O, or mapped chip register behavior.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore MPS-801 serial dot matrix printer behavior in EMULATORS, including SerialPrinterMPS801 classes and their MatrixPrinterEmulation and SerialPrinterPeripheralSimulation hierarchy, IEC/KERNAL-trap printer routing, device numbers, secondary addresses, PETSCII/character sets, 6x7 glyphs, double width, graphics mode, reverse field, tab and dot positioning, line/page geometry, PostScript output, and fidelity boundaries. Use when Codex reviews or edits COMMODORE MPS801 printer code, generated printer output, PostScript printer templates, C64/VIC-20/C264 serial-printer behavior, or compares implementation against .codex/docs/MPS801.pdf and historical MPS-801 sources.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore MPS-802 and 1526 serial dot matrix printer behavior in EMULATORS, including SerialPrinterMPS802 classes and their MatrixPrinterEmulation and SerialPrinterPeripheralSimulation hierarchy, IEC/KERNAL-trap printer routing, device numbers, secondary-address functions, PETSCII/character sets, 8x8 glyphs, enhanced width, reverse and paging modes, formatter strings, programmable characters, line/page geometry, PostScript output, and fidelity boundaries. Use when Codex reviews or edits COMMODORE MPS802 printer code, generated printer output, PostScript printer templates, C64/VIC-20/C264 serial-printer behavior, or compares implementation against .codex/docs/MPS802.pdf, the MPS-802 user guide, and 1526/MPS-802/4023 service information.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 SID 6581/8580 sound emulation in EMULATORS, including $D400-$D7FF register decoding, voices, frequency, pulse width, control bits, ADSR/envelope behavior, oscillator sync/ring/noise/test, filters, volume DAC/sample clicks, paddles, read-only registers, mirrors, and reSID integration. Use when Codex reviews or edits SID, Sound, audio wrapper, register, filter, waveform, envelope, or mapped SID behavior.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Commnets のスキルをすべて見る

このスキルの問題を報告する