build-game-changelog
Design, implement, backfill, audit, and release in-game changelogs with contiguous versioning, deployment provenance, menu-state navigation, accessible toggle, close, and Escape behavior, and responsive release-ledger UI. Use when Codex needs to add or revise a changelog or version screen in a game, reconstruct release history from deployments and Git, define version-bump rules, keep displayed versions synchronized with live builds, or test changelog mechanics across desktop and mobile.
MengTo · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add MengTo/Skills --skill build-game-changelog技能说明
name: build-game-changelog description: Design, implement, backfill, audit, and release in-game changelogs with contiguous versioning, deployment provenance, menu-state navigation, accessible toggle, close, and Escape behavior, and responsive release-ledger UI. Use when Codex needs to add or revise a changelog or version screen in a game, reconstruct release history from deployments and Git, define version-bump rules, keep displayed versions synchronized with live builds, or test changelog mechanics across desktop and mobile.
Build Game Changelog
Build the changelog as a release system, not a decorative modal. Keep one authoritative ledger connected to production history, game-menu navigation, and release verification.
Use this mental model
- The ledger is the public record of what players received.
- A version identifies a successful production release, not a development commit.
- The newest ledger entry defines the version shown throughout the game.
- Opening the changelog is a reversible menu-state transition.
- Every close affordance resolves through the same back action.
- A release is complete only after the live game proves the expected version and behavior.
Start from truth
Inspect before editing:
- Read repository instructions and preserve unrelated work.
- Find the game’s menu or pause state machine, back action, input bindings, focus behavior, and responsive layout.
- Find every displayed version, package version, build version, deployment sequence, release manifest, and existing changelog.
- Query successful production deployments and their source revisions when available.
- Compare deployment revisions to identify what players actually received.
Prefer repository, deployment, and live-runtime evidence over chat summaries or commit-message guesses. Do not invent missing release dates, source revisions, features, or version mappings.
Define one release
Treat one successful player-visible production deployment as one changelog version.
- Do not bump for local commits, drafts, tests, failed builds, or saved-but-unpublished artifacts.
- Combine multiple commits shipped together into one version with several release notes.
- Give a separately deployed hotfix its own version.
- Describe player-visible outcomes, not implementation chores or raw commit messages.
- Keep internal source and deployment identifiers in ledger metadata, not player-facing copy.
Retain an established version scheme. For a new pre-1.0 game without one, default to 0.9.0 and increment the patch once per production release: 0.9.1, 0.9.2, and so on. Do not jump to a new minor or major version without an explicit product milestone.
Build or backfill the ledger
Work oldest-to-newest when reconstructing history, then store entries newest-first for rendering.
- Enumerate successful production releases.
- Associate each release with its date, deployed source revision, and deployment identifier.
- Diff each source revision against the previous production revision.
- Summarize the user-visible changes in that release.
- Use the first production baseline as
0.9.0when adopting the default scheme. - Consolidate meaningful launch work into the baseline if it predates deployment tracking.
- Verify the ledger count, ordering, uniqueness, and version continuity.
If evidence is incomplete, mark provenance unknown in internal metadata or stop for clarification. Never fabricate a neat history.
Use one data source
Keep changelog content in typed or schema-validated structured data. Give each entry:
- version
- release date
- short release title
- one or more player-facing details
- deployment version or release identifier when available
- exact source revision when available
Derive the displayed current version from the newest ledger entry. Do not maintain a second hand-written version constant.
Store an explicit mapping between game versions and deployment versions. Only use a formula such as patch = deploymentOrdinal - 1 when the project guarantees it and tests it.
Avoid self-referential source metadata. A commit cannot contain its own final hash. Either:
- keep the newest inline entry’s source revision pending and backfill it during the next release;
- inject the exact revision at build time; or
- store immutable release provenance outside the source commit.
See references/reference-architecture.md when implementing the schema, state machine, or tests.
Integrate with game navigation
Make the changelog an explicit menu route or screen state. Use an overlay only when the game’s existing menu architecture uses overlays.
- Record the previous menu screen before opening.
- Make the version control a toggle: closed opens the changelog; open returns to the previous screen.
- Route the header toggle, visible X, bottom Back action, controller cancel, and Escape through one close or back function.
- Use the game’s authoritative input-binding layer instead of adding a competing global Escape listener.
- Respect higher-priority input consumers such as dialogs, drag operations, rebinding flows, and text fields.
- Ignore repeated input and blocked transition states when the menu already does so.
- Preserve the previous pause state when the changelog can open over gameplay.
On open, focus the close control or panel heading. On close, restore focus to the trigger when practical. Never strand keyboard or controller focus inside an unmounted panel.
Apply durable UI mechanics
Fit the existing game UI rather than introducing a new visual language.
- Place the changelog control with stable menu utilities such as sound, settings, or account controls.
- Show the current version inside the control.
- Keep a visible close X in the panel header and give it an accessible name.
- Keep the current-version marker and close control visible while the release list scrolls independently.
- Render releases newest-first with semantic headin