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

emulators-system-test-builder

Design and implement unit, conformance, integration, timing, boot, trace, video, audio, and regression tests for EMULATORS processors, chips, peripherals, and complete machines. Use when creating a verification strategy for a new emulator, converting hardware documentation into tests, adding diagnostic programs or golden artifacts, measuring behavioral coverage, or proving that components interact correctly.

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

含まれるファイル（3）

  • SKILL.md3.0 KB
  • agents/openai.yaml226 B
  • references/validation-matrix.md1.3 KB

SKILL.md（原文）

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

Build EMULATORS System Tests

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

Required Context

  1. Read references/validation-matrix.md.
  2. Read .codex/skills/emulators-new-machine/references/workspace-artifacts.md. Store working validation matrices, acquisition state, and intermediate evidence in the active .codex/work/ scope or .codex/tmp/<task>/ as appropriate, never in docs/.
  3. Inspect the implementation contract, authoritative hardware sources, nearby tests under tests/, and diagnostic programs under emulators/*Programs/.
  4. Use $emulators-framework-cpp-style for C++ tests. Use $emulators-debug-log-audit when instruction/cycle traces are part of the evidence.
  5. Use the relevant CPU, chip, I/O, memory-map, video, sound, or system audit skill when its trigger matches.

Workflow

  1. Define observable claims before choosing the test mechanism. Map every important claim to a source, stimulus, expected observation, tolerance, and test layer.
  2. Build the cheapest reliable layer first: unit, component, integration, diagnostic program, then boot or application test.
  3. Derive expectations independently from documentation, known vectors, captured reference traces, or manually justified calculations. Never duplicate the implementation formula as the oracle.
  4. Make time explicit. Record sampling points, preconditions, cycles elapsed, intermediate events, and final state for timing-sensitive tests.
  5. Control nondeterminism: seed randomness, replace host time, provide fixed input streams, isolate filesystem state, and define audio/video tolerances.
  6. Test boundaries and negative paths before declaring coverage complete.
  7. Add regression tests for every confirmed defect when a stable observable exists.
  8. Build and run the narrowest target, then the relevant integration target. Preserve raw failure evidence when a discrepancy remains.

Evidence Standards

  • Prefer exact state or ordered trace assertions over screenshots and log substring matching.
  • Use golden video or audio only with documented format, capture window, tolerance, and update policy.
  • Distinguish structural opcode/register coverage from behavioral and timing coverage.
  • Treat a passing boot as a smoke test, not proof of component accuracy.
  • Mark unavailable ROMs, proprietary suites, hardware captures, or external vectors as evidence gaps.

Completion Evidence

Report the validation matrix, new tests and assets, commands and results, coverage by behavior class, environmental dependencies, unresolved mismatches, and fidelity claims the evidence actually supports.

レビュー

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

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

同じリポジトリのスキル

概要と使いどころ

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

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