atbfun/ATBGamePort

选用指南

AI 根据 README 整理 · 2026/10/26 12:26:42

适用场景

需要将经典桌面游戏（如PopCap SexyAppFramework可执行文件、Windows PE C++二进制、Flash引擎等）转换为可在浏览器中即时游玩的HTML5游戏时适用，提供从逆向工程到部署的完整流程。

查看 README 依据

Industrial-grade agent skills for reverse-engineering and porting classic desktop games (PopCap SexyAppFramework executables, Windows PE C++ binaries, Flash engines, and retro mini-games) into modern, zero-dependency HTML5 Canvas & Web Audio instant-play games. Powered by [fun.aitobox.com](https://fun.aitobox.com).

Porting real games with AI is hard. Prompting an agent with *"build me a web clone of this game"* produces a shallow toy with guessed physics, broken assets, and black screens. `ATBGamePort` replaces guesswork with a disciplined 7-phase engineering pipeline: authoritative binary reverse engineering, automated RGB+Alpha asset composition, 6-language i18n, cross-device `localStorage` save sync, desktop & mobile dual adaptation, and headless browser pixel verification. --- ## Installation (30-second setup)

使用方式

通过AI编程助手（如Claude Code、Codex、GitHub Copilot）安装Skills后，向助手发出指令如“Port source/gameA to HTML5 using atb-game-porting”，也可直接使用Python脚本运行部署或打包功能。

查看 README 依据

```bash git clone https://github.com/atbfun/ATBGamePort.git cd ATBGamePort ./scripts/link-skills.sh ``` Links `skills/atb-game-porting` directly into `~/.claude/skills` and `~/.agents/skills`. </details> --- ## End-to-End Walkthrough: Porting & Publishing a Game Here is a complete real-world example porting, publishing, and packaging a game named `gameA`: ### 1. Place the original game in `source/gameA` Place your classic desktop game assets, executables (`.exe`), media, and data files into: ```text source/gameA/ ├── game.exe ├── images/ ├── sounds/ └── levels/ ```

### 2. Port the game with `atb-game-porting` Tell your AI coding assistant: > Port `source/gameA` to HTML5 using `atb-game-porting`. The skill ([`atb-game-porting`](./skills/atb-game-porting/SKILL.md)) runs static binary reverse engineering, 32-bit alpha asset composition, 6-language i18n, storage persistence, and zero-black-screen Canvas implementation, outputting a fully verified web port to `target/gameA/`: ```text target/gameA/ ├── analysis/reverse_engineering_report.md ├── assets/ ├── src/ ├── web/ │ ├── index.html │ └── assets -> ../assets (symlink) └── README.md ```

- Under **Build and deployment** -> **Source**, select **GitHub Actions** (not "Deploy from a branch") ### 5. Deploy with `atb-game-to-githubpage` Tell your agent: > Deploy this game to GitHub Pages using `atb-game-to-githubpage`. Or run the deployment CLI ([`atb-game-to-githubpage`](./skills/atb-game-to-githubpage/SKILL.md)) directly inside the game repository: ```bash python3 /path/to/ATBGamePort/skills/atb-game-to-githubpage/scripts/deploy.py --target . --commit --push ```

部署要求

需要Python 3（推荐3.10+）用于二进制解析、资源合成和无头浏览器验证，并需要启用reverse-engineer-anything技能及MCP服务器。

查看 README 依据

A plugin updates itself automatically when new versions release. [skills.sh](https://www.skills.sh/p/VoswC8My6zgey2MK) copies editable files into your project. Pick one route per agent so you don't install every skill twice. ### 1. Install Prerequisites `atb-game-porting` requires **Python 3** (for binary parsing, RGB+Alpha asset composition, and headless browser verification) and coordinates with two companion skills: ```bash # 1. Ensure Python 3 (3.10+ recommended) is installed python3 --version # 2. Install grill-me (from mattpocock/skills) for Phase 7 self-inspection

npx skills@latest add mattpocock/skills --skill=grill-me # 3. Ensure the reverse-engineer-anything (REA) skill & MCP server are enabled in your agent ``` ### 2. Install `atb-game-porting` <details> <summary><strong>Claude Code</strong></summary> ```bash claude plugin marketplace add atbfun/ATBGamePort claude plugin install atb-game-porting@atbfun ``` Updates itself automatically when a new version is released. </details> <details> <summary><strong>Codex</strong></summary> ```bash codex plugin marketplace add atbfun/ATBGamePort codex plugin add atb-game-porting@atbfun ```

已知限制

作者指出，没有本技能时，直接提示AI构建游戏克隆会产出浅薄的玩具版本，包括猜测物理、损坏资源和黑屏等问题；本技能旨在消除这些失败模式。

查看 README 依据

Porting real games with AI is hard. Prompting an agent with *"build me a web clone of this game"* produces a shallow toy with guessed physics, broken assets, and black screens. `ATBGamePort` replaces guesswork with a disciplined 7-phase engineering pipeline: authoritative binary reverse engineering, automated RGB+Alpha asset composition, 6-language i18n, cross-device `localStorage` save sync, desktop & mobile dual adaptation, and headless browser pixel verification. --- ## Installation (30-second setup)