axiom-games

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Games

游戏开发

You MUST use this skill for ANY game development, SpriteKit, SceneKit, RealityKit, or interactive simulation work.

任何游戏开发、SpriteKit、SceneKit、RealityKit开发或交互式模拟工作都必须使用本技能。

Quick Reference

快速参考

Symptom / Task	Reference
Building a SpriteKit game	See `skills/spritekit.md`
SpriteKit API lookup	See `skills/spritekit-ref.md`
Physics contacts not firing	See `skills/spritekit-diag.md`
Frame rate drops (SpriteKit)	See `skills/spritekit-diag.md`
Touches not registering	See `skills/spritekit-diag.md`
Memory spikes in gameplay	See `skills/spritekit-diag.md`
Coordinate confusion	See `skills/spritekit-diag.md`
Scene transition crashes	See `skills/spritekit-diag.md`
Objects tunneling through walls	See `skills/spritekit-diag.md`
SpriteKit node/action reference	See `skills/spritekit-ref.md`
SceneKit maintenance/migration	See axiom-graphics (skills/scenekit.md)
SceneKit API / migration mapping	See axiom-graphics (skills/scenekit-ref.md)
RealityKit (3D, ECS, AR)	See axiom-graphics (skills/realitykit.md)
RealityKit API reference	See axiom-graphics (skills/realitykit-ref.md)
RealityKit diagnostics	See axiom-graphics (skills/realitykit-diag.md)

问题/任务	参考文档
开发SpriteKit游戏	查看 `skills/spritekit.md`
SpriteKit API查询	查看 `skills/spritekit-ref.md`
物理碰撞未触发	查看 `skills/spritekit-diag.md`
帧率下降（SpriteKit）	查看 `skills/spritekit-diag.md`
触摸未被识别	查看 `skills/spritekit-diag.md`
游戏过程中内存骤增	查看 `skills/spritekit-diag.md`
坐标系混淆	查看 `skills/spritekit-diag.md`
场景切换崩溃	查看 `skills/spritekit-diag.md`
对象穿墙（隧穿）	查看 `skills/spritekit-diag.md`
SpriteKit节点/动作参考	查看 `skills/spritekit-ref.md`
SceneKit维护/迁移	查看 axiom-graphics（skills/scenekit.md）
SceneKit API / 迁移映射	查看 axiom-graphics（skills/scenekit-ref.md）
RealityKit（3D、ECS、AR）	查看 axiom-graphics（skills/realitykit.md）
RealityKit API参考	查看 axiom-graphics（skills/realitykit-ref.md）
RealityKit诊断	查看 axiom-graphics（skills/realitykit-diag.md）

External Routes

外部指引

These topics are part of the broader games/3D domain but live in separate skill suites:

SceneKit (3D — soft-deprecated iOS 26):

Maintenance and migration planning → See axiom-graphics (skills/scenekit.md)
API reference and migration mapping → See axiom-graphics (skills/scenekit-ref.md)

RealityKit (3D — modern):

ECS architecture, AR, SwiftUI integration → See axiom-graphics (skills/realitykit.md)
API reference → See axiom-graphics (skills/realitykit-ref.md)
Troubleshooting → See axiom-graphics (skills/realitykit-diag.md)

以下主题属于广义游戏/3D领域，但位于独立的技能套件中：

SceneKit（3D — iOS 26起软废弃）：

维护与迁移规划 → 查看 axiom-graphics（skills/scenekit.md）
API参考与迁移映射 → 查看 axiom-graphics（skills/scenekit-ref.md）

RealityKit（3D — 现代框架）：

ECS架构、AR、SwiftUI集成 → 查看 axiom-graphics（skills/realitykit.md）
API参考 → 查看 axiom-graphics（skills/realitykit-ref.md）
故障排查 → 查看 axiom-graphics（skills/realitykit-diag.md）

Decision Tree

决策树

dot

digraph games {
    start [label="Game development" shape=ellipse];
    what [label="Which framework?" shape=diamond];
    sprite_what [label="SpriteKit need?" shape=diamond];

    start -> what;
    what -> sprite_what [label="SpriteKit (2D)"];
    what -> "axiom-graphics/scenekit" [label="SceneKit (3D legacy)"];
    what -> "axiom-graphics/realitykit" [label="RealityKit (3D modern)"];

    sprite_what -> "skills/spritekit.md" [label="architecture/patterns"];
    sprite_what -> "skills/spritekit-ref.md" [label="API lookup"];
    sprite_what -> "skills/spritekit-diag.md" [label="broken/slow"];
}

Building/designing a 2D SpriteKit game? →
```
skills/spritekit.md
```
How to use a specific SpriteKit API? →
```
skills/spritekit-ref.md
```
SpriteKit broken or performing badly? →
```
skills/spritekit-diag.md
```
Maintaining existing SceneKit code? → See axiom-graphics (skills/scenekit.md)
SceneKit API reference or migration mapping? → See axiom-graphics (skills/scenekit-ref.md)
Building new 3D game or experience? → See axiom-graphics (skills/realitykit.md)
How to use a specific RealityKit API? → See axiom-graphics (skills/realitykit-ref.md)
RealityKit entity not visible, gestures broken, performance? → See axiom-graphics (skills/realitykit-diag.md)
Migrating SceneKit to RealityKit? → See axiom-graphics (skills/scenekit.md) (migration tree) + See axiom-graphics (skills/scenekit-ref.md) (mapping table)
Building AR game? → See axiom-graphics (skills/realitykit.md)
Want automated SpriteKit code scan? →
```
spritekit-auditor
```
agent

dot

digraph games {
    start [label="Game development" shape=ellipse];
    what [label="Which framework?" shape=diamond];
    sprite_what [label="SpriteKit need?" shape=diamond];

    start -> what;
    what -> sprite_what [label="SpriteKit (2D)"];
    what -> "axiom-graphics/scenekit" [label="SceneKit (3D legacy)"];
    what -> "axiom-graphics/realitykit" [label="RealityKit (3D modern)"];

    sprite_what -> "skills/spritekit.md" [label="architecture/patterns"];
    sprite_what -> "skills/spritekit-ref.md" [label="API lookup"];
    sprite_what -> "skills/spritekit-diag.md" [label="broken/slow"];
}

开发/设计2D SpriteKit游戏？ →
```
skills/spritekit.md
```
如何使用特定SpriteKit API？ →
```
skills/spritekit-ref.md
```
SpriteKit出现故障或性能不佳？ →
```
skills/spritekit-diag.md
```
维护现有SceneKit代码？ → 查看 axiom-graphics（skills/scenekit.md）
SceneKit API参考或迁移映射？ → 查看 axiom-graphics（skills/scenekit-ref.md）
开发新3D游戏或体验？ → 查看 axiom-graphics（skills/realitykit.md）
如何使用特定RealityKit API？ → 查看 axiom-graphics（skills/realitykit-ref.md）
RealityKit实体不可见、手势失效、性能问题？ → 查看 axiom-graphics（skills/realitykit-diag.md）
从SceneKit迁移到RealityKit？ → 查看 axiom-graphics（skills/scenekit.md）（迁移决策树） + 查看 axiom-graphics（skills/scenekit-ref.md）（映射表）
开发AR游戏？ → 查看 axiom-graphics（skills/realitykit.md）
需要自动扫描SpriteKit代码？ →
```
spritekit-auditor
```
Agent

Automated Scanning

自动扫描

SpriteKit audit → Launch

spritekit-auditor

agent or

/axiom:audit spritekit

Physics bitmask issues
Draw call waste (SKShapeNode in gameplay)
Node accumulation (missing cleanup)
Action memory leaks (strong self)
Coordinate confusion
Touch handling issues
Missing object pooling
Missing debug overlays

SpriteKit审计 → 启动

spritekit-auditor

Agent 或执行

/axiom:audit spritekit

物理位掩码问题
绘制调用浪费（游戏中使用SKShapeNode）
节点堆积（未清理）
动作内存泄漏（强引用self）
坐标系混淆
触摸处理问题
缺少对象池
缺少调试覆盖层

Critical Patterns

关键模式

SpriteKit (

skills/spritekit.md

PhysicsCategory struct with explicit bitmasks (default
```
0xFFFFFFFF
```
causes phantom collisions)
Camera node pattern for viewport + HUD separation
SKShapeNode pre-render-to-texture conversion
```
[weak self]
```
in all
```
SKAction.run
```
closures
Delta time with spiral-of-death clamping

SpriteKit diagnostics (

skills/spritekit-diag.md

5-step bitmask checklist (2 min vs 30-120 min guessing)
Debug overlays as mandatory first diagnostic step
Tunneling prevention flowchart
Memory growth diagnosis via
```
showsNodeCount
```
trending

SpriteKit（

skills/spritekit.md

）：

带显式位掩码的PhysicsCategory结构体（默认
```
0xFFFFFFFF
```
会导致虚假碰撞）
用于视口+HUD分离的Camera节点模式
SKShapeNode预渲染为纹理的转换
所有
```
SKAction.run
```
闭包中使用
```
[weak self]
```
带“死亡螺旋”钳制的增量时间

SpriteKit诊断（

skills/spritekit-diag.md

）：

5步位掩码检查清单（2分钟排查 vs 30-120分钟猜测）
将调试覆盖层作为诊断的强制第一步
隧穿预防流程图
通过
```
showsNodeCount
```
趋势分析诊断内存增长

Anti-Rationalization

误区纠正

Thought	Reality
"SpriteKit is simple, I don't need a skill"	Physics bitmasks default to 0xFFFFFFFF and cause phantom collisions. The bitmask checklist catches this in 2 min.
"I'll just use SKShapeNode, it's quick"	Each SKShapeNode is a separate draw call. 50 of them = 50 draw calls. spritekit.md has the pre-render-to-texture pattern.
"I can figure out the coordinate system"	SpriteKit uses bottom-left origin (opposite of UIKit). Anchor points add another layer. spritekit-diag.md Symptom 6 resolves in 5 min.
"Physics is straightforward"	Three different bitmask properties, modification rules inside callbacks, and tunneling edge cases. spritekit.md Section 3 covers all gotchas.
"The performance is fine on my device"	Performance varies dramatically across devices. spritekit.md Section 6 has the debug overlay checklist.
"SceneKit is fine for our new project"	SceneKit is soft-deprecated iOS 26. No new features, only security patches. axiom-scenekit has the migration decision tree.
"ECS is overkill for a simple 3D app"	You're already using ECS — Entity + ModelComponent. axiom-realitykit shows how to scale from simple to complex.
"I don't need collision shapes for taps"	RealityKit gestures require CollisionComponent. axiom-realitykit-diag diagnoses this in 2 min vs 30 min guessing.

错误想法	实际情况
"SpriteKit很简单，我不需要这个技能"	物理位掩码默认值为0xFFFFFFFF，会导致虚假碰撞。位掩码检查清单可在2分钟内发现问题。
"我直接用SKShapeNode就行，很快"	每个SKShapeNode都是独立的绘制调用。50个节点就等于50次绘制调用。spritekit.md中有预渲染为纹理的模式。
"我能搞清楚坐标系"	SpriteKit使用左下角原点（与UIKit相反），锚点又增加了一层复杂度。spritekit-diag.md中的问题6可在5分钟内解决。
"物理系统很简单"	有三种不同的位掩码属性、回调内的修改规则以及隧穿边缘情况。spritekit.md第3节涵盖了所有陷阱。
"我的设备上性能没问题"	不同设备间性能差异极大。spritekit.md第6节有调试覆盖层检查清单。
"SceneKit对我们的新项目来说足够了"	SceneKit从iOS 26起软废弃，不再添加新功能，仅提供安全补丁。axiom-scenekit中有迁移决策树。
"ECS对简单3D应用来说太冗余了"	你其实已经在使用ECS——Entity + ModelComponent。axiom-realitykit展示了如何从简单扩展到复杂场景。
"点击不需要碰撞形状"	RealityKit手势需要CollisionComponent。axiom-realitykit-diag可在2分钟内诊断此问题，而非耗时30分钟猜测。

Example Invocations

调用示例

User: "I'm building a SpriteKit game" → See

skills/spritekit.md

User: "My physics contacts aren't firing" → See

skills/spritekit-diag.md

User: "How do I create a physics body from a texture?" → See

skills/spritekit-ref.md

User: "Frame rate is dropping in my game" → See

skills/spritekit-diag.md

User: "What action types are available?" → See

skills/spritekit-ref.md

User: "Objects pass through walls" → See

skills/spritekit-diag.md

User: "I need to build a 3D game" → Invoke: See axiom-graphics (skills/realitykit.md)

User: "I'm migrating from SceneKit to RealityKit" → Invoke: See axiom-graphics (skills/scenekit.md) + See axiom-graphics (skills/scenekit-ref.md)

User: "Can you scan my SpriteKit code for common issues?" → Launch

spritekit-auditor

agent

用户："我正在开发SpriteKit游戏" → 查看

skills/spritekit.md

用户："我的物理碰撞没触发" → 查看

skills/spritekit-diag.md

用户："如何从纹理创建物理体？" → 查看

skills/spritekit-ref.md

用户："我的游戏帧率下降了" → 查看

skills/spritekit-diag.md

用户："有哪些可用的动作类型？" → 查看

skills/spritekit-ref.md

用户："对象穿墙了" → 查看

skills/spritekit-diag.md

用户："我需要开发3D游戏" → 调用：查看 axiom-graphics（skills/realitykit.md）

用户："我要从SceneKit迁移到RealityKit" → 调用：查看 axiom-graphics（skills/scenekit.md） + 查看 axiom-graphics（skills/scenekit-ref.md）

用户："你能帮我扫描SpriteKit代码中的常见问题吗？" → 启动

spritekit-auditor

Agent