AgentSkillsCN

run-slopos

在 QEMU 无头模式下运行 slopos BIOS/MBR 引导加载程序，根据需要重新构建启动镜像，并针对常见运行故障（如软件包缺失、QEMU 显示错误、镜像被锁定或运行卡顿）进行排查与修复。当用户提出运行、启动或验证 slopos 输出结果的需求时，可随时调用此技能。

SKILL.md
--- frontmatter
name: run-slopos
description: Run the slopos BIOS/MBR bootloader in QEMU headless mode, rebuild the boot image when needed, and troubleshoot common run failures (missing packages, QEMU display errors, locked images, or stuck runs). Use when the user asks to run, boot, or verify slopos output.

Run Slopos

Overview

Run the slopos bootloader in QEMU headless mode and verify the text harness output.

Workflow

  1. •Build the image
  • •Run make from the repo root.
  • •Ensure build/os.img is created.
  1. •Run headless and capture output
  • •Run make run.
  • •Expect the harness to print SLOPOS BOOT, Text Harness, and All tests passed.
  • •To quit headless QEMU, press Ctrl-A then X.
  1. •Troubleshoot
  • •If QEMU fails with GTK/display errors, ensure the run command uses -nographic -serial stdio -monitor none.
  • •If QEMU reports a write lock on build/os.img, find and stop the existing QEMU process.
  • •If output is missing, rebuild with make clean && make and re-run.

Quick checks

  • •Confirm nasm and qemu-system-x86 are installed on Ubuntu.
  • •Confirm the boot sector signature 0xAA55 exists in the last two bytes of build/bootloader.bin.