⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
ns-game-apple-arm-port
将 Nintendo Switch（NS）游戏适配到 Apple Silicon macOS、iPadOS 和 iOS，以 Rust 原生兼容层与 Metal 为核心，涵盖版本识别、ARM64 离线改写、Horizon 服务、NVN 到 Metal、输入音频、签名部署及实机验收。用于原生移植、跨游戏或版本适配、黑屏花屏卡死排查、移植进度评估；普通模拟器安装配置不属于本 skill。
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
NS 游戏 Apple ARM 原生移植 Skill
面向 AI 编程助手的指令型 skill，用于将 Nintendo Switch 游戏适配到 Apple Silicon macOS、iPadOS 和 iOS。以 Rust 原生兼容层与 Metal 为核心，覆盖版本识别、AArch64 离线改写、Horizon 服务、NVN → Metal、输入音频、部署及实机验收。
安装与使用
将仓库克隆到助手的 skills 目录。例如安装到 Codex：
git clone https://github.com/realskyrin/ns-game-apple-arm-port.git ~/.codex/skills/ns-game-apple-arm-port
重新加载助手后，在目标游戏移植项目中使用：
使用 $ns-game-apple-arm-port 检查当前游戏版本和移植基础，按 Rust 与 Metal 架构先集中完成当前目标内的全量代码修改，再统一测试、集中修复与定向复测，并记录实际运行证据与未验证项。
也可以直接让助手读取 SKILL.md。目标仓库、资源位置与设备由具体任务提供。
默认工作节奏
- 盘点当前目标的已知缺口和依赖，连续完成跨模块实现、调用方与平台配置。
- 修改完成后统一检查、构建、测试和游戏验收，汇总失败；实现期间不逐文件或逐补丁启动测试。
- 按根因集中修复，定向复测失败项和受影响项，再用最终构建确认受影响的游戏路径。
只有缺失关键事实、后续实现无法可靠继续时，才提前执行最小探针。全量修改以当前任务为边界，最终仍需真实运行证据，不将代码完成或构建成功等同于可玩。
内容
- SKILL.md：工作流程、语言架构、诊断与交付要求。
- 架构与推进：Rust 模块边界、版本适配与最短验证路径。
- 执行层与平台：装载、ABI、服务、线程、平台部署与音频。
- 图形与排障：NVN → Metal、纹理一致性、shader 与性能诊断。
- 验收与案例：证据阶梯、记录模板与可迁移经验。
- Codex 元数据：名称、简介与默认提示词。
本仓库提供移植方法与诊断指导，不包含游戏、密钥、固件、兼容层实现或构建产物。游戏资源保持本地；仅交付有权分发的内容。构建、启动、画面、输入、音频与可玩性分别以实际证据验收。
致谢与参考
本 Skill 将本地游戏移植实践整理为通用工作方法。感谢以下项目公开原生执行、兼容层和平台适配的设计与实现；其中经验来源与相关工程参考分别说明如下：
- c22dev/mush8：本 Skill 的 Rust/Cargo 模块划分提炼自基于 mush8 的本地 BOTW 移植实践。mush8 的 ARM64 离线改写、Horizon 宿主、NVN → Metal，以及 macOS 运行时装载与 iOS 构建期链接的分工，是相关架构经验的来源。
- jhaizhou-ops/d2r-mobile：本 Skill 所总结的早期 iPad 移植实践曾参考其原游戏 ARM64 代码改写、宿主服务、离线 shader 转换与 iOS 壳层路线；跨游戏复用的是方法与边界，游戏专用地址、补丁和逻辑仍需独立核实。
- ly05010419/MacNativeGames：作为相关工程参考，展示了用户自备资源、按版本核验模块、原生执行与 Metal 图形适配、独立缓存/存档，以及区分构建检查和真实游戏验收的实践。它与本 Skill 的路线相呼应；当前未确认它是本 Skill 原始编写时的直接来源。
以上致谢说明思路与实践的关联，不表示这些项目为本 Skill 背书，也不表示本仓库包含其运行时代码。
许可证
本仓库的原创 Skill 指令、文档与元数据采用 MIT License。
参考项目及其代码仍遵循各自许可证：mush8 为 GPL v3，d2r-mobile 与 MacNativeGames 为 MIT；其中第三方组件以各项目的许可声明为准。本仓库的 MIT 许可不覆盖这些外部代码或任何游戏程序、资源、密钥及固件。
// HOW IT'S BUILT
KEY FILES