Jakeschincariol/console-skill

项目介绍

这是一个包含 11 个 Claude 技能和纯标准库 Python 工具的技能包，用于把自己拥有的 PlayStation 2 游戏通过静态重编译移植到 PC。它不是模拟器：核心工作由 PS2Recomp 完成，后者把游戏的 MIPS 机器码翻译成 C++ 并编译成本机原生程序。技能包基于早期的 ps2-recomp-Agent-SKILL，把流程拆成逆向、后端、图形、声音、手柄、关卡、物理、存档、Mod、打包和测试等专门任务，让每个技能只加载本任务需要的上下文。

它适合熟悉 Ghidra、C++ 构建和长时间调试的人。README 明确说明，把游戏从「能编译」推进到「能玩」可能需要数周，且 PS2Recomp 仍处于实验阶段：不少游戏尚不能启动，图形和向量单元代码较慢，主机的大量功能仍是桩实现。

快速使用

前置条件：一个自己拥有、可用于转储的 PS2 游戏和 DVD 光驱；已克隆并构建的 PS2Recomp（CMake 3.20+ 和 C++20 编译器）；零售游戏需要带 EmotionEngine Reloaded 扩展的 Ghidra；可选 PCSX2 及 Ghidra、PCSX2 的 MCP 桥接工具。Python 3.8+，无需 pip 安装。

可以把技能作为插件装进 Claude Code：

/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill

或复制目录以获得不带命名空间的命令：

git clone https://github.com/Jakeschincariol/console-skill.git
cp -r console-skill/console-* ~/.claude/skills/

随后从 /console-reverse 开始：它会转储光盘、读取 SYSTEM.CNF 定位启动 ELF、提取并指纹识别、在 Ghidra 中映射函数、生成 PS2Recomp 配置、重编译并构建，并把进度写入 console/STATE.md。典型流程是 /console-reverse → /console-backend 与 /console-tester 循环，直到移植版能启动并游玩，再依次使用图形、声音、手柄、物理、关卡技能，最后用 /console-mod、/console-saves 和 /console-anywhere。也可以直接调用工具，例如：

python3 console-reverse/iso.py boot game.iso
python3 console-tester/run.py boot --runner out/build/ps2xRuntime/ps2EntryRunner --elf console/disc/SLUS_203.12
python3 console-graphics/tim2.py topng console/disc/DATA --out console/textures/png

所有工具都支持 --help，多数支持 --json，共用 0/1/2 退出码。离线测试用 python3 -m unittest discover -s tests -v 在代码内生成的合成样本上运行。

使用约束

• 自带游戏。 只能从自己拥有、在本机转储的光盘出发；技能不会帮忙寻找 ISO、ELF 或 BIOS，PS2Recomp 也不需要 BIOS。
• 游戏内容不外发。 光盘镜像、ELF、纹理、音频、关卡数据和重编译出的 C++ 都留在本机，只应分享补丁、override 和自己原创的资源；/console-anywhere 拒绝打包游戏文件。
• 产物是实验性的。 PS2Recomp 仍在活跃开发中，部分游戏无法成功移植，大型游戏的完整重建可能耗时数小时。
• 平台。 构建支持 Windows、macOS（含 Apple silicon）和 Linux；PS2Recomp 还面向 Android 与 PS Vita。存档只复制不移动，云端同步冲突时保留两份。
• 许可。 技能包本身是 MIT，PS2Recomp 为 GPL-3.0 且不包含在本仓库中。

HotRepo 点评

该仓库目前没有 HotRepo 榜单记录或快照历史，也没有 Hacker News 讨论，以下判断基于 README 与仓库事实。设计相当具体：用 11 个职责明确的技能替代单个大提示词，用共享的状态与设计文档支撑跨多次会话的移植，并提供真实的 Python 工具（ISO/ELF 检查、日志归类、纹理与音频转换、pnach 转换、打包保护）以及 559 个离线测试。项目对边界也写得诚实：不宣称一键移植，并主动提示 PS2Recomp 的实验状态。因此它更像是针对本已困难的逆向移植工作提供的实用流程辅助，而非承诺自动完成的方案。