菜单
Use when a CoGames-style game already works visually and mechanically and now needs to be split into a composable variant registry, dependency tree, and optional curriculum tree without regressing the default game.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when designing or repairing a CoGames-style game and the main risk is that the rules, map, roles, or play loop do not yet match the real game or prompt closely enough.
Use when creating a new mettagrid game from scratch and you need the design-first workflow that writes the rules contract, checks engine fit, and hands a clean build plan to `cg.game.build-game`.
Use when a CoGames-style game already works visually and mechanically and now needs to be split into a composable variant registry, dependency tree, and optional curriculum tree without regressing the default game.
Use when implementing or overhauling a CoGames-style game once the target contract is known, including scaffold, registration, mechanics, assets, and variant factoring.
Use when designing or repairing a CoGames-style game and the main risk is that the rules, map, roles, or play loop do not yet match the real game or prompt closely enough.
Use when a CoGames-style game is mechanically working but still has missing, placeholder, wrongly themed, or non-namespaced art, terrain, or atlas entries.
| name | cg.game.variant-tree |
| description | Use when a CoGames-style game already works visually and mechanically and now needs to be split into a composable variant registry, dependency tree, and optional curriculum tree without regressing the default game. |
Factor the finished game into variants only after the default experience is already working. The target is a typed, dependency-closed variant tree whose default path still produces the same game the player just validated.
Announce at start: "I’m using cg.game.variant-tree: I’ll preserve the working game, factor it into a clean variant registry, and prove the default/full paths still agree."
Freeze the baseline first. Start from a game that already passes cg.game.core-mechanics and
cg.game.generate-assets. Do not refactor a broken or placeholder game into variants.
Define the interface and slices. Create one game-local full interface variant plus smaller mechanic or layout
variants with explicit dependencies. Keep the slices meaningful: roles, tasks, meetings, recipe bundles, difficulty,
layout, observability.
Preserve the default game. The zero-variant/default experience should still match the validated full game. Add tests
that compare the default env surface against variants=["full"].
Add dependency and labeling coverage. Follow the patterns from
tests/metta/games/overcooked/test_mechanics_variants.py, tests/metta/games/among_us/test_variants.py, and
tests/metta/games/diplomacy/test_tree_curriculum.py. Verify dependency closure, configured order, deduping, and
that labels only include explicitly requested variants.
Expose the tree deliberately. Keep the registry game-local, and add a tree or curriculum layer only if it helps training or auditing. The tree should be inspectable through tests and CLI surfaces such as:
cogames missions
cogames variants
metta play among_us -- variants=meetings render=none max_steps=200
uv run ./tools/run.py diplomacy.audit episodes=4 num_agents=12 max_steps=220 min_agent_sps=100
full is an interface variant, not an excuse to hide unstructured mechanics.Uses: tr.cogames-variant-debug, t.run-tests, cf.bop-it
Called by: cg.game.build-game, cg.game.new-game
Pairs with: cg.game.core-mechanics, cg.game.generate-assets