game-transform-systems
Design and debug game transform systems, coordinate spaces, local/world/view/projection matrices, homogeneous coordinates, camera constraints, and inverse transforms. Use when implementing object transforms, camera math, parent-child transforms, projection/unprojection, or coordinate-space conversions.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- game-transform-systems
- license
- MIT
- metadata
- { "tags": "game-dev,game-geometry,transforms,cameras,coordinate-systems", "version": "0.1.0", "category": "Game Development", "displayName": "Game Transform Systems" }
- description
- Design and debug game transform systems, coordinate spaces, local/world/view/projection matrices, homogeneous coordinates, camera constraints, and inverse transforms. Use when implementing object transforms, camera math, parent-child transforms, projection/unprojection, or coordinate-space conversions.
- compatibility
- Codex, Claude Code, and other Agent Skills-compatible clients.
03 SKILL.md 正文
Game Transform Systems
Use this skill to make transform code explicit, composable, testable, and consistent across gameplay, rendering, physics, and tools.
Primary source: Geometry for Programmers by Oleksandr Kaleniuk (https://www.manning.com/books/geometry-for-programmers), transformed and paraphrased, especially chapter 4. Additional source: Khronos glTF 2.0 specification transform and coordinate-system conventions (https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html).
Core Workflow
- List every coordinate space involved: model, local, parent, world, view, clip, screen, texture, grid, or field space.
- Define conventions once: handedness, up axis, units, row/column vectors, matrix memory layout, multiplication order, angle units, and quaternion order.
- Name transforms by direction, such as
local_to_worldandworld_to_view. - Compose transforms in one place and cache composed matrices when reused.
- Use inverse transforms to move queries into simpler spaces, especially for picking, SDFs, fields, and object-local collision.
- Keep camera construction explicit: position, target or forward vector, up vector, field of view, aspect ratio, near/far planes.
- Verify with round-trip tests and debug axes before tuning gameplay behavior.
Design Rules
- Treat transforms as first-class data, not hidden side effects in helper methods.
- Prefer one canonical transform chain for rendering and gameplay. Add adapters at engine or asset boundaries.
- Use homogeneous coordinates when translation, projection, and matrix composition must live in one pipeline.
- Use affine transforms for ordinary rotation, translation, scale, and shear.
- Use projective transforms when perspective, projection, or planar warping is part of the problem.
- Apply the inverse transform to an SDF or field input instead of rewriting the field's formula for every object transform.
- Transform normals with the inverse transpose when nonuniform scale or shear is possible.
Camera And Projection Checks
- A camera needs enough constraints to define orientation. A position and target still leave roll ambiguous without an up/right/down vector or equivalent.
- Near and far planes should fit the playable range; sloppy values harm depth precision.
- Projection and unprojection should be tested with known points at screen center, viewport corners, near plane, and far plane.
- Screen-space y direction and pixel-center conventions must be documented for picking and UI/game interaction.
Transform Debug Checklist
- Draw local axes for selected objects.
- Draw camera frustum and near/far planes.
- Log transform direction in variable names.
- Assert matrices are finite before submitting to rendering or physics.
- Test identity, translation-only, rotation-only, scale-only, parent-child, and inverse round trips.
- Test nonuniform scale if normals, collision, or child transforms are affected.
Common Mistakes
- Mixing row-major memory layout with row-vector math assumptions.
- Multiplying transforms in a plausible but wrong order.
- Recomputing inverse matrices inside tight per-point loops.
- Forgetting that
w = 0represents a direction in homogeneous coordinates, whilew = 1represents a point. - Applying object transforms to an SDF output instead of inverse-transforming the query point.
- Fixing a camera roll bug by changing asset orientation instead of camera constraints.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.