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

msx-system-audit

Validate general MSX system emulation in EMULATORS, including BIOS-facing behavior, Z80/VDP interrupt wiring, standard I/O ports, PPI 8255 ports

Commnets/EMULATORS
インストール方法を見る

含まれるファイル（3）

  • SKILL.md2.8 KB
  • agents/openai.yaml242 B
  • references/system.md6.7 KB

SKILL.md（原文）

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

MSX System Audit

Core Workflow

Use this skill to audit whether EMULATORS behaves like a real MSX machine at the system-integration level.

  1. Read references/system.md before making claims or edits.
  2. Inspect the relevant implementation paths first:
    • include/MSX/MSX.hpp, src/MSX/MSX.cpp
    • include/MSX/Model.hpp, src/MSX/Model.cpp
    • include/MSX/PortManager.hpp, src/MSX/PortManager.cpp
    • include/MSX/PPI8255.hpp, src/MSX/PPI8255.cpp
    • include/MSX/PPI8255Registers.hpp, src/MSX/PPI8255Registers.cpp
    • include/MSX/OSIO.hpp, src/MSX/OSIO.cpp
    • include/MSX/FileIO.hpp, src/MSX/FileIO.cpp
    • emulators/MSXEmulator*, emulators/MSXPrograms, and docs/MSXData
  3. When changing C++ code, also use $emulators-framework-cpp-style.
  4. Use $msx-memory-map-audit for slot/subslot or mapper issues, $msx-vdp-audit for TMS9918A behavior, and $msx-sound-audit for PSG/AY/YM behavior.
  5. Separate generic chip behavior from MSX-specific wiring. The 8255, AY-3-8910, and TMS9918A all have generic semantics, but MSX assigns their ports and some bits very specifically.

Audit Priorities

Prioritize correctness in this order:

  • Standard I/O decode and dispatch: VDP #98-#9B, PSG #A0-#A2, PPI #A8-#AB, printer #90-#91, memory mapper #FC-#FF when present.
  • PPI #A8 primary-slot register read/write and propagation into the memory system.
  • PPI #A9/#AA keyboard matrix read path, including active-low keys and row selection.
  • PPI #AA cassette motor/output, CAPS LED, and key-click output bits; #AB bit set/reset command behavior.
  • VDP interrupt wiring to Z80 INT and BIOS interrupt/hook behavior.
  • PSG GPIO cooperation with joystick ports, cassette input, keyboard layout bit, and Kana LED.
  • Model-specific configuration: BIOS ROMs, RAM size, language/keyboard layout, PAL/NTSC video standard, VDP/PSG/PPI instances, and optional devices.

Validation Hints

Prefer small port-level or BIOS-level programs over whole-game comparisons. Useful local anchors include:

  • emulators/MSXPrograms/KEY/*.key
  • emulators/MSXEmulator/MSXSysVars.txt
  • emulators/MSXEmulatorC/MSXSysVars.txt
  • emulators/MSXEmulator*/bios/*.rom
  • docs/MSXData/Keyboard*.jpg
  • tests/TestZ80

When reporting a finding, identify the I/O port or BIOS-visible state, the expected MSX wiring, and the exact class or method that diverges.

レビュー

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

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

c64-1541-audit

無料

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日 更新

c64-cia-audit

無料

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日 更新

c64-memory-map-audit

無料

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日 更新

c64-mps801-printer-audit

無料

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日 更新

c64-mps802-printer-audit

無料

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日 更新

c64-sid-audit

無料

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 のスキルをすべて見る

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