@playcraft/skills 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +333 -0
- package/dist/src/index.d.ts +3 -0
- package/dist/src/index.d.ts.map +1 -0
- package/dist/src/index.js +2 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/skills.loader.d.ts +31 -0
- package/dist/src/skills.loader.d.ts.map +1 -0
- package/dist/src/skills.loader.js +200 -0
- package/dist/src/skills.loader.js.map +1 -0
- package/dist/src/skills.types.d.ts +44 -0
- package/dist/src/skills.types.d.ts.map +1 -0
- package/dist/src/skills.types.js +9 -0
- package/dist/src/skills.types.js.map +1 -0
- package/package.json +35 -0
- package/skills/2048_core.aigameplay/SKILL.md +123 -0
- package/skills/2048_core.aigameplay/manifest.json +159 -0
- package/skills/2048_core.aigameplay/ref/pgs-schema.json +194 -0
- package/skills/2048_core.aigameplay/ref/reducer.template.ts +189 -0
- package/skills/SKILL.md +46 -0
- package/skills/ad_compliance_rules.aiconfig/SKILL.md +85 -0
- package/skills/ad_compliance_rules.aiconfig/manifest.json +60 -0
- package/skills/agent_remix_orchestrator.aicomponent/SKILL.md +257 -0
- package/skills/agent_remix_orchestrator.aicomponent/manifest.json +12 -0
- package/skills/app_metadata.aiconfig/SKILL.md +53 -0
- package/skills/app_metadata.aiconfig/manifest.json +32 -0
- package/skills/appear_sfx.aiaudio/SKILL.md +59 -0
- package/skills/appear_sfx.aiaudio/manifest.json +45 -0
- package/skills/appear_sfx.aiaudio/ref/appear.mp3 +0 -0
- package/skills/arrow_move_error_sfx.aiaudio/SKILL.md +59 -0
- package/skills/arrow_move_error_sfx.aiaudio/manifest.json +45 -0
- package/skills/arrow_move_error_sfx.aiaudio/ref/arrow_move_error.mp3 +0 -0
- package/skills/arrow_path_data_format.aicomponent/SKILL.md +152 -0
- package/skills/arrow_path_data_format.aicomponent/manifest.json +57 -0
- package/skills/arrow_path_data_format.aicomponent/ref/LevelParser.ts +188 -0
- package/skills/arrow_path_data_format.aicomponent/ref/LevelTypes.ts +131 -0
- package/skills/arrow_pick_match_rules.aigameplay/SKILL.md +117 -0
- package/skills/arrow_pick_match_rules.aigameplay/manifest.json +105 -0
- package/skills/arrow_pick_match_rules.aigameplay/ref/pgs-schema.json +180 -0
- package/skills/asset_pipeline_scripts.aicomponent/SKILL.md +117 -0
- package/skills/asset_pipeline_scripts.aicomponent/manifest.json +17 -0
- package/skills/asset_pipeline_scripts.aicomponent/ref/gen-sprite.sh +105 -0
- package/skills/ball_sort.aigameplay/SKILL.md +109 -0
- package/skills/ball_sort.aigameplay/manifest.json +155 -0
- package/skills/ball_sort.aigameplay/ref/pgs-schema.json +192 -0
- package/skills/ball_sort.aigameplay/ref/reducer.template.ts +156 -0
- package/skills/basketball_shot.aigameplay/SKILL.md +94 -0
- package/skills/basketball_shot.aigameplay/manifest.json +150 -0
- package/skills/basketball_shot.aigameplay/ref/pgs-schema.json +229 -0
- package/skills/basketball_shot.aigameplay/ref/reducer.template.ts +189 -0
- package/skills/bg_music.aiaudio/SKILL.md +61 -0
- package/skills/bg_music.aiaudio/manifest.json +48 -0
- package/skills/bg_music.aiaudio/ref/bg.mp3 +0 -0
- package/skills/big_watermelon.aigameplay/SKILL.md +94 -0
- package/skills/big_watermelon.aigameplay/manifest.json +155 -0
- package/skills/big_watermelon.aigameplay/ref/pgs-schema.json +191 -0
- package/skills/big_watermelon.aigameplay/ref/reducer.template.ts +202 -0
- package/skills/block_puzzle.aigameplay/SKILL.md +121 -0
- package/skills/block_puzzle.aigameplay/manifest.json +154 -0
- package/skills/block_puzzle.aigameplay/ref/pgs-schema.json +170 -0
- package/skills/block_puzzle.aigameplay/ref/reducer.template.ts +182 -0
- package/skills/board_entity_sprite.aiimage/SKILL.md +255 -0
- package/skills/board_entity_sprite.aiimage/manifest.json +153 -0
- package/skills/board_entity_sprite.aiimage/ref/ProceduralCar.ts +357 -0
- package/skills/board_entity_sprite.aiimage/ref/car.png +0 -0
- package/skills/board_entity_sprite.aiimage/ref/car.webp +0 -0
- package/skills/bottom_ui_bar.aicomponent/SKILL.md +50 -0
- package/skills/bottom_ui_bar.aicomponent/manifest.json +31 -0
- package/skills/bottom_ui_bar.aicomponent/ref/GameBottomUI.ts +27 -0
- package/skills/bubble_shooter.aigameplay/SKILL.md +129 -0
- package/skills/bubble_shooter.aigameplay/manifest.json +181 -0
- package/skills/bubble_shooter.aigameplay/ref/pgs-schema.json +226 -0
- package/skills/bubble_shooter.aigameplay/ref/reducer.template.ts +228 -0
- package/skills/button_click_sfx.aiaudio/SKILL.md +59 -0
- package/skills/button_click_sfx.aiaudio/manifest.json +45 -0
- package/skills/button_click_sfx.aiaudio/ref/button_click.mp3 +0 -0
- package/skills/calm_piano.aiaudio/SKILL.md +68 -0
- package/skills/calm_piano.aiaudio/manifest.json +50 -0
- package/skills/camera_controller_3d.aicomponent/SKILL.md +100 -0
- package/skills/camera_controller_3d.aicomponent/manifest.json +52 -0
- package/skills/camera_controller_3d.aicomponent/ref/CameraController.ts +199 -0
- package/skills/camera_controller_3d.aicomponent/ref/OrbitControlsAdapter.ts +152 -0
- package/skills/candy_tile.aiimage/SKILL.md +62 -0
- package/skills/candy_tile.aiimage/manifest.json +49 -0
- package/skills/car_parking.aigameplay/SKILL.md +105 -0
- package/skills/car_parking.aigameplay/manifest.json +164 -0
- package/skills/car_parking.aigameplay/ref/pgs-schema.json +163 -0
- package/skills/car_parking.aigameplay/ref/reducer.template.ts +166 -0
- package/skills/castle.aiimage/SKILL.md +64 -0
- package/skills/castle.aiimage/manifest.json +48 -0
- package/skills/cheerful_ukulele.aiaudio/SKILL.md +72 -0
- package/skills/cheerful_ukulele.aiaudio/manifest.json +50 -0
- package/skills/click_sfx.aiaudio/SKILL.md +59 -0
- package/skills/click_sfx.aiaudio/manifest.json +45 -0
- package/skills/click_sfx.aiaudio/ref/click.mp3 +0 -0
- package/skills/combo_display.aicomponent/SKILL.md +45 -0
- package/skills/combo_display.aicomponent/manifest.json +31 -0
- package/skills/combo_display.aicomponent/ref/ComboManager.ts +362 -0
- package/skills/combo_display.aicomponent/ref/ComboSmallUI.ts +232 -0
- package/skills/combo_praise_text.aicomponent/SKILL.md +56 -0
- package/skills/combo_praise_text.aicomponent/manifest.json +34 -0
- package/skills/combo_praise_text.aicomponent/ref/ComboManager.ts +362 -0
- package/skills/countdown_timer.aicomponent/SKILL.md +44 -0
- package/skills/countdown_timer.aicomponent/manifest.json +35 -0
- package/skills/countdown_timer.aicomponent/ref/CountdownDisplay.ts +213 -0
- package/skills/cta_platform_config.aiconfig/SKILL.md +72 -0
- package/skills/cta_platform_config.aiconfig/manifest.json +56 -0
- package/skills/debug_overlay.aicomponent/SKILL.md +75 -0
- package/skills/debug_overlay.aicomponent/manifest.json +17 -0
- package/skills/debug_overlay.aicomponent/ref/DebugOverlay.ts +144 -0
- package/skills/desert.aiimage/SKILL.md +63 -0
- package/skills/desert.aiimage/manifest.json +49 -0
- package/skills/difficulty_curve_designer.aiconfig/SKILL.md +68 -0
- package/skills/difficulty_curve_designer.aiconfig/manifest.json +36 -0
- package/skills/digit_renderer.aicomponent/SKILL.md +43 -0
- package/skills/digit_renderer.aicomponent/manifest.json +25 -0
- package/skills/digit_renderer.aicomponent/ref/DigitRenderer.ts +237 -0
- package/skills/download_button.aicomponent/SKILL.md +44 -0
- package/skills/download_button.aicomponent/manifest.json +25 -0
- package/skills/download_button.aicomponent/ref/DownloadButton.ts +137 -0
- package/skills/draw_line_puzzle.aigameplay/SKILL.md +84 -0
- package/skills/draw_line_puzzle.aigameplay/manifest.json +152 -0
- package/skills/draw_line_puzzle.aigameplay/ref/pgs-schema.json +189 -0
- package/skills/draw_line_puzzle.aigameplay/ref/reducer.template.ts +194 -0
- package/skills/easy_to_hard.aiconfig/SKILL.md +52 -0
- package/skills/easy_to_hard.aiconfig/manifest.json +33 -0
- package/skills/eight_ball_pool.aigameplay/SKILL.md +104 -0
- package/skills/eight_ball_pool.aigameplay/manifest.json +152 -0
- package/skills/eight_ball_pool.aigameplay/ref/pgs-schema.json +205 -0
- package/skills/eight_ball_pool.aigameplay/ref/reducer.template.ts +198 -0
- package/skills/energetic_electronic.aiaudio/SKILL.md +69 -0
- package/skills/energetic_electronic.aiaudio/manifest.json +51 -0
- package/skills/fail_sfx.aiaudio/SKILL.md +59 -0
- package/skills/fail_sfx.aiaudio/manifest.json +44 -0
- package/skills/fail_sfx.aiaudio/ref/fail.mp3 +0 -0
- package/skills/figer_icon.aiimage/SKILL.md +58 -0
- package/skills/figer_icon.aiimage/manifest.json +48 -0
- package/skills/figer_icon.aiimage/ref/figer.png +0 -0
- package/skills/figer_icon.aiimage/ref/figer.webp +0 -0
- package/skills/forest.aiimage/SKILL.md +74 -0
- package/skills/forest.aiimage/manifest.json +48 -0
- package/skills/fruit_tile.aiimage/SKILL.md +68 -0
- package/skills/fruit_tile.aiimage/manifest.json +48 -0
- package/skills/game_over_panel.aicomponent/SKILL.md +47 -0
- package/skills/game_over_panel.aicomponent/manifest.json +61 -0
- package/skills/game_over_panel.aicomponent/ref/GameOverPanel.ts +74 -0
- package/skills/game_scene.aicomponent/SKILL.md +57 -0
- package/skills/game_scene.aicomponent/manifest.json +36 -0
- package/skills/game_scene.aicomponent/ref/Game.ts +748 -0
- package/skills/gameplay_balance_check.aivalidator/SKILL.md +69 -0
- package/skills/gameplay_balance_check.aivalidator/manifest.json +21 -0
- package/skills/gameplay_unit_test.aivalidator/SKILL.md +89 -0
- package/skills/gameplay_unit_test.aivalidator/manifest.json +17 -0
- package/skills/gameplay_unit_test.aivalidator/ref/gameplay.test.ts +202 -0
- package/skills/gameplay_unit_test.aivalidator/ref/vitest.config.ts +13 -0
- package/skills/grid_board_layout.aicomponent/SKILL.md +85 -0
- package/skills/grid_board_layout.aicomponent/manifest.json +69 -0
- package/skills/grid_board_layout.aicomponent/ref/BoardLayout.ts +416 -0
- package/skills/grid_board_layout.aicomponent/ref/BoardLayout3D.ts +125 -0
- package/skills/grid_board_layout.aicomponent/ref/BoardLayoutMath.ts +85 -0
- package/skills/grid_board_layout.aicomponent/ref/BoardRenderer3D.ts +298 -0
- package/skills/heart_lives.aicomponent/SKILL.md +42 -0
- package/skills/heart_lives.aicomponent/manifest.json +25 -0
- package/skills/heart_lives.aicomponent/ref/HeartDisplay.ts +96 -0
- package/skills/idle-breathe.aicomponent/SKILL.md +27 -0
- package/skills/idle-breathe.aicomponent/manifest.json +20 -0
- package/skills/idle-breathe.aicomponent/ref/phaser.js +25 -0
- package/skills/idle-breathe.aicomponent/ref/playcanvas.js +29 -0
- package/skills/jewel_tile.aiimage/SKILL.md +63 -0
- package/skills/jewel_tile.aiimage/manifest.json +49 -0
- package/skills/knife_hit.aigameplay/SKILL.md +103 -0
- package/skills/knife_hit.aigameplay/manifest.json +151 -0
- package/skills/knife_hit.aigameplay/ref/pgs-schema.json +202 -0
- package/skills/knife_hit.aigameplay/ref/reducer.template.ts +196 -0
- package/skills/left_right_parkour.aigameplay/SKILL.md +120 -0
- package/skills/left_right_parkour.aigameplay/manifest.json +165 -0
- package/skills/left_right_parkour.aigameplay/ref/pgs-schema.json +200 -0
- package/skills/left_right_parkour.aigameplay/ref/reducer.template.ts +194 -0
- package/skills/level_data_pack.aiconfig/SKILL.md +64 -0
- package/skills/level_data_pack.aiconfig/manifest.json +37 -0
- package/skills/level_data_validator.aivalidator/SKILL.md +85 -0
- package/skills/level_data_validator.aivalidator/manifest.json +17 -0
- package/skills/level_data_validator.aivalidator/ref/LevelValidator.ts +113 -0
- package/skills/level_lifecycle.aicomponent/SKILL.md +81 -0
- package/skills/level_lifecycle.aicomponent/manifest.json +87 -0
- package/skills/level_lifecycle.aicomponent/ref/LevelLifecycle.ts +235 -0
- package/skills/level_solvability_validator.aivalidator/SKILL.md +74 -0
- package/skills/level_solvability_validator.aivalidator/manifest.json +23 -0
- package/skills/level_solvability_validator.aivalidator/ref/LevelValidator.ts +186 -0
- package/skills/level_state.aicomponent/SKILL.md +55 -0
- package/skills/level_state.aicomponent/manifest.json +34 -0
- package/skills/level_state.aicomponent/ref/LevelDataManager.ts +26 -0
- package/skills/level_state.aicomponent/ref/LevelManager.ts +26 -0
- package/skills/loading_screen.aicomponent/SKILL.md +57 -0
- package/skills/loading_screen.aicomponent/manifest.json +43 -0
- package/skills/loading_screen.aicomponent/ref/LoadingUI.ts +339 -0
- package/skills/lose_result_panel.aiimage/SKILL.md +58 -0
- package/skills/lose_result_panel.aiimage/manifest.json +47 -0
- package/skills/lose_result_panel.aiimage/ref/lose.png +0 -0
- package/skills/lose_result_panel.aiimage/ref/lose.webp +0 -0
- package/skills/lose_sfx.aiaudio/SKILL.md +59 -0
- package/skills/lose_sfx.aiaudio/manifest.json +45 -0
- package/skills/lose_sfx.aiaudio/ref/lose.mp3 +0 -0
- package/skills/match-pop.aicomponent/SKILL.md +29 -0
- package/skills/match-pop.aicomponent/manifest.json +19 -0
- package/skills/match-pop.aicomponent/ref/phaser.js +30 -0
- package/skills/match-pop.aicomponent/ref/playcanvas.js +22 -0
- package/skills/match3_core.aigameplay/SKILL.md +125 -0
- package/skills/match3_core.aigameplay/manifest.json +107 -0
- package/skills/match3_core.aigameplay/ref/pgs-schema.json +154 -0
- package/skills/match3_core.aigameplay/ref/reducer.template.ts +191 -0
- package/skills/match_engine.aicomponent/SKILL.md +84 -0
- package/skills/match_engine.aicomponent/manifest.json +23 -0
- package/skills/match_engine.aicomponent/ref/MatchEngine.ts +75 -0
- package/skills/memory_match.aigameplay/SKILL.md +111 -0
- package/skills/memory_match.aigameplay/manifest.json +164 -0
- package/skills/memory_match.aigameplay/ref/pgs-schema.json +190 -0
- package/skills/memory_match.aigameplay/ref/reducer.template.ts +162 -0
- package/skills/merge_core.aigameplay/SKILL.md +112 -0
- package/skills/merge_core.aigameplay/manifest.json +154 -0
- package/skills/merge_core.aigameplay/ref/pgs-schema.json +202 -0
- package/skills/merge_core.aigameplay/ref/reducer.template.ts +179 -0
- package/skills/mistake_sfx.aiaudio/SKILL.md +59 -0
- package/skills/mistake_sfx.aiaudio/manifest.json +45 -0
- package/skills/mistake_sfx.aiaudio/ref/mistake.mp3 +0 -0
- package/skills/nomove_hint_overlay.aiimage/SKILL.md +58 -0
- package/skills/nomove_hint_overlay.aiimage/manifest.json +48 -0
- package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.png +0 -0
- package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.webp +0 -0
- package/skills/normal_dot.aiimage/SKILL.md +58 -0
- package/skills/normal_dot.aiimage/manifest.json +46 -0
- package/skills/normal_dot.aiimage/ref/normal_dot.png +0 -0
- package/skills/normal_dot.aiimage/ref/normal_dot.webp +0 -0
- package/skills/ocean.aiimage/SKILL.md +71 -0
- package/skills/ocean.aiimage/manifest.json +49 -0
- package/skills/particle-confetti.aicomponent/SKILL.md +32 -0
- package/skills/particle-confetti.aicomponent/manifest.json +21 -0
- package/skills/particle-confetti.aicomponent/ref/html5-spritesheet.js +17 -0
- package/skills/particle-confetti.aicomponent/ref/phaser.js +38 -0
- package/skills/particle-explosion.aicomponent/SKILL.md +37 -0
- package/skills/particle-explosion.aicomponent/manifest.json +24 -0
- package/skills/particle-explosion.aicomponent/ref/html5-spritesheet.js +40 -0
- package/skills/particle-explosion.aicomponent/ref/phaser.js +46 -0
- package/skills/particle-explosion.aicomponent/ref/playcanvas.js +33 -0
- package/skills/particle-trail.aicomponent/SKILL.md +25 -0
- package/skills/particle-trail.aicomponent/manifest.json +22 -0
- package/skills/particle-trail.aicomponent/ref/phaser.js +31 -0
- package/skills/path_animation.aicomponent/SKILL.md +82 -0
- package/skills/path_animation.aicomponent/manifest.json +77 -0
- package/skills/path_animation.aicomponent/ref/AnimationManager.ts +694 -0
- package/skills/path_animation.aicomponent/ref/AnimationManager3D.ts +317 -0
- package/skills/path_elimination_rules.aigameplay/SKILL.md +88 -0
- package/skills/path_elimination_rules.aigameplay/manifest.json +119 -0
- package/skills/path_elimination_rules.aigameplay/ref/pgs-schema.json +227 -0
- package/skills/path_input_handler.aicomponent/SKILL.md +87 -0
- package/skills/path_input_handler.aicomponent/manifest.json +97 -0
- package/skills/path_input_handler.aicomponent/ref/InputHandler.ts +714 -0
- package/skills/path_input_handler.aicomponent/ref/InputHandler3D.ts +204 -0
- package/skills/path_renderer.aicomponent/SKILL.md +101 -0
- package/skills/path_renderer.aicomponent/manifest.json +69 -0
- package/skills/path_renderer.aicomponent/ref/PathRenderer.ts +509 -0
- package/skills/path_renderer.aicomponent/ref/PathRenderer3D.ts +176 -0
- package/skills/path_renderer.aicomponent/ref/PathRenderers.ts +640 -0
- package/skills/phaser.aicomponent/SKILL.md +315 -0
- package/skills/phaser.aicomponent/manifest.json +156 -0
- package/skills/phaser.aicomponent/ref/BootScene.ts +29 -0
- package/skills/phaser.aicomponent/ref/GameConfig.ts +29 -0
- package/skills/phaser.aicomponent/ref/GameScene.ts +88 -0
- package/skills/phaser.aicomponent/ref/PreloaderScene.ts +78 -0
- package/skills/phaser.aicomponent/ref/SceneKeys.ts +7 -0
- package/skills/phaser.aicomponent/ref/SoundUtils.ts +21 -0
- package/skills/phaser.aicomponent/ref/UiLayout.ts +74 -0
- package/skills/phaser.aicomponent/ref/globals.d.ts +52 -0
- package/skills/phaser.aicomponent/ref/index.css +40 -0
- package/skills/phaser.aicomponent/ref/index.html +14 -0
- package/skills/phaser.aicomponent/ref/index.ts +48 -0
- package/skills/phaser.aicomponent/ref/main.ts +16 -0
- package/skills/phaser.aicomponent/ref/package.json +22 -0
- package/skills/phaser.aicomponent/ref/tsconfig.json +25 -0
- package/skills/phaser.aicomponent/ref/webpack.config.js +57 -0
- package/skills/phaser_scene_lifecycle.aicomponent/SKILL.md +63 -0
- package/skills/phaser_scene_lifecycle.aicomponent/manifest.json +33 -0
- package/skills/pick_and_match_rules.aigameplay/SKILL.md +113 -0
- package/skills/pick_and_match_rules.aigameplay/manifest.json +121 -0
- package/skills/pick_and_match_rules.aigameplay/ref/pgs-schema.json +354 -0
- package/skills/pin_pull.aigameplay/SKILL.md +110 -0
- package/skills/pin_pull.aigameplay/manifest.json +164 -0
- package/skills/pin_pull.aigameplay/ref/pgs-schema.json +201 -0
- package/skills/pin_pull.aigameplay/ref/reducer.template.ts +216 -0
- package/skills/playable_app_logo.aiimage/SKILL.md +58 -0
- package/skills/playable_app_logo.aiimage/manifest.json +47 -0
- package/skills/playable_app_logo.aiimage/ref/logo.png +0 -0
- package/skills/playable_app_logo.aiimage/ref/logo.webp +0 -0
- package/skills/playable_end_screen_layout.aicomponent/SKILL.md +75 -0
- package/skills/playable_end_screen_layout.aicomponent/manifest.json +24 -0
- package/skills/playable_guidance_layer.aicomponent/SKILL.md +89 -0
- package/skills/playable_guidance_layer.aicomponent/manifest.json +24 -0
- package/skills/playable_hud_layout.aicomponent/SKILL.md +96 -0
- package/skills/playable_hud_layout.aicomponent/manifest.json +24 -0
- package/skills/playable_scripts_build.aicomponent/SKILL.md +69 -0
- package/skills/playable_scripts_build.aicomponent/manifest.json +53 -0
- package/skills/playable_scripts_build.aicomponent/ref/builds.config.js +257 -0
- package/skills/playcraft-3d-flip-sprite/SKILL.md +336 -0
- package/skills/playcraft-3d-flip-sprite/renderer/flatten_glb.mjs +62 -0
- package/skills/playcraft-3d-flip-sprite/renderer/render.mjs +325 -0
- package/skills/playcraft-3d-flip-sprite/renderer/render_single.mjs +138 -0
- package/skills/playcraft-asset-management/SKILL.md +73 -0
- package/skills/playcraft-audio-generation/SKILL.md +126 -0
- package/skills/playcraft-build/SKILL.md +44 -0
- package/skills/playcraft-code-editor/SKILL.md +71 -0
- package/skills/playcraft-create-remix/SKILL.md +62 -0
- package/skills/playcraft-deploy/SKILL.md +59 -0
- package/skills/playcraft-image-generation/SKILL.md +148 -0
- package/skills/playcraft-image-processing/SKILL.md +216 -0
- package/skills/playcraft-platform-intro/SKILL.md +41 -0
- package/skills/playcraft-prefab/SKILL.md +98 -0
- package/skills/playcraft-project-management/SKILL.md +57 -0
- package/skills/playcraft-remix-workflow/SKILL.md +119 -0
- package/skills/playcraft-remix-workflow/references/xplatform.schema.json5 +31 -0
- package/skills/playcraft-save/SKILL.md +46 -0
- package/skills/playcraft-skill-recommender/SKILL.md +152 -0
- package/skills/playcraft-sprite-generation/SKILL.md +534 -0
- package/skills/playcraft-sprite-remix/SKILL.md +155 -0
- package/skills/playcraft-sprite-sheet/SKILL.md +97 -0
- package/skills/playtest_report.aivalidator/SKILL.md +103 -0
- package/skills/playtest_report.aivalidator/manifest.json +21 -0
- package/skills/preloader_scene.aicomponent/SKILL.md +58 -0
- package/skills/preloader_scene.aicomponent/manifest.json +43 -0
- package/skills/preloader_scene.aicomponent/ref/Preloader.ts +339 -0
- package/skills/progress_bar.aicomponent/SKILL.md +38 -0
- package/skills/progress_bar.aicomponent/manifest.json +25 -0
- package/skills/progress_bar.aicomponent/ref/ProgressDisplay.ts +140 -0
- package/skills/references/xplatform.schema.json5 +31 -0
- package/skills/responsive_2d_layout.aicomponent/SKILL.md +161 -0
- package/skills/responsive_2d_layout.aicomponent/manifest.json +43 -0
- package/skills/responsive_2d_layout.aicomponent/ref/UiLayout.ts +56 -0
- package/skills/run_context_state.aicomponent/SKILL.md +54 -0
- package/skills/run_context_state.aicomponent/manifest.json +40 -0
- package/skills/run_context_state.aicomponent/ref/RunContextRuntime.ts +30 -0
- package/skills/score-fly.aicomponent/SKILL.md +31 -0
- package/skills/score-fly.aicomponent/manifest.json +21 -0
- package/skills/score-fly.aicomponent/ref/phaser.js +26 -0
- package/skills/score-fly.aicomponent/ref/playcanvas.js +28 -0
- package/skills/score_goal.aiconfig/SKILL.md +46 -0
- package/skills/score_goal.aiconfig/manifest.json +33 -0
- package/skills/screen-flash.aicomponent/SKILL.md +30 -0
- package/skills/screen-flash.aicomponent/manifest.json +20 -0
- package/skills/screen-flash.aicomponent/ref/phaser.js +48 -0
- package/skills/screen-shake.aicomponent/SKILL.md +30 -0
- package/skills/screen-shake.aicomponent/manifest.json +19 -0
- package/skills/screen-shake.aicomponent/ref/phaser.js +23 -0
- package/skills/screen-shake.aicomponent/ref/playcanvas.js +44 -0
- package/skills/screw_puzzle.aigameplay/SKILL.md +116 -0
- package/skills/screw_puzzle.aigameplay/manifest.json +164 -0
- package/skills/screw_puzzle.aigameplay/ref/pgs-schema.json +235 -0
- package/skills/screw_puzzle.aigameplay/ref/reducer.template.ts +213 -0
- package/skills/settings_state.aicomponent/SKILL.md +61 -0
- package/skills/settings_state.aicomponent/manifest.json +33 -0
- package/skills/settings_state.aicomponent/ref/SettingsManager.ts +130 -0
- package/skills/slide_out_to_tray_animation.aicomponent/SKILL.md +64 -0
- package/skills/slide_out_to_tray_animation.aicomponent/manifest.json +58 -0
- package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager.ts +164 -0
- package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager3D.ts +198 -0
- package/skills/slide_out_to_tray_animation.aicomponent/ref/BezierUtils.ts +59 -0
- package/skills/slot_machine.aigameplay/SKILL.md +119 -0
- package/skills/slot_machine.aigameplay/manifest.json +166 -0
- package/skills/slot_machine.aigameplay/ref/pgs-schema.json +212 -0
- package/skills/slot_machine.aigameplay/ref/reducer.template.ts +212 -0
- package/skills/sniper_shot.aigameplay/SKILL.md +84 -0
- package/skills/sniper_shot.aigameplay/manifest.json +153 -0
- package/skills/sniper_shot.aigameplay/ref/pgs-schema.json +211 -0
- package/skills/sniper_shot.aigameplay/ref/reducer.template.ts +211 -0
- package/skills/solitaire.aigameplay/SKILL.md +101 -0
- package/skills/solitaire.aigameplay/manifest.json +151 -0
- package/skills/solitaire.aigameplay/ref/pgs-schema.json +200 -0
- package/skills/solitaire.aigameplay/ref/reducer.template.ts +176 -0
- package/skills/sound-effects/SKILL.md +46 -0
- package/skills/sound_utils.aicomponent/SKILL.md +52 -0
- package/skills/sound_utils.aicomponent/manifest.json +30 -0
- package/skills/sound_utils.aicomponent/ref/SoundUtils.ts +29 -0
- package/skills/sprite-animation-2d.aicomponent/SKILL.md +45 -0
- package/skills/sprite-animation-2d.aicomponent/manifest.json +28 -0
- package/skills/sprite-animation-2d.aicomponent/ref/html5.js +83 -0
- package/skills/sprite-animation-2d.aicomponent/ref/phaser.js +38 -0
- package/skills/sprite-animation-2d.aicomponent/ref/playcanvas.js +67 -0
- package/skills/sprite_entity_renderer.aicomponent/SKILL.md +148 -0
- package/skills/sprite_entity_renderer.aicomponent/manifest.json +17 -0
- package/skills/sprite_entity_renderer.aicomponent/ref/SpriteEntityRenderer.ts +126 -0
- package/skills/success_sfx.aiaudio/SKILL.md +59 -0
- package/skills/success_sfx.aiaudio/manifest.json +45 -0
- package/skills/success_sfx.aiaudio/ref/success.mp3 +0 -0
- package/skills/tap_blast.aigameplay/SKILL.md +116 -0
- package/skills/tap_blast.aigameplay/manifest.json +153 -0
- package/skills/tap_blast.aigameplay/ref/pgs-schema.json +208 -0
- package/skills/tap_blast.aigameplay/ref/reducer.template.ts +202 -0
- package/skills/theme_state.aicomponent/SKILL.md +53 -0
- package/skills/theme_state.aicomponent/manifest.json +33 -0
- package/skills/theme_state.aicomponent/ref/ThemeManager.ts +174 -0
- package/skills/theme_switcher_build.aicomponent/SKILL.md +62 -0
- package/skills/theme_switcher_build.aicomponent/manifest.json +38 -0
- package/skills/theme_switcher_build.aicomponent/ref/theme-index.ts +8 -0
- package/skills/theme_variant.aiconfig/SKILL.md +78 -0
- package/skills/theme_variant.aiconfig/manifest.json +39 -0
- package/skills/theme_variant.aiconfig/ref/ExampleTheme/index.ts +16 -0
- package/skills/theme_variant.aiconfig/ref/ExampleTheme/levelEasy.json +141 -0
- package/skills/threejs.aicomponent/SKILL.md +422 -0
- package/skills/threejs.aicomponent/manifest.json +166 -0
- package/skills/threejs.aicomponent/ref/AssetLoader.ts +158 -0
- package/skills/threejs.aicomponent/ref/BaseScene.ts +88 -0
- package/skills/threejs.aicomponent/ref/GameConfig.ts +47 -0
- package/skills/threejs.aicomponent/ref/MainScene.ts +170 -0
- package/skills/threejs.aicomponent/ref/PreloaderScene.ts +93 -0
- package/skills/threejs.aicomponent/ref/SceneKeys.ts +6 -0
- package/skills/threejs.aicomponent/ref/SceneManager.ts +69 -0
- package/skills/threejs.aicomponent/ref/ViewportManager.ts +62 -0
- package/skills/threejs.aicomponent/ref/globals.d.ts +74 -0
- package/skills/threejs.aicomponent/ref/index.css +80 -0
- package/skills/threejs.aicomponent/ref/index.html +20 -0
- package/skills/threejs.aicomponent/ref/index.ts +117 -0
- package/skills/threejs.aicomponent/ref/main.ts +10 -0
- package/skills/threejs.aicomponent/ref/package.json +23 -0
- package/skills/threejs.aicomponent/ref/tsconfig.json +24 -0
- package/skills/threejs.aicomponent/ref/webpack.config.js +61 -0
- package/skills/time_clear_goal.aiconfig/SKILL.md +46 -0
- package/skills/time_clear_goal.aiconfig/manifest.json +32 -0
- package/skills/time_icon.aiimage/SKILL.md +58 -0
- package/skills/time_icon.aiimage/manifest.json +47 -0
- package/skills/time_icon.aiimage/ref/time.png +0 -0
- package/skills/time_icon.aiimage/ref/time.webp +0 -0
- package/skills/top_ui_bar.aicomponent/SKILL.md +45 -0
- package/skills/top_ui_bar.aicomponent/manifest.json +27 -0
- package/skills/top_ui_bar.aicomponent/ref/GameTopUI.ts +229 -0
- package/skills/tower_defence.aigameplay/SKILL.md +117 -0
- package/skills/tower_defence.aigameplay/manifest.json +175 -0
- package/skills/tower_defence.aigameplay/ref/pgs-schema.json +247 -0
- package/skills/tower_defence.aigameplay/ref/reducer.template.ts +239 -0
- package/skills/tray_container.aicomponent/SKILL.md +143 -0
- package/skills/tray_container.aicomponent/manifest.json +58 -0
- package/skills/tray_container.aicomponent/ref/TrayRenderer.ts +155 -0
- package/skills/tray_container.aicomponent/ref/TrayRenderer3D.ts +281 -0
- package/skills/tray_container.aicomponent/ref/TrayRendererHtmlOverlay.ts +228 -0
- package/skills/tutorial_overlay.aicomponent/SKILL.md +46 -0
- package/skills/tutorial_overlay.aicomponent/manifest.json +34 -0
- package/skills/tutorial_overlay.aicomponent/ref/TutorialManager.ts +367 -0
- package/skills/tween-animation-2d.aicomponent/SKILL.md +35 -0
- package/skills/tween-animation-2d.aicomponent/manifest.json +28 -0
- package/skills/tween-animation-2d.aicomponent/ref/phaser.js +49 -0
- package/skills/tween-animation-2d.aicomponent/ref/playcanvas.js +36 -0
- package/skills/typescript_module_patterns.aicomponent/SKILL.md +209 -0
- package/skills/typescript_module_patterns.aicomponent/manifest.json +28 -0
- package/skills/typescript_module_patterns.aicomponent/ref/globals.d.ts +31 -0
- package/skills/ui-transition.aicomponent/SKILL.md +33 -0
- package/skills/ui-transition.aicomponent/manifest.json +19 -0
- package/skills/ui-transition.aicomponent/ref/phaser.js +45 -0
- package/skills/ux_flow_spec.aiconfig/SKILL.md +82 -0
- package/skills/ux_flow_spec.aiconfig/manifest.json +39 -0
- package/skills/wave_difficulty.aiconfig/SKILL.md +46 -0
- package/skills/wave_difficulty.aiconfig/manifest.json +33 -0
- package/skills/webpack_build.aicomponent/SKILL.md +204 -0
- package/skills/webpack_build.aicomponent/manifest.json +29 -0
- package/skills/webpack_build.aicomponent/ref/package.json +16 -0
- package/skills/webpack_build.aicomponent/ref/webpack.config.js +53 -0
- package/skills/win_anim_sfx.aiaudio/SKILL.md +59 -0
- package/skills/win_anim_sfx.aiaudio/manifest.json +46 -0
- package/skills/win_anim_sfx.aiaudio/ref/win_anim.mp3 +0 -0
- package/skills/win_dot.aiimage/SKILL.md +58 -0
- package/skills/win_dot.aiimage/manifest.json +47 -0
- package/skills/win_dot.aiimage/ref/win_dot.png +0 -0
- package/skills/win_dot.aiimage/ref/win_dot.webp +0 -0
- package/skills/win_result_panel.aiimage/SKILL.md +58 -0
- package/skills/win_result_panel.aiimage/manifest.json +47 -0
- package/skills/win_result_panel.aiimage/ref/win.png +0 -0
- package/skills/win_result_panel.aiimage/ref/win.webp +0 -0
- package/skills/word_connect.aigameplay/SKILL.md +86 -0
- package/skills/word_connect.aigameplay/manifest.json +154 -0
- package/skills/word_connect.aigameplay/ref/pgs-schema.json +212 -0
- package/skills/word_connect.aigameplay/ref/reducer.template.ts +186 -0
- package/src/index.ts +10 -0
- package/src/skills.loader.ts +225 -0
- package/src/skills.types.ts +42 -0
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* memory_match.aigameplay — reducer 接口模板
|
|
3
|
+
*
|
|
4
|
+
* Agent 生成实际 reducer 时,必须导出以下函数。
|
|
5
|
+
* 此文件是接口约束模板,不是可执行代码。
|
|
6
|
+
*
|
|
7
|
+
* ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
8
|
+
* ⚠️ 重要:渲染层(GameScene)不应直接调用 dispatch()
|
|
9
|
+
*
|
|
10
|
+
* dispatch() 是一体化接口,内部执行完整的翻牌+配对+翻回逻辑后只返回最终状态,
|
|
11
|
+
* 中间过程(翻牌动画、等待延迟、配对高亮、翻回动画)全部丢失。
|
|
12
|
+
*
|
|
13
|
+
* 渲染层需要按帧驱动动画链,因此必须使用下方的「分步函数」。
|
|
14
|
+
*
|
|
15
|
+
* dispatch() 的用途:无头测试、AI 模拟、跳过动画场景。
|
|
16
|
+
* ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
17
|
+
*/
|
|
18
|
+
|
|
19
|
+
// ─── 配置类型 ─────────────────────────────────────────────────────────────────
|
|
20
|
+
|
|
21
|
+
export type MemoryMatchConfig = {
|
|
22
|
+
/** 棋盘列数,默认 4 */
|
|
23
|
+
cols: number;
|
|
24
|
+
/** 棋盘行数,默认 4 */
|
|
25
|
+
rows: number;
|
|
26
|
+
/** 牌对数量,必须等于 (cols × rows) / 2 */
|
|
27
|
+
pairCount: number;
|
|
28
|
+
/** 同时最多可翻开的牌数,默认 2 */
|
|
29
|
+
maxFaceUpCount: number;
|
|
30
|
+
/** 不匹配后自动翻回的延迟(毫秒),默认 1000 */
|
|
31
|
+
flipBackDelayMs: number;
|
|
32
|
+
/** 预设牌面布局(可选,用于测试确定性布局;不提供时随机shuffle) */
|
|
33
|
+
initialLayout?: number[];
|
|
34
|
+
};
|
|
35
|
+
|
|
36
|
+
// ─── 动作类型 ─────────────────────────────────────────────────────────────────
|
|
37
|
+
|
|
38
|
+
export type MemoryMatchAction =
|
|
39
|
+
| { type: 'flip_card'; cardId: number }
|
|
40
|
+
| { type: 'flip_back_mismatched' }
|
|
41
|
+
| { type: 'reset' };
|
|
42
|
+
|
|
43
|
+
// ─── 状态类型 ─────────────────────────────────────────────────────────────────
|
|
44
|
+
|
|
45
|
+
export type CardState = 'face_down' | 'face_up' | 'matched';
|
|
46
|
+
|
|
47
|
+
export type Card = {
|
|
48
|
+
/** 卡牌唯一 ID(0 ~ totalCards-1) */
|
|
49
|
+
id: number;
|
|
50
|
+
/** 配对组 ID(相同 pairId 的两张牌为一对) */
|
|
51
|
+
pairId: number;
|
|
52
|
+
/** 当前状态 */
|
|
53
|
+
state: CardState;
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
export type MemoryMatchState = {
|
|
57
|
+
/** 所有卡牌 */
|
|
58
|
+
cards: Card[];
|
|
59
|
+
/** 当前正面朝上(face_up)的卡牌 ID 列表(最多 maxFaceUpCount 张)*/
|
|
60
|
+
faceUpCards: number[];
|
|
61
|
+
/** 已成功配对的对数 */
|
|
62
|
+
matchedPairs: number;
|
|
63
|
+
/** 总对数 */
|
|
64
|
+
totalPairs: number;
|
|
65
|
+
/** 玩家翻牌总次数 */
|
|
66
|
+
movesCount: number;
|
|
67
|
+
/** 游戏是否结束 */
|
|
68
|
+
gameOver: boolean;
|
|
69
|
+
/** 是否胜利 */
|
|
70
|
+
win: boolean;
|
|
71
|
+
/** 是否有未处理的不匹配翻回(等待 flipBackMismatched 调用) */
|
|
72
|
+
pendingFlipBack: boolean;
|
|
73
|
+
};
|
|
74
|
+
|
|
75
|
+
// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
|
|
76
|
+
|
|
77
|
+
/** checkMatch 返回值 */
|
|
78
|
+
export type MatchCheckResult = {
|
|
79
|
+
/** 两张 face_up 的牌 pairId 是否相同 */
|
|
80
|
+
isMatch: boolean;
|
|
81
|
+
/** 参与检测的卡牌 ID(应为2张) */
|
|
82
|
+
cardIds: number[];
|
|
83
|
+
/** 是否需要延迟翻回(isMatch=false 时为 true) */
|
|
84
|
+
shouldFlipBack: boolean;
|
|
85
|
+
};
|
|
86
|
+
|
|
87
|
+
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
88
|
+
// 必须导出的函数
|
|
89
|
+
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
90
|
+
|
|
91
|
+
// ─── 初始化 ──────────────────────────────────────────────────────────────────
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* init:根据配置初始化游戏状态,随机(或按指定布局)排列卡牌
|
|
95
|
+
*/
|
|
96
|
+
export declare function init(config: MemoryMatchConfig): MemoryMatchState;
|
|
97
|
+
|
|
98
|
+
// ─── 一体化接口(测试/AI 模拟用) ───────────────────────────────────────────
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* dispatch:接收动作,返回新状态(纯函数,不得修改原 state)
|
|
102
|
+
* - flip_card:翻开指定卡牌,若已有2张 face_up 则拒绝
|
|
103
|
+
* - flip_back_mismatched:将不匹配的2张 face_up 牌翻回 face_down
|
|
104
|
+
* - reset:重置到初始状态
|
|
105
|
+
*
|
|
106
|
+
* ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
|
|
107
|
+
*/
|
|
108
|
+
export declare function dispatch(state: MemoryMatchState, action: MemoryMatchAction): MemoryMatchState;
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* getState:返回当前状态快照
|
|
112
|
+
*/
|
|
113
|
+
export declare function getState(state: MemoryMatchState): MemoryMatchState;
|
|
114
|
+
|
|
115
|
+
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
116
|
+
// 分步函数(渲染层/场景层必须使用这些函数驱动动画)
|
|
117
|
+
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* flipCard:翻开指定卡牌(face_down → face_up),更新 movesCount 和 faceUpCards。
|
|
121
|
+
*
|
|
122
|
+
* 场景层在玩家点击卡牌后,翻牌动画开始前调用(或动画完成后调用均可)。
|
|
123
|
+
* 若 pendingFlipBack=true(有未处理的不匹配),返回状态不变(拒绝翻牌)。
|
|
124
|
+
*
|
|
125
|
+
* @param state 当前游戏状态(不可变)
|
|
126
|
+
* @param cardId 目标卡牌 ID
|
|
127
|
+
* @returns 更新后的游戏状态
|
|
128
|
+
*/
|
|
129
|
+
export declare function flipCard(state: MemoryMatchState, cardId: number): MemoryMatchState;
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* checkMatch:检测当前 faceUpCards 中的两张牌是否配对。
|
|
133
|
+
*
|
|
134
|
+
* 场景层在第二张牌翻开动画完成后立即调用。
|
|
135
|
+
* - isMatch=true:自动将两张牌更新为 matched,调用方播放配对成功动画
|
|
136
|
+
* - isMatch=false:设置 pendingFlipBack=true,调用方在延迟后调用 flipBackMismatched
|
|
137
|
+
*
|
|
138
|
+
* @param state 当前游戏状态(faceUpCards 必须恰好有2张 face_up 牌)
|
|
139
|
+
* @returns 配对检测结果
|
|
140
|
+
*/
|
|
141
|
+
export declare function checkMatch(state: MemoryMatchState): MatchCheckResult;
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* flipBackMismatched:将 faceUpCards 中2张不匹配的牌翻回 face_down。
|
|
145
|
+
*
|
|
146
|
+
* 场景层在检测到 shouldFlipBack=true 后,等待 flipBackDelayMs 毫秒,
|
|
147
|
+
* 然后调用此函数同步状态,并播放翻回动画。
|
|
148
|
+
*
|
|
149
|
+
* @param state 当前游戏状态(pendingFlipBack 必须为 true)
|
|
150
|
+
* @returns 更新后的游戏状态(两张牌回到 face_down,faceUpCards 清空)
|
|
151
|
+
*/
|
|
152
|
+
export declare function flipBackMismatched(state: MemoryMatchState): MemoryMatchState;
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* checkWin:检测是否所有牌对均已配对。
|
|
156
|
+
*
|
|
157
|
+
* 场景层在每次配对成功动画播放完毕后调用,判断是否触发胜利演出。
|
|
158
|
+
*
|
|
159
|
+
* @param state 当前游戏状态
|
|
160
|
+
* @returns true 表示所有牌均已配对(win=true)
|
|
161
|
+
*/
|
|
162
|
+
export declare function checkWin(state: MemoryMatchState): boolean;
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: merge_core.aigameplay
|
|
3
|
+
description: 网格合成升级玩法封包 - 经典合并同级物品的 PGS 实现,拖动相同等级的物品合并升级,支持自动生成新物品
|
|
4
|
+
triggers: 合成,merge,合并,升级,upgrade,合体,network grid,网格,grid,等级,tier,玩法,gameplay
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# merge_core.aigameplay
|
|
8
|
+
|
|
9
|
+
网格合成升级玩法封包。实现标准合成玩法规则的 PGS JSON 和 reducer,玩家拖动同一等级的物品到相邻格子合并,合并产生高一等级的物品,目标是合成到最高等级物品或达到分数目标。
|
|
10
|
+
|
|
11
|
+
## Recipe
|
|
12
|
+
|
|
13
|
+
- **玩法类型**:merge_core(网格合成升级)
|
|
14
|
+
- **参考文件**:
|
|
15
|
+
- `ref/pgs-schema.json`:PGS (PlayCraft Gameplay Schema) 规则骨架(entities、rules、algorithm、testCases)
|
|
16
|
+
- `ref/reducer.template.ts`:reducer 接口约束模板(`init` / `dispatch` / `getState` + 分步函数)
|
|
17
|
+
- **核心规则**:
|
|
18
|
+
- `boardSize`: 5×5(默认网格大小)
|
|
19
|
+
- `maxTier`: 9(最高等级,可配置)
|
|
20
|
+
- `mergeRule`: same_tier_adjacent(拖动 A 到相邻的 B,A.tier === B.tier → 合并为 tier+1)
|
|
21
|
+
- `autoSpawn`: true(每次操作后自动在随机空格生成 tier-1 物品)
|
|
22
|
+
- `spawnTier`: 1(自动生成的初始等级,通常为 1 或 2)
|
|
23
|
+
- **PGS Agent 操作流程**:
|
|
24
|
+
1. 读取 `ref/pgs-schema.json` 作为规则骨架起点
|
|
25
|
+
2. 读取 `ref/reducer.template.ts` 了解接口约束
|
|
26
|
+
3. 实现 `reducer.ts`,导出 `init(config)`、`dispatch(state, action)`、`getState(state)` 以及**全部分步函数**
|
|
27
|
+
4. 运行 `ref/pgs-schema.json` 中的所有 `testCases`,全部通过后才算完成
|
|
28
|
+
5. 更新 manifest 的 `generation.pgsVersion` 和 `result.outputFile`
|
|
29
|
+
- **可 fork 变体**:
|
|
30
|
+
- 链式合成:3 个同级物品同时合并
|
|
31
|
+
- 无限模式:`maxTier` 无上限,追求最高等级
|
|
32
|
+
- 特殊物品:添加 `wildcard` 等级物品,可与任意等级合并
|
|
33
|
+
|
|
34
|
+
## Result
|
|
35
|
+
|
|
36
|
+
- **产物文件**:`reducer.ts`
|
|
37
|
+
- **格式**:TypeScript,导出 `init(config)`、`dispatch(state, action)`、`getState(state)` + 分步函数接口
|
|
38
|
+
- **验证**:所有 testCases 必须通过
|
|
39
|
+
|
|
40
|
+
## 渲染集成(⚠️ 场景层必读)
|
|
41
|
+
|
|
42
|
+
### 设计原则:逻辑与动画分离
|
|
43
|
+
|
|
44
|
+
reducer 提供两套接口:
|
|
45
|
+
|
|
46
|
+
| 接口 | 适用场景 | 特点 |
|
|
47
|
+
|------|---------|------|
|
|
48
|
+
| `dispatch()` | 无头测试、AI 模拟、跳过动画 | 一步到位,只返回最终状态 |
|
|
49
|
+
| 分步函数 | **渲染层/GameScene** | 逐步执行,返回中间过程数据 |
|
|
50
|
+
|
|
51
|
+
### ⚠️ 禁止在渲染层使用 dispatch() 然后全量重建棋盘
|
|
52
|
+
|
|
53
|
+
正确做法是**分步驱动动画链**:
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
// ✅ 正确做法:逐步调用分步函数,每步之间插入动画
|
|
57
|
+
// Step 1: 拖拽过程中实时检测是否可合并(hover 高亮)
|
|
58
|
+
const mergeable = canMerge(state, dragFrom, hoverTarget);
|
|
59
|
+
highlightCell(hoverTarget, mergeable ? 'valid' : 'invalid');
|
|
60
|
+
|
|
61
|
+
// Step 2: 执行合并
|
|
62
|
+
const { mergedItem, newState } = mergeItems(state, dragFrom, dragTo);
|
|
63
|
+
await playMergeAnimation(dragFrom, dragTo, mergedItem); // 拖动的物品飞向目标格子,合并升级动画
|
|
64
|
+
|
|
65
|
+
// Step 3: 自动生成新物品(若 autoSpawn 开启)
|
|
66
|
+
const spawned = spawnItem(newState);
|
|
67
|
+
if (spawned) await playSpawnAnimation(spawned); // 新物品从空格弹出动画
|
|
68
|
+
|
|
69
|
+
// Step 4: 检测胜利/失败
|
|
70
|
+
if (mergedItem.tier >= config.maxTier) { playWinAnimation(); return; }
|
|
71
|
+
const pairs = findMergablePairs(newState);
|
|
72
|
+
const hasEmpty = newState.board.some(row => row.some(cell => cell === null));
|
|
73
|
+
if (!hasEmpty && pairs.length === 0) { playLoseAnimation(); }
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### 分步函数返回值与动画映射
|
|
77
|
+
|
|
78
|
+
| 分步函数 | 返回值 | 场景层动画 |
|
|
79
|
+
|---------|--------|-----------|
|
|
80
|
+
| `canMerge()` | `boolean` | 实时高亮目标格子(绿色/红色边框) |
|
|
81
|
+
| `mergeItems()` | `{ mergedItem, removedFrom, newState }` | 拖动物品飞向目标 → 合并升级光效 → 新等级物品出现 |
|
|
82
|
+
| `spawnItem()` | `SpawnedItem \| null` | 随机空格弹出新物品的缩放入场动画 |
|
|
83
|
+
| `findMergablePairs()` | `MergePair[]` | 用于 Hint 功能:高亮可合并的一对物品 |
|
|
84
|
+
|
|
85
|
+
## Binding
|
|
86
|
+
|
|
87
|
+
- **Binding Role**:`gameplayRule`
|
|
88
|
+
- **挂载目标**:`game/gameplay/merge_core/reducer.ts`
|
|
89
|
+
- **引用类型**:`gameplay-module-reference`
|
|
90
|
+
- **接口契约**:`init(config)` / `dispatch(state, action)` / `getState(state)` / `canMerge()` / `mergeItems()` / `spawnItem()` / `findMergablePairs()`
|
|
91
|
+
|
|
92
|
+
## Skill Definition
|
|
93
|
+
|
|
94
|
+
tools:
|
|
95
|
+
- bash
|
|
96
|
+
- write
|
|
97
|
+
- read
|
|
98
|
+
prompt_extension: |
|
|
99
|
+
You are implementing a merge (grid combine upgrade) core gameplay module following the PGS specification.
|
|
100
|
+
Write the PGS JSON with entities, rules, algorithm, and testCases.
|
|
101
|
+
Implement the reducer.ts with:
|
|
102
|
+
- init/dispatch/getState (一体化接口,用于测试)
|
|
103
|
+
- canMerge/mergeItems/spawnItem/findMergablePairs (分步函数,用于渲染层动画驱动)
|
|
104
|
+
Key constraints:
|
|
105
|
+
- Items have a tier (1 to maxTier); two items of same tier merge into one item of tier+1
|
|
106
|
+
- Merge only valid when source and target are adjacent (orthogonal or diagonal, configurable) and same tier
|
|
107
|
+
- After each merge, spawn a new low-tier item in a random empty cell (if autoSpawn enabled)
|
|
108
|
+
- Win: any item reaches maxTier OR cumulative score reaches goalScore
|
|
109
|
+
- Lose: board is full AND no mergeable pairs exist
|
|
110
|
+
The step-by-step functions are CRITICAL for drag-merge and spawn animations.
|
|
111
|
+
Run the testCases to verify the logic before finalizing.
|
|
112
|
+
Apply the Binding to wire the reducer into the game's gameplay module path.
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"atomId": "merge_core.aigameplay",
|
|
4
|
+
"bundleType": "aigameplay",
|
|
5
|
+
"category": "gameplay",
|
|
6
|
+
"mode": "fixed",
|
|
7
|
+
"label": {
|
|
8
|
+
"zh": "网格合成升级玩法",
|
|
9
|
+
"en": "Merge grid upgrade gameplay"
|
|
10
|
+
},
|
|
11
|
+
"tags": [
|
|
12
|
+
"gameplay",
|
|
13
|
+
"merge",
|
|
14
|
+
"grid",
|
|
15
|
+
"casual",
|
|
16
|
+
"upgrade",
|
|
17
|
+
"combine",
|
|
18
|
+
"core"
|
|
19
|
+
],
|
|
20
|
+
"bindingRoles": [
|
|
21
|
+
"gameplayRule"
|
|
22
|
+
],
|
|
23
|
+
"imports": [
|
|
24
|
+
{
|
|
25
|
+
"slot": "engine",
|
|
26
|
+
"pinAtomId": "phaser.aicomponent",
|
|
27
|
+
"edgeKind": "requires",
|
|
28
|
+
"bindAs": "engine"
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
"slot": "bgMusic",
|
|
32
|
+
"description": "背景循环音乐",
|
|
33
|
+
"bindAs": "bgm",
|
|
34
|
+
"required": false,
|
|
35
|
+
"edgeKind": "compatibleWith",
|
|
36
|
+
"matchBindingRoles": [
|
|
37
|
+
"bgMusic"
|
|
38
|
+
],
|
|
39
|
+
"allowedBundleTypes": [
|
|
40
|
+
"aiaudio"
|
|
41
|
+
],
|
|
42
|
+
"constraints": {
|
|
43
|
+
"loop": true
|
|
44
|
+
}
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"slot": "background",
|
|
48
|
+
"description": "游戏背景图",
|
|
49
|
+
"bindAs": "bg",
|
|
50
|
+
"required": false,
|
|
51
|
+
"edgeKind": "compatibleWith",
|
|
52
|
+
"matchBindingRoles": [
|
|
53
|
+
"backgroundTexture"
|
|
54
|
+
],
|
|
55
|
+
"allowedBundleTypes": [
|
|
56
|
+
"aiimage"
|
|
57
|
+
]
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"slot": "winPanel",
|
|
61
|
+
"description": "通关反馈面板视觉",
|
|
62
|
+
"bindAs": "winPanel",
|
|
63
|
+
"required": false,
|
|
64
|
+
"edgeKind": "compatibleWith",
|
|
65
|
+
"matchBindingRoles": [
|
|
66
|
+
"successFeedbackPanel"
|
|
67
|
+
],
|
|
68
|
+
"allowedBundleTypes": [
|
|
69
|
+
"aiimage"
|
|
70
|
+
]
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"slot": "tutorial",
|
|
74
|
+
"description": "新手引导浮层",
|
|
75
|
+
"bindAs": "tutorial",
|
|
76
|
+
"required": false,
|
|
77
|
+
"edgeKind": "compatibleWith",
|
|
78
|
+
"matchBindingRoles": [
|
|
79
|
+
"tutorialOverlay"
|
|
80
|
+
],
|
|
81
|
+
"allowedBundleTypes": [
|
|
82
|
+
"aicomponent"
|
|
83
|
+
]
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
"slot": "losePanel",
|
|
87
|
+
"description": "失败反馈面板视觉",
|
|
88
|
+
"bindAs": "losePanel",
|
|
89
|
+
"required": false,
|
|
90
|
+
"edgeKind": "compatibleWith",
|
|
91
|
+
"matchBindingRoles": [
|
|
92
|
+
"failFeedbackPanel"
|
|
93
|
+
],
|
|
94
|
+
"allowedBundleTypes": [
|
|
95
|
+
"aiimage"
|
|
96
|
+
]
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
"slot": "endScreen",
|
|
100
|
+
"description": "可玩广告结算屏(含 CTA 按钮)",
|
|
101
|
+
"bindAs": "endScreen",
|
|
102
|
+
"required": false,
|
|
103
|
+
"edgeKind": "compatibleWith",
|
|
104
|
+
"matchBindingRoles": [
|
|
105
|
+
"playableEndScreenLayout"
|
|
106
|
+
],
|
|
107
|
+
"allowedBundleTypes": [
|
|
108
|
+
"aicomponent"
|
|
109
|
+
]
|
|
110
|
+
}
|
|
111
|
+
],
|
|
112
|
+
"generation": {
|
|
113
|
+
"kind": "pgs",
|
|
114
|
+
"pgsVersion": "1.0",
|
|
115
|
+
"gameplayType": "merge_core",
|
|
116
|
+
"rules": {
|
|
117
|
+
"boardCols": 5,
|
|
118
|
+
"boardRows": 5,
|
|
119
|
+
"maxTier": 9,
|
|
120
|
+
"mergeRule": "same_tier_adjacent",
|
|
121
|
+
"autoSpawn": true,
|
|
122
|
+
"spawnTier": 1,
|
|
123
|
+
"spawnOnAction": true
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
"result": {
|
|
127
|
+
"outputFile": "reducer.ts",
|
|
128
|
+
"format": "typescript",
|
|
129
|
+
"constraints": {
|
|
130
|
+
"testCasesMustPass": true
|
|
131
|
+
}
|
|
132
|
+
},
|
|
133
|
+
"binding": {
|
|
134
|
+
"role": "gameplayRule",
|
|
135
|
+
"target": "game/gameplay/merge_core/reducer.ts",
|
|
136
|
+
"type": "gameplay-module-reference",
|
|
137
|
+
"constraints": {
|
|
138
|
+
"interface": [
|
|
139
|
+
"init(config)",
|
|
140
|
+
"dispatch(state, action)",
|
|
141
|
+
"getState(state)",
|
|
142
|
+
"canMerge(state, from, to)",
|
|
143
|
+
"mergeItems(state, from, to)",
|
|
144
|
+
"spawnItem(state)",
|
|
145
|
+
"findMergablePairs(state)"
|
|
146
|
+
]
|
|
147
|
+
}
|
|
148
|
+
},
|
|
149
|
+
"files": {
|
|
150
|
+
"skill": "SKILL.md",
|
|
151
|
+
"pgsSchema": "ref/pgs-schema.json",
|
|
152
|
+
"reducerTemplate": "ref/reducer.template.ts"
|
|
153
|
+
}
|
|
154
|
+
}
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 网格合成升级玩法。Agent 以此为起点编写或 fork 玩法规则。",
|
|
3
|
+
"version": "1.0",
|
|
4
|
+
"gameplayType": "merge_core",
|
|
5
|
+
"entities": {
|
|
6
|
+
"board": {
|
|
7
|
+
"type": "grid",
|
|
8
|
+
"cols": 5,
|
|
9
|
+
"rows": 5,
|
|
10
|
+
"description": "游戏棋盘,默认 5×5 格子"
|
|
11
|
+
},
|
|
12
|
+
"item": {
|
|
13
|
+
"type": "cell-item",
|
|
14
|
+
"tierCount": 9,
|
|
15
|
+
"description": "棋盘格子上的可合成物品,等级从 1 到 maxTier(默认 9)"
|
|
16
|
+
},
|
|
17
|
+
"score": {
|
|
18
|
+
"type": "counter",
|
|
19
|
+
"initial": 0,
|
|
20
|
+
"description": "当前得分,每次合成增加 2^tier 分"
|
|
21
|
+
},
|
|
22
|
+
"moves": {
|
|
23
|
+
"type": "counter",
|
|
24
|
+
"initial": 0,
|
|
25
|
+
"description": "已使用操作次数(记录用)"
|
|
26
|
+
}
|
|
27
|
+
},
|
|
28
|
+
"rules": {
|
|
29
|
+
"merge_same_tier": {
|
|
30
|
+
"description": "拖动物品 A 到相邻格子 B,若 A.tier === B.tier 则合并:移除 A 和 B,在 B 位置放置 tier+1 物品",
|
|
31
|
+
"adjacency": "orthogonal",
|
|
32
|
+
"condition": "same_tier",
|
|
33
|
+
"result": "place_tier_plus_one_at_target",
|
|
34
|
+
"maxTierCheck": true
|
|
35
|
+
},
|
|
36
|
+
"spawn_new_item": {
|
|
37
|
+
"description": "每次合并操作后,在棋盘随机空格自动生成 1 个 tier-1 物品(通常 tier=1)",
|
|
38
|
+
"trigger": "after_merge",
|
|
39
|
+
"spawnTier": 1,
|
|
40
|
+
"spawnCount": 1,
|
|
41
|
+
"randomEmptyCell": true
|
|
42
|
+
},
|
|
43
|
+
"level_up_check": {
|
|
44
|
+
"description": "合并后检查新物品等级,若达到 maxTier 则触发胜利",
|
|
45
|
+
"winTier": "maxTier"
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"algorithm": {
|
|
49
|
+
"description": "主循环:选择 → 拖动 → 合并 → 生成 → 胜利/失败检测",
|
|
50
|
+
"steps": [
|
|
51
|
+
"1. 玩家拖动某格子物品 A 到相邻格子 B",
|
|
52
|
+
"2. 检测合并条件:A 和 B 存在且 tier 相同,且 B 在 A 的相邻位置",
|
|
53
|
+
"3. 若不合法则取消拖动",
|
|
54
|
+
"4. 合法则:移除 A,将 B 升级为 tier+1,moves + 1,score += 2^(tier+1)",
|
|
55
|
+
"5. 检测胜利:新物品 tier >= maxTier",
|
|
56
|
+
"6. 若 autoSpawn,在随机空格生成 spawnTier 物品",
|
|
57
|
+
"7. 检测失败:棋盘已满且无任何可合并对"
|
|
58
|
+
]
|
|
59
|
+
},
|
|
60
|
+
"winCondition": {
|
|
61
|
+
"type": "reach_max_tier",
|
|
62
|
+
"description": "任意物品达到 maxTier 等级,或累计得分达到 goalScore"
|
|
63
|
+
},
|
|
64
|
+
"loseCondition": {
|
|
65
|
+
"type": "board_full_no_merge",
|
|
66
|
+
"description": "棋盘完全填满且不存在任何相邻同级物品对"
|
|
67
|
+
},
|
|
68
|
+
"testCases": [
|
|
69
|
+
{
|
|
70
|
+
"id": "tc_basic_merge",
|
|
71
|
+
"description": "基础合并:两个 tier-1 物品相邻,合并为 tier-2",
|
|
72
|
+
"initialState": {
|
|
73
|
+
"board": [
|
|
74
|
+
[1, 1, null, null, null],
|
|
75
|
+
[null, null, null, null, null],
|
|
76
|
+
[null, null, null, null, null],
|
|
77
|
+
[null, null, null, null, null],
|
|
78
|
+
[null, null, null, null, null]
|
|
79
|
+
],
|
|
80
|
+
"score": 0,
|
|
81
|
+
"moves": 0
|
|
82
|
+
},
|
|
83
|
+
"action": { "type": "merge", "from": { "col": 0, "row": 0 }, "to": { "col": 1, "row": 0 } },
|
|
84
|
+
"expectedState": {
|
|
85
|
+
"board_cell_1_0": 2,
|
|
86
|
+
"board_cell_0_0": null,
|
|
87
|
+
"score": 4,
|
|
88
|
+
"moves": 1,
|
|
89
|
+
"win": false
|
|
90
|
+
}
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"id": "tc_invalid_merge_different_tier",
|
|
94
|
+
"description": "非法合并:两个物品等级不同,拒绝",
|
|
95
|
+
"initialState": {
|
|
96
|
+
"board": [
|
|
97
|
+
[1, 2, null, null, null],
|
|
98
|
+
[null, null, null, null, null],
|
|
99
|
+
[null, null, null, null, null],
|
|
100
|
+
[null, null, null, null, null],
|
|
101
|
+
[null, null, null, null, null]
|
|
102
|
+
],
|
|
103
|
+
"score": 10,
|
|
104
|
+
"moves": 3
|
|
105
|
+
},
|
|
106
|
+
"action": { "type": "merge", "from": { "col": 0, "row": 0 }, "to": { "col": 1, "row": 0 } },
|
|
107
|
+
"expectedState": {
|
|
108
|
+
"mergeRejected": true,
|
|
109
|
+
"score": 10,
|
|
110
|
+
"moves": 3,
|
|
111
|
+
"boardUnchanged": true
|
|
112
|
+
}
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"id": "tc_invalid_merge_non_adjacent",
|
|
116
|
+
"description": "非法合并:两个物品不相邻",
|
|
117
|
+
"initialState": {
|
|
118
|
+
"board": [
|
|
119
|
+
[1, null, 1, null, null],
|
|
120
|
+
[null, null, null, null, null],
|
|
121
|
+
[null, null, null, null, null],
|
|
122
|
+
[null, null, null, null, null],
|
|
123
|
+
[null, null, null, null, null]
|
|
124
|
+
],
|
|
125
|
+
"score": 0,
|
|
126
|
+
"moves": 0
|
|
127
|
+
},
|
|
128
|
+
"action": { "type": "merge", "from": { "col": 0, "row": 0 }, "to": { "col": 2, "row": 0 } },
|
|
129
|
+
"expectedState": {
|
|
130
|
+
"mergeRejected": true,
|
|
131
|
+
"boardUnchanged": true
|
|
132
|
+
}
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"id": "tc_auto_spawn",
|
|
136
|
+
"description": "合并后自动生成新的 tier-1 物品",
|
|
137
|
+
"initialState": {
|
|
138
|
+
"board": [
|
|
139
|
+
[2, 2, null, null, null],
|
|
140
|
+
[null, null, null, null, null],
|
|
141
|
+
[null, null, null, null, null],
|
|
142
|
+
[null, null, null, null, null],
|
|
143
|
+
[null, null, null, null, null]
|
|
144
|
+
],
|
|
145
|
+
"score": 0,
|
|
146
|
+
"moves": 0,
|
|
147
|
+
"autoSpawn": true
|
|
148
|
+
},
|
|
149
|
+
"action": { "type": "merge", "from": { "col": 0, "row": 0 }, "to": { "col": 1, "row": 0 } },
|
|
150
|
+
"expectedState": {
|
|
151
|
+
"board_cell_1_0": 3,
|
|
152
|
+
"board_cell_0_0": null,
|
|
153
|
+
"totalNonNullCells": 2,
|
|
154
|
+
"spawned": { "tier": 1 },
|
|
155
|
+
"score": 8
|
|
156
|
+
}
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"id": "tc_win_reach_max_tier",
|
|
160
|
+
"description": "胜利:合并后物品达到 maxTier(9)",
|
|
161
|
+
"initialState": {
|
|
162
|
+
"board": [
|
|
163
|
+
[8, 8, null, null, null],
|
|
164
|
+
[null, null, null, null, null],
|
|
165
|
+
[null, null, null, null, null],
|
|
166
|
+
[null, null, null, null, null],
|
|
167
|
+
[null, null, null, null, null]
|
|
168
|
+
],
|
|
169
|
+
"score": 500,
|
|
170
|
+
"moves": 20,
|
|
171
|
+
"maxTier": 9
|
|
172
|
+
},
|
|
173
|
+
"action": { "type": "merge", "from": { "col": 0, "row": 0 }, "to": { "col": 1, "row": 0 } },
|
|
174
|
+
"expectedState": {
|
|
175
|
+
"board_cell_1_0": 9,
|
|
176
|
+
"win": true,
|
|
177
|
+
"score": { "min": 1012 }
|
|
178
|
+
}
|
|
179
|
+
},
|
|
180
|
+
{
|
|
181
|
+
"id": "tc_lose_board_full_no_merge",
|
|
182
|
+
"description": "失败:棋盘满且无相邻同级物品",
|
|
183
|
+
"initialState": {
|
|
184
|
+
"board": [
|
|
185
|
+
[1, 2, 1, 2, 1],
|
|
186
|
+
[2, 1, 2, 1, 2],
|
|
187
|
+
[1, 2, 1, 2, 1],
|
|
188
|
+
[2, 1, 2, 1, 2],
|
|
189
|
+
[1, 2, 1, 2, 1]
|
|
190
|
+
],
|
|
191
|
+
"score": 200,
|
|
192
|
+
"moves": 30
|
|
193
|
+
},
|
|
194
|
+
"action": { "type": "check" },
|
|
195
|
+
"expectedState": {
|
|
196
|
+
"gameOver": true,
|
|
197
|
+
"win": false,
|
|
198
|
+
"mergablePairs": []
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
]
|
|
202
|
+
}
|