EmulatorPkg UEFI Shell 应用开发技能

基于 EmulatorPkg 的 UEFI Shell 应用程序开发技能，为 Claude Code 提供完整的开发指南。

English | 简体中文

简介

本技能为 Claude Code 提供 UEFI Shell 应用程序开发的完整知识库，涵盖从环境搭建到调试部署的全流程。支持 Windows（Visual Studio 2019）和 Linux（GCC）双平台开发环境。

特性

• 完整工作流 — 环境搭建、编译、开发、调试一站式指南
• 双平台支持 — Windows (VS2019) + Linux (GCC)
• 代码模板 — INF 文件、Shell 应用、GOP 图形应用模板
• 调试指南 — Print 输出、DebugLib、VS2019 调试器集成
• 中文支持 — 解决 VS2019 中文编码编译错误 (C4819)
• QEMU 运行路径 — 除 Emulator/WinHost 外，提供 QEMU + OVMF + 虚拟 FAT 镜像运行模板
• snapshot 自动截屏 — 运行后按间隔截取目标画面，写入带时间戳的 PNG，供多模态分析
• 版本一致性检查 — 每次构建自动递增 build 号，串口和窗口输出版本，运行后比对 expected_version.txt
• 眼睛和手（QMP 闭环） — monitor screendump 抓显存快照（规避 SDL 窗口抓屏必黑）、sendkey 注入按键，构成"看图-操作"闭环，支持无人值守的"编译-运行-看图-按键-验证"循环

安装

方法一：直接复制

将 SKILL.md 复制到 Claude Code 技能目录：

# Windows
copy SKILL.md %USERPROFILE%\.claude\skills\emulator-uefi-shell-app\

# Linux/macOS
mkdir -p ~/.claude/skills/emulator-uefi-shell-app
cp SKILL.md ~/.claude/skills/emulator-uefi-shell-app/

方法二：Git Clone

git clone https://github.com/your-username/emulator-uefi-shell-app-skill.git
cd emulator-uefi-shell-app-skill

# Windows
xcopy /E /I skills\emulator-uefi-shell-app %USERPROFILE%\.claude\skills\emulator-uefi-shell-app

# Linux/macOS
cp -r skills/emulator-uefi-shell-app ~/.claude/skills/

快速开始

安装后，在 Claude Code 中直接提问即可触发技能：

如何创建一个 UEFI Shell 应用程序？
如何在 EmulatorPkg 中使用 GOP 进行图形渲染？
编译时出现 C4819 中文编码错误怎么解决？
如何在模拟器中调试 Shell 应用？

内容目录

触发条件

当用户提问涉及以下内容时自动触发：

• UEFI Shell 应用程序开发
• EmulatorPkg 模拟器编译运行
• GOP 图形编程
• UEFI 应用调试方法
• 中文编码编译错误
• QEMU 运行 UEFI Shell app
• 用 snapshot 截图分析运行结果
• 防止编译失败后运行旧版本
• QEMU/SDL 窗口截图全黑（改用 monitor screendump）
• 需要脚本驱动 QEMU 中的应用（按键注入、自动开局/操作）
• 需要"编译-运行-看图-按键-验证"的无人值守闭环

支持的协议

常用库

快速参考

相关资源

• EDK2 官方仓库
• UEFI 规范
• TianoCore 文档

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证。

---

注意：本技能需要配合 Claude Code 使用。