@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.
Files changed (479) hide show
  1. package/README.md +333 -0
  2. package/dist/src/index.d.ts +3 -0
  3. package/dist/src/index.d.ts.map +1 -0
  4. package/dist/src/index.js +2 -0
  5. package/dist/src/index.js.map +1 -0
  6. package/dist/src/skills.loader.d.ts +31 -0
  7. package/dist/src/skills.loader.d.ts.map +1 -0
  8. package/dist/src/skills.loader.js +200 -0
  9. package/dist/src/skills.loader.js.map +1 -0
  10. package/dist/src/skills.types.d.ts +44 -0
  11. package/dist/src/skills.types.d.ts.map +1 -0
  12. package/dist/src/skills.types.js +9 -0
  13. package/dist/src/skills.types.js.map +1 -0
  14. package/package.json +35 -0
  15. package/skills/2048_core.aigameplay/SKILL.md +123 -0
  16. package/skills/2048_core.aigameplay/manifest.json +159 -0
  17. package/skills/2048_core.aigameplay/ref/pgs-schema.json +194 -0
  18. package/skills/2048_core.aigameplay/ref/reducer.template.ts +189 -0
  19. package/skills/SKILL.md +46 -0
  20. package/skills/ad_compliance_rules.aiconfig/SKILL.md +85 -0
  21. package/skills/ad_compliance_rules.aiconfig/manifest.json +60 -0
  22. package/skills/agent_remix_orchestrator.aicomponent/SKILL.md +257 -0
  23. package/skills/agent_remix_orchestrator.aicomponent/manifest.json +12 -0
  24. package/skills/app_metadata.aiconfig/SKILL.md +53 -0
  25. package/skills/app_metadata.aiconfig/manifest.json +32 -0
  26. package/skills/appear_sfx.aiaudio/SKILL.md +59 -0
  27. package/skills/appear_sfx.aiaudio/manifest.json +45 -0
  28. package/skills/appear_sfx.aiaudio/ref/appear.mp3 +0 -0
  29. package/skills/arrow_move_error_sfx.aiaudio/SKILL.md +59 -0
  30. package/skills/arrow_move_error_sfx.aiaudio/manifest.json +45 -0
  31. package/skills/arrow_move_error_sfx.aiaudio/ref/arrow_move_error.mp3 +0 -0
  32. package/skills/arrow_path_data_format.aicomponent/SKILL.md +152 -0
  33. package/skills/arrow_path_data_format.aicomponent/manifest.json +57 -0
  34. package/skills/arrow_path_data_format.aicomponent/ref/LevelParser.ts +188 -0
  35. package/skills/arrow_path_data_format.aicomponent/ref/LevelTypes.ts +131 -0
  36. package/skills/arrow_pick_match_rules.aigameplay/SKILL.md +117 -0
  37. package/skills/arrow_pick_match_rules.aigameplay/manifest.json +105 -0
  38. package/skills/arrow_pick_match_rules.aigameplay/ref/pgs-schema.json +180 -0
  39. package/skills/asset_pipeline_scripts.aicomponent/SKILL.md +117 -0
  40. package/skills/asset_pipeline_scripts.aicomponent/manifest.json +17 -0
  41. package/skills/asset_pipeline_scripts.aicomponent/ref/gen-sprite.sh +105 -0
  42. package/skills/ball_sort.aigameplay/SKILL.md +109 -0
  43. package/skills/ball_sort.aigameplay/manifest.json +155 -0
  44. package/skills/ball_sort.aigameplay/ref/pgs-schema.json +192 -0
  45. package/skills/ball_sort.aigameplay/ref/reducer.template.ts +156 -0
  46. package/skills/basketball_shot.aigameplay/SKILL.md +94 -0
  47. package/skills/basketball_shot.aigameplay/manifest.json +150 -0
  48. package/skills/basketball_shot.aigameplay/ref/pgs-schema.json +229 -0
  49. package/skills/basketball_shot.aigameplay/ref/reducer.template.ts +189 -0
  50. package/skills/bg_music.aiaudio/SKILL.md +61 -0
  51. package/skills/bg_music.aiaudio/manifest.json +48 -0
  52. package/skills/bg_music.aiaudio/ref/bg.mp3 +0 -0
  53. package/skills/big_watermelon.aigameplay/SKILL.md +94 -0
  54. package/skills/big_watermelon.aigameplay/manifest.json +155 -0
  55. package/skills/big_watermelon.aigameplay/ref/pgs-schema.json +191 -0
  56. package/skills/big_watermelon.aigameplay/ref/reducer.template.ts +202 -0
  57. package/skills/block_puzzle.aigameplay/SKILL.md +121 -0
  58. package/skills/block_puzzle.aigameplay/manifest.json +154 -0
  59. package/skills/block_puzzle.aigameplay/ref/pgs-schema.json +170 -0
  60. package/skills/block_puzzle.aigameplay/ref/reducer.template.ts +182 -0
  61. package/skills/board_entity_sprite.aiimage/SKILL.md +255 -0
  62. package/skills/board_entity_sprite.aiimage/manifest.json +153 -0
  63. package/skills/board_entity_sprite.aiimage/ref/ProceduralCar.ts +357 -0
  64. package/skills/board_entity_sprite.aiimage/ref/car.png +0 -0
  65. package/skills/board_entity_sprite.aiimage/ref/car.webp +0 -0
  66. package/skills/bottom_ui_bar.aicomponent/SKILL.md +50 -0
  67. package/skills/bottom_ui_bar.aicomponent/manifest.json +31 -0
  68. package/skills/bottom_ui_bar.aicomponent/ref/GameBottomUI.ts +27 -0
  69. package/skills/bubble_shooter.aigameplay/SKILL.md +129 -0
  70. package/skills/bubble_shooter.aigameplay/manifest.json +181 -0
  71. package/skills/bubble_shooter.aigameplay/ref/pgs-schema.json +226 -0
  72. package/skills/bubble_shooter.aigameplay/ref/reducer.template.ts +228 -0
  73. package/skills/button_click_sfx.aiaudio/SKILL.md +59 -0
  74. package/skills/button_click_sfx.aiaudio/manifest.json +45 -0
  75. package/skills/button_click_sfx.aiaudio/ref/button_click.mp3 +0 -0
  76. package/skills/calm_piano.aiaudio/SKILL.md +68 -0
  77. package/skills/calm_piano.aiaudio/manifest.json +50 -0
  78. package/skills/camera_controller_3d.aicomponent/SKILL.md +100 -0
  79. package/skills/camera_controller_3d.aicomponent/manifest.json +52 -0
  80. package/skills/camera_controller_3d.aicomponent/ref/CameraController.ts +199 -0
  81. package/skills/camera_controller_3d.aicomponent/ref/OrbitControlsAdapter.ts +152 -0
  82. package/skills/candy_tile.aiimage/SKILL.md +62 -0
  83. package/skills/candy_tile.aiimage/manifest.json +49 -0
  84. package/skills/car_parking.aigameplay/SKILL.md +105 -0
  85. package/skills/car_parking.aigameplay/manifest.json +164 -0
  86. package/skills/car_parking.aigameplay/ref/pgs-schema.json +163 -0
  87. package/skills/car_parking.aigameplay/ref/reducer.template.ts +166 -0
  88. package/skills/castle.aiimage/SKILL.md +64 -0
  89. package/skills/castle.aiimage/manifest.json +48 -0
  90. package/skills/cheerful_ukulele.aiaudio/SKILL.md +72 -0
  91. package/skills/cheerful_ukulele.aiaudio/manifest.json +50 -0
  92. package/skills/click_sfx.aiaudio/SKILL.md +59 -0
  93. package/skills/click_sfx.aiaudio/manifest.json +45 -0
  94. package/skills/click_sfx.aiaudio/ref/click.mp3 +0 -0
  95. package/skills/combo_display.aicomponent/SKILL.md +45 -0
  96. package/skills/combo_display.aicomponent/manifest.json +31 -0
  97. package/skills/combo_display.aicomponent/ref/ComboManager.ts +362 -0
  98. package/skills/combo_display.aicomponent/ref/ComboSmallUI.ts +232 -0
  99. package/skills/combo_praise_text.aicomponent/SKILL.md +56 -0
  100. package/skills/combo_praise_text.aicomponent/manifest.json +34 -0
  101. package/skills/combo_praise_text.aicomponent/ref/ComboManager.ts +362 -0
  102. package/skills/countdown_timer.aicomponent/SKILL.md +44 -0
  103. package/skills/countdown_timer.aicomponent/manifest.json +35 -0
  104. package/skills/countdown_timer.aicomponent/ref/CountdownDisplay.ts +213 -0
  105. package/skills/cta_platform_config.aiconfig/SKILL.md +72 -0
  106. package/skills/cta_platform_config.aiconfig/manifest.json +56 -0
  107. package/skills/debug_overlay.aicomponent/SKILL.md +75 -0
  108. package/skills/debug_overlay.aicomponent/manifest.json +17 -0
  109. package/skills/debug_overlay.aicomponent/ref/DebugOverlay.ts +144 -0
  110. package/skills/desert.aiimage/SKILL.md +63 -0
  111. package/skills/desert.aiimage/manifest.json +49 -0
  112. package/skills/difficulty_curve_designer.aiconfig/SKILL.md +68 -0
  113. package/skills/difficulty_curve_designer.aiconfig/manifest.json +36 -0
  114. package/skills/digit_renderer.aicomponent/SKILL.md +43 -0
  115. package/skills/digit_renderer.aicomponent/manifest.json +25 -0
  116. package/skills/digit_renderer.aicomponent/ref/DigitRenderer.ts +237 -0
  117. package/skills/download_button.aicomponent/SKILL.md +44 -0
  118. package/skills/download_button.aicomponent/manifest.json +25 -0
  119. package/skills/download_button.aicomponent/ref/DownloadButton.ts +137 -0
  120. package/skills/draw_line_puzzle.aigameplay/SKILL.md +84 -0
  121. package/skills/draw_line_puzzle.aigameplay/manifest.json +152 -0
  122. package/skills/draw_line_puzzle.aigameplay/ref/pgs-schema.json +189 -0
  123. package/skills/draw_line_puzzle.aigameplay/ref/reducer.template.ts +194 -0
  124. package/skills/easy_to_hard.aiconfig/SKILL.md +52 -0
  125. package/skills/easy_to_hard.aiconfig/manifest.json +33 -0
  126. package/skills/eight_ball_pool.aigameplay/SKILL.md +104 -0
  127. package/skills/eight_ball_pool.aigameplay/manifest.json +152 -0
  128. package/skills/eight_ball_pool.aigameplay/ref/pgs-schema.json +205 -0
  129. package/skills/eight_ball_pool.aigameplay/ref/reducer.template.ts +198 -0
  130. package/skills/energetic_electronic.aiaudio/SKILL.md +69 -0
  131. package/skills/energetic_electronic.aiaudio/manifest.json +51 -0
  132. package/skills/fail_sfx.aiaudio/SKILL.md +59 -0
  133. package/skills/fail_sfx.aiaudio/manifest.json +44 -0
  134. package/skills/fail_sfx.aiaudio/ref/fail.mp3 +0 -0
  135. package/skills/figer_icon.aiimage/SKILL.md +58 -0
  136. package/skills/figer_icon.aiimage/manifest.json +48 -0
  137. package/skills/figer_icon.aiimage/ref/figer.png +0 -0
  138. package/skills/figer_icon.aiimage/ref/figer.webp +0 -0
  139. package/skills/forest.aiimage/SKILL.md +74 -0
  140. package/skills/forest.aiimage/manifest.json +48 -0
  141. package/skills/fruit_tile.aiimage/SKILL.md +68 -0
  142. package/skills/fruit_tile.aiimage/manifest.json +48 -0
  143. package/skills/game_over_panel.aicomponent/SKILL.md +47 -0
  144. package/skills/game_over_panel.aicomponent/manifest.json +61 -0
  145. package/skills/game_over_panel.aicomponent/ref/GameOverPanel.ts +74 -0
  146. package/skills/game_scene.aicomponent/SKILL.md +57 -0
  147. package/skills/game_scene.aicomponent/manifest.json +36 -0
  148. package/skills/game_scene.aicomponent/ref/Game.ts +748 -0
  149. package/skills/gameplay_balance_check.aivalidator/SKILL.md +69 -0
  150. package/skills/gameplay_balance_check.aivalidator/manifest.json +21 -0
  151. package/skills/gameplay_unit_test.aivalidator/SKILL.md +89 -0
  152. package/skills/gameplay_unit_test.aivalidator/manifest.json +17 -0
  153. package/skills/gameplay_unit_test.aivalidator/ref/gameplay.test.ts +202 -0
  154. package/skills/gameplay_unit_test.aivalidator/ref/vitest.config.ts +13 -0
  155. package/skills/grid_board_layout.aicomponent/SKILL.md +85 -0
  156. package/skills/grid_board_layout.aicomponent/manifest.json +69 -0
  157. package/skills/grid_board_layout.aicomponent/ref/BoardLayout.ts +416 -0
  158. package/skills/grid_board_layout.aicomponent/ref/BoardLayout3D.ts +125 -0
  159. package/skills/grid_board_layout.aicomponent/ref/BoardLayoutMath.ts +85 -0
  160. package/skills/grid_board_layout.aicomponent/ref/BoardRenderer3D.ts +298 -0
  161. package/skills/heart_lives.aicomponent/SKILL.md +42 -0
  162. package/skills/heart_lives.aicomponent/manifest.json +25 -0
  163. package/skills/heart_lives.aicomponent/ref/HeartDisplay.ts +96 -0
  164. package/skills/idle-breathe.aicomponent/SKILL.md +27 -0
  165. package/skills/idle-breathe.aicomponent/manifest.json +20 -0
  166. package/skills/idle-breathe.aicomponent/ref/phaser.js +25 -0
  167. package/skills/idle-breathe.aicomponent/ref/playcanvas.js +29 -0
  168. package/skills/jewel_tile.aiimage/SKILL.md +63 -0
  169. package/skills/jewel_tile.aiimage/manifest.json +49 -0
  170. package/skills/knife_hit.aigameplay/SKILL.md +103 -0
  171. package/skills/knife_hit.aigameplay/manifest.json +151 -0
  172. package/skills/knife_hit.aigameplay/ref/pgs-schema.json +202 -0
  173. package/skills/knife_hit.aigameplay/ref/reducer.template.ts +196 -0
  174. package/skills/left_right_parkour.aigameplay/SKILL.md +120 -0
  175. package/skills/left_right_parkour.aigameplay/manifest.json +165 -0
  176. package/skills/left_right_parkour.aigameplay/ref/pgs-schema.json +200 -0
  177. package/skills/left_right_parkour.aigameplay/ref/reducer.template.ts +194 -0
  178. package/skills/level_data_pack.aiconfig/SKILL.md +64 -0
  179. package/skills/level_data_pack.aiconfig/manifest.json +37 -0
  180. package/skills/level_data_validator.aivalidator/SKILL.md +85 -0
  181. package/skills/level_data_validator.aivalidator/manifest.json +17 -0
  182. package/skills/level_data_validator.aivalidator/ref/LevelValidator.ts +113 -0
  183. package/skills/level_lifecycle.aicomponent/SKILL.md +81 -0
  184. package/skills/level_lifecycle.aicomponent/manifest.json +87 -0
  185. package/skills/level_lifecycle.aicomponent/ref/LevelLifecycle.ts +235 -0
  186. package/skills/level_solvability_validator.aivalidator/SKILL.md +74 -0
  187. package/skills/level_solvability_validator.aivalidator/manifest.json +23 -0
  188. package/skills/level_solvability_validator.aivalidator/ref/LevelValidator.ts +186 -0
  189. package/skills/level_state.aicomponent/SKILL.md +55 -0
  190. package/skills/level_state.aicomponent/manifest.json +34 -0
  191. package/skills/level_state.aicomponent/ref/LevelDataManager.ts +26 -0
  192. package/skills/level_state.aicomponent/ref/LevelManager.ts +26 -0
  193. package/skills/loading_screen.aicomponent/SKILL.md +57 -0
  194. package/skills/loading_screen.aicomponent/manifest.json +43 -0
  195. package/skills/loading_screen.aicomponent/ref/LoadingUI.ts +339 -0
  196. package/skills/lose_result_panel.aiimage/SKILL.md +58 -0
  197. package/skills/lose_result_panel.aiimage/manifest.json +47 -0
  198. package/skills/lose_result_panel.aiimage/ref/lose.png +0 -0
  199. package/skills/lose_result_panel.aiimage/ref/lose.webp +0 -0
  200. package/skills/lose_sfx.aiaudio/SKILL.md +59 -0
  201. package/skills/lose_sfx.aiaudio/manifest.json +45 -0
  202. package/skills/lose_sfx.aiaudio/ref/lose.mp3 +0 -0
  203. package/skills/match-pop.aicomponent/SKILL.md +29 -0
  204. package/skills/match-pop.aicomponent/manifest.json +19 -0
  205. package/skills/match-pop.aicomponent/ref/phaser.js +30 -0
  206. package/skills/match-pop.aicomponent/ref/playcanvas.js +22 -0
  207. package/skills/match3_core.aigameplay/SKILL.md +125 -0
  208. package/skills/match3_core.aigameplay/manifest.json +107 -0
  209. package/skills/match3_core.aigameplay/ref/pgs-schema.json +154 -0
  210. package/skills/match3_core.aigameplay/ref/reducer.template.ts +191 -0
  211. package/skills/match_engine.aicomponent/SKILL.md +84 -0
  212. package/skills/match_engine.aicomponent/manifest.json +23 -0
  213. package/skills/match_engine.aicomponent/ref/MatchEngine.ts +75 -0
  214. package/skills/memory_match.aigameplay/SKILL.md +111 -0
  215. package/skills/memory_match.aigameplay/manifest.json +164 -0
  216. package/skills/memory_match.aigameplay/ref/pgs-schema.json +190 -0
  217. package/skills/memory_match.aigameplay/ref/reducer.template.ts +162 -0
  218. package/skills/merge_core.aigameplay/SKILL.md +112 -0
  219. package/skills/merge_core.aigameplay/manifest.json +154 -0
  220. package/skills/merge_core.aigameplay/ref/pgs-schema.json +202 -0
  221. package/skills/merge_core.aigameplay/ref/reducer.template.ts +179 -0
  222. package/skills/mistake_sfx.aiaudio/SKILL.md +59 -0
  223. package/skills/mistake_sfx.aiaudio/manifest.json +45 -0
  224. package/skills/mistake_sfx.aiaudio/ref/mistake.mp3 +0 -0
  225. package/skills/nomove_hint_overlay.aiimage/SKILL.md +58 -0
  226. package/skills/nomove_hint_overlay.aiimage/manifest.json +48 -0
  227. package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.png +0 -0
  228. package/skills/nomove_hint_overlay.aiimage/ref/nomove_hint.webp +0 -0
  229. package/skills/normal_dot.aiimage/SKILL.md +58 -0
  230. package/skills/normal_dot.aiimage/manifest.json +46 -0
  231. package/skills/normal_dot.aiimage/ref/normal_dot.png +0 -0
  232. package/skills/normal_dot.aiimage/ref/normal_dot.webp +0 -0
  233. package/skills/ocean.aiimage/SKILL.md +71 -0
  234. package/skills/ocean.aiimage/manifest.json +49 -0
  235. package/skills/particle-confetti.aicomponent/SKILL.md +32 -0
  236. package/skills/particle-confetti.aicomponent/manifest.json +21 -0
  237. package/skills/particle-confetti.aicomponent/ref/html5-spritesheet.js +17 -0
  238. package/skills/particle-confetti.aicomponent/ref/phaser.js +38 -0
  239. package/skills/particle-explosion.aicomponent/SKILL.md +37 -0
  240. package/skills/particle-explosion.aicomponent/manifest.json +24 -0
  241. package/skills/particle-explosion.aicomponent/ref/html5-spritesheet.js +40 -0
  242. package/skills/particle-explosion.aicomponent/ref/phaser.js +46 -0
  243. package/skills/particle-explosion.aicomponent/ref/playcanvas.js +33 -0
  244. package/skills/particle-trail.aicomponent/SKILL.md +25 -0
  245. package/skills/particle-trail.aicomponent/manifest.json +22 -0
  246. package/skills/particle-trail.aicomponent/ref/phaser.js +31 -0
  247. package/skills/path_animation.aicomponent/SKILL.md +82 -0
  248. package/skills/path_animation.aicomponent/manifest.json +77 -0
  249. package/skills/path_animation.aicomponent/ref/AnimationManager.ts +694 -0
  250. package/skills/path_animation.aicomponent/ref/AnimationManager3D.ts +317 -0
  251. package/skills/path_elimination_rules.aigameplay/SKILL.md +88 -0
  252. package/skills/path_elimination_rules.aigameplay/manifest.json +119 -0
  253. package/skills/path_elimination_rules.aigameplay/ref/pgs-schema.json +227 -0
  254. package/skills/path_input_handler.aicomponent/SKILL.md +87 -0
  255. package/skills/path_input_handler.aicomponent/manifest.json +97 -0
  256. package/skills/path_input_handler.aicomponent/ref/InputHandler.ts +714 -0
  257. package/skills/path_input_handler.aicomponent/ref/InputHandler3D.ts +204 -0
  258. package/skills/path_renderer.aicomponent/SKILL.md +101 -0
  259. package/skills/path_renderer.aicomponent/manifest.json +69 -0
  260. package/skills/path_renderer.aicomponent/ref/PathRenderer.ts +509 -0
  261. package/skills/path_renderer.aicomponent/ref/PathRenderer3D.ts +176 -0
  262. package/skills/path_renderer.aicomponent/ref/PathRenderers.ts +640 -0
  263. package/skills/phaser.aicomponent/SKILL.md +315 -0
  264. package/skills/phaser.aicomponent/manifest.json +156 -0
  265. package/skills/phaser.aicomponent/ref/BootScene.ts +29 -0
  266. package/skills/phaser.aicomponent/ref/GameConfig.ts +29 -0
  267. package/skills/phaser.aicomponent/ref/GameScene.ts +88 -0
  268. package/skills/phaser.aicomponent/ref/PreloaderScene.ts +78 -0
  269. package/skills/phaser.aicomponent/ref/SceneKeys.ts +7 -0
  270. package/skills/phaser.aicomponent/ref/SoundUtils.ts +21 -0
  271. package/skills/phaser.aicomponent/ref/UiLayout.ts +74 -0
  272. package/skills/phaser.aicomponent/ref/globals.d.ts +52 -0
  273. package/skills/phaser.aicomponent/ref/index.css +40 -0
  274. package/skills/phaser.aicomponent/ref/index.html +14 -0
  275. package/skills/phaser.aicomponent/ref/index.ts +48 -0
  276. package/skills/phaser.aicomponent/ref/main.ts +16 -0
  277. package/skills/phaser.aicomponent/ref/package.json +22 -0
  278. package/skills/phaser.aicomponent/ref/tsconfig.json +25 -0
  279. package/skills/phaser.aicomponent/ref/webpack.config.js +57 -0
  280. package/skills/phaser_scene_lifecycle.aicomponent/SKILL.md +63 -0
  281. package/skills/phaser_scene_lifecycle.aicomponent/manifest.json +33 -0
  282. package/skills/pick_and_match_rules.aigameplay/SKILL.md +113 -0
  283. package/skills/pick_and_match_rules.aigameplay/manifest.json +121 -0
  284. package/skills/pick_and_match_rules.aigameplay/ref/pgs-schema.json +354 -0
  285. package/skills/pin_pull.aigameplay/SKILL.md +110 -0
  286. package/skills/pin_pull.aigameplay/manifest.json +164 -0
  287. package/skills/pin_pull.aigameplay/ref/pgs-schema.json +201 -0
  288. package/skills/pin_pull.aigameplay/ref/reducer.template.ts +216 -0
  289. package/skills/playable_app_logo.aiimage/SKILL.md +58 -0
  290. package/skills/playable_app_logo.aiimage/manifest.json +47 -0
  291. package/skills/playable_app_logo.aiimage/ref/logo.png +0 -0
  292. package/skills/playable_app_logo.aiimage/ref/logo.webp +0 -0
  293. package/skills/playable_end_screen_layout.aicomponent/SKILL.md +75 -0
  294. package/skills/playable_end_screen_layout.aicomponent/manifest.json +24 -0
  295. package/skills/playable_guidance_layer.aicomponent/SKILL.md +89 -0
  296. package/skills/playable_guidance_layer.aicomponent/manifest.json +24 -0
  297. package/skills/playable_hud_layout.aicomponent/SKILL.md +96 -0
  298. package/skills/playable_hud_layout.aicomponent/manifest.json +24 -0
  299. package/skills/playable_scripts_build.aicomponent/SKILL.md +69 -0
  300. package/skills/playable_scripts_build.aicomponent/manifest.json +53 -0
  301. package/skills/playable_scripts_build.aicomponent/ref/builds.config.js +257 -0
  302. package/skills/playcraft-3d-flip-sprite/SKILL.md +336 -0
  303. package/skills/playcraft-3d-flip-sprite/renderer/flatten_glb.mjs +62 -0
  304. package/skills/playcraft-3d-flip-sprite/renderer/render.mjs +325 -0
  305. package/skills/playcraft-3d-flip-sprite/renderer/render_single.mjs +138 -0
  306. package/skills/playcraft-asset-management/SKILL.md +73 -0
  307. package/skills/playcraft-audio-generation/SKILL.md +126 -0
  308. package/skills/playcraft-build/SKILL.md +44 -0
  309. package/skills/playcraft-code-editor/SKILL.md +71 -0
  310. package/skills/playcraft-create-remix/SKILL.md +62 -0
  311. package/skills/playcraft-deploy/SKILL.md +59 -0
  312. package/skills/playcraft-image-generation/SKILL.md +148 -0
  313. package/skills/playcraft-image-processing/SKILL.md +216 -0
  314. package/skills/playcraft-platform-intro/SKILL.md +41 -0
  315. package/skills/playcraft-prefab/SKILL.md +98 -0
  316. package/skills/playcraft-project-management/SKILL.md +57 -0
  317. package/skills/playcraft-remix-workflow/SKILL.md +119 -0
  318. package/skills/playcraft-remix-workflow/references/xplatform.schema.json5 +31 -0
  319. package/skills/playcraft-save/SKILL.md +46 -0
  320. package/skills/playcraft-skill-recommender/SKILL.md +152 -0
  321. package/skills/playcraft-sprite-generation/SKILL.md +534 -0
  322. package/skills/playcraft-sprite-remix/SKILL.md +155 -0
  323. package/skills/playcraft-sprite-sheet/SKILL.md +97 -0
  324. package/skills/playtest_report.aivalidator/SKILL.md +103 -0
  325. package/skills/playtest_report.aivalidator/manifest.json +21 -0
  326. package/skills/preloader_scene.aicomponent/SKILL.md +58 -0
  327. package/skills/preloader_scene.aicomponent/manifest.json +43 -0
  328. package/skills/preloader_scene.aicomponent/ref/Preloader.ts +339 -0
  329. package/skills/progress_bar.aicomponent/SKILL.md +38 -0
  330. package/skills/progress_bar.aicomponent/manifest.json +25 -0
  331. package/skills/progress_bar.aicomponent/ref/ProgressDisplay.ts +140 -0
  332. package/skills/references/xplatform.schema.json5 +31 -0
  333. package/skills/responsive_2d_layout.aicomponent/SKILL.md +161 -0
  334. package/skills/responsive_2d_layout.aicomponent/manifest.json +43 -0
  335. package/skills/responsive_2d_layout.aicomponent/ref/UiLayout.ts +56 -0
  336. package/skills/run_context_state.aicomponent/SKILL.md +54 -0
  337. package/skills/run_context_state.aicomponent/manifest.json +40 -0
  338. package/skills/run_context_state.aicomponent/ref/RunContextRuntime.ts +30 -0
  339. package/skills/score-fly.aicomponent/SKILL.md +31 -0
  340. package/skills/score-fly.aicomponent/manifest.json +21 -0
  341. package/skills/score-fly.aicomponent/ref/phaser.js +26 -0
  342. package/skills/score-fly.aicomponent/ref/playcanvas.js +28 -0
  343. package/skills/score_goal.aiconfig/SKILL.md +46 -0
  344. package/skills/score_goal.aiconfig/manifest.json +33 -0
  345. package/skills/screen-flash.aicomponent/SKILL.md +30 -0
  346. package/skills/screen-flash.aicomponent/manifest.json +20 -0
  347. package/skills/screen-flash.aicomponent/ref/phaser.js +48 -0
  348. package/skills/screen-shake.aicomponent/SKILL.md +30 -0
  349. package/skills/screen-shake.aicomponent/manifest.json +19 -0
  350. package/skills/screen-shake.aicomponent/ref/phaser.js +23 -0
  351. package/skills/screen-shake.aicomponent/ref/playcanvas.js +44 -0
  352. package/skills/screw_puzzle.aigameplay/SKILL.md +116 -0
  353. package/skills/screw_puzzle.aigameplay/manifest.json +164 -0
  354. package/skills/screw_puzzle.aigameplay/ref/pgs-schema.json +235 -0
  355. package/skills/screw_puzzle.aigameplay/ref/reducer.template.ts +213 -0
  356. package/skills/settings_state.aicomponent/SKILL.md +61 -0
  357. package/skills/settings_state.aicomponent/manifest.json +33 -0
  358. package/skills/settings_state.aicomponent/ref/SettingsManager.ts +130 -0
  359. package/skills/slide_out_to_tray_animation.aicomponent/SKILL.md +64 -0
  360. package/skills/slide_out_to_tray_animation.aicomponent/manifest.json +58 -0
  361. package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager.ts +164 -0
  362. package/skills/slide_out_to_tray_animation.aicomponent/ref/AnimationManager3D.ts +198 -0
  363. package/skills/slide_out_to_tray_animation.aicomponent/ref/BezierUtils.ts +59 -0
  364. package/skills/slot_machine.aigameplay/SKILL.md +119 -0
  365. package/skills/slot_machine.aigameplay/manifest.json +166 -0
  366. package/skills/slot_machine.aigameplay/ref/pgs-schema.json +212 -0
  367. package/skills/slot_machine.aigameplay/ref/reducer.template.ts +212 -0
  368. package/skills/sniper_shot.aigameplay/SKILL.md +84 -0
  369. package/skills/sniper_shot.aigameplay/manifest.json +153 -0
  370. package/skills/sniper_shot.aigameplay/ref/pgs-schema.json +211 -0
  371. package/skills/sniper_shot.aigameplay/ref/reducer.template.ts +211 -0
  372. package/skills/solitaire.aigameplay/SKILL.md +101 -0
  373. package/skills/solitaire.aigameplay/manifest.json +151 -0
  374. package/skills/solitaire.aigameplay/ref/pgs-schema.json +200 -0
  375. package/skills/solitaire.aigameplay/ref/reducer.template.ts +176 -0
  376. package/skills/sound-effects/SKILL.md +46 -0
  377. package/skills/sound_utils.aicomponent/SKILL.md +52 -0
  378. package/skills/sound_utils.aicomponent/manifest.json +30 -0
  379. package/skills/sound_utils.aicomponent/ref/SoundUtils.ts +29 -0
  380. package/skills/sprite-animation-2d.aicomponent/SKILL.md +45 -0
  381. package/skills/sprite-animation-2d.aicomponent/manifest.json +28 -0
  382. package/skills/sprite-animation-2d.aicomponent/ref/html5.js +83 -0
  383. package/skills/sprite-animation-2d.aicomponent/ref/phaser.js +38 -0
  384. package/skills/sprite-animation-2d.aicomponent/ref/playcanvas.js +67 -0
  385. package/skills/sprite_entity_renderer.aicomponent/SKILL.md +148 -0
  386. package/skills/sprite_entity_renderer.aicomponent/manifest.json +17 -0
  387. package/skills/sprite_entity_renderer.aicomponent/ref/SpriteEntityRenderer.ts +126 -0
  388. package/skills/success_sfx.aiaudio/SKILL.md +59 -0
  389. package/skills/success_sfx.aiaudio/manifest.json +45 -0
  390. package/skills/success_sfx.aiaudio/ref/success.mp3 +0 -0
  391. package/skills/tap_blast.aigameplay/SKILL.md +116 -0
  392. package/skills/tap_blast.aigameplay/manifest.json +153 -0
  393. package/skills/tap_blast.aigameplay/ref/pgs-schema.json +208 -0
  394. package/skills/tap_blast.aigameplay/ref/reducer.template.ts +202 -0
  395. package/skills/theme_state.aicomponent/SKILL.md +53 -0
  396. package/skills/theme_state.aicomponent/manifest.json +33 -0
  397. package/skills/theme_state.aicomponent/ref/ThemeManager.ts +174 -0
  398. package/skills/theme_switcher_build.aicomponent/SKILL.md +62 -0
  399. package/skills/theme_switcher_build.aicomponent/manifest.json +38 -0
  400. package/skills/theme_switcher_build.aicomponent/ref/theme-index.ts +8 -0
  401. package/skills/theme_variant.aiconfig/SKILL.md +78 -0
  402. package/skills/theme_variant.aiconfig/manifest.json +39 -0
  403. package/skills/theme_variant.aiconfig/ref/ExampleTheme/index.ts +16 -0
  404. package/skills/theme_variant.aiconfig/ref/ExampleTheme/levelEasy.json +141 -0
  405. package/skills/threejs.aicomponent/SKILL.md +422 -0
  406. package/skills/threejs.aicomponent/manifest.json +166 -0
  407. package/skills/threejs.aicomponent/ref/AssetLoader.ts +158 -0
  408. package/skills/threejs.aicomponent/ref/BaseScene.ts +88 -0
  409. package/skills/threejs.aicomponent/ref/GameConfig.ts +47 -0
  410. package/skills/threejs.aicomponent/ref/MainScene.ts +170 -0
  411. package/skills/threejs.aicomponent/ref/PreloaderScene.ts +93 -0
  412. package/skills/threejs.aicomponent/ref/SceneKeys.ts +6 -0
  413. package/skills/threejs.aicomponent/ref/SceneManager.ts +69 -0
  414. package/skills/threejs.aicomponent/ref/ViewportManager.ts +62 -0
  415. package/skills/threejs.aicomponent/ref/globals.d.ts +74 -0
  416. package/skills/threejs.aicomponent/ref/index.css +80 -0
  417. package/skills/threejs.aicomponent/ref/index.html +20 -0
  418. package/skills/threejs.aicomponent/ref/index.ts +117 -0
  419. package/skills/threejs.aicomponent/ref/main.ts +10 -0
  420. package/skills/threejs.aicomponent/ref/package.json +23 -0
  421. package/skills/threejs.aicomponent/ref/tsconfig.json +24 -0
  422. package/skills/threejs.aicomponent/ref/webpack.config.js +61 -0
  423. package/skills/time_clear_goal.aiconfig/SKILL.md +46 -0
  424. package/skills/time_clear_goal.aiconfig/manifest.json +32 -0
  425. package/skills/time_icon.aiimage/SKILL.md +58 -0
  426. package/skills/time_icon.aiimage/manifest.json +47 -0
  427. package/skills/time_icon.aiimage/ref/time.png +0 -0
  428. package/skills/time_icon.aiimage/ref/time.webp +0 -0
  429. package/skills/top_ui_bar.aicomponent/SKILL.md +45 -0
  430. package/skills/top_ui_bar.aicomponent/manifest.json +27 -0
  431. package/skills/top_ui_bar.aicomponent/ref/GameTopUI.ts +229 -0
  432. package/skills/tower_defence.aigameplay/SKILL.md +117 -0
  433. package/skills/tower_defence.aigameplay/manifest.json +175 -0
  434. package/skills/tower_defence.aigameplay/ref/pgs-schema.json +247 -0
  435. package/skills/tower_defence.aigameplay/ref/reducer.template.ts +239 -0
  436. package/skills/tray_container.aicomponent/SKILL.md +143 -0
  437. package/skills/tray_container.aicomponent/manifest.json +58 -0
  438. package/skills/tray_container.aicomponent/ref/TrayRenderer.ts +155 -0
  439. package/skills/tray_container.aicomponent/ref/TrayRenderer3D.ts +281 -0
  440. package/skills/tray_container.aicomponent/ref/TrayRendererHtmlOverlay.ts +228 -0
  441. package/skills/tutorial_overlay.aicomponent/SKILL.md +46 -0
  442. package/skills/tutorial_overlay.aicomponent/manifest.json +34 -0
  443. package/skills/tutorial_overlay.aicomponent/ref/TutorialManager.ts +367 -0
  444. package/skills/tween-animation-2d.aicomponent/SKILL.md +35 -0
  445. package/skills/tween-animation-2d.aicomponent/manifest.json +28 -0
  446. package/skills/tween-animation-2d.aicomponent/ref/phaser.js +49 -0
  447. package/skills/tween-animation-2d.aicomponent/ref/playcanvas.js +36 -0
  448. package/skills/typescript_module_patterns.aicomponent/SKILL.md +209 -0
  449. package/skills/typescript_module_patterns.aicomponent/manifest.json +28 -0
  450. package/skills/typescript_module_patterns.aicomponent/ref/globals.d.ts +31 -0
  451. package/skills/ui-transition.aicomponent/SKILL.md +33 -0
  452. package/skills/ui-transition.aicomponent/manifest.json +19 -0
  453. package/skills/ui-transition.aicomponent/ref/phaser.js +45 -0
  454. package/skills/ux_flow_spec.aiconfig/SKILL.md +82 -0
  455. package/skills/ux_flow_spec.aiconfig/manifest.json +39 -0
  456. package/skills/wave_difficulty.aiconfig/SKILL.md +46 -0
  457. package/skills/wave_difficulty.aiconfig/manifest.json +33 -0
  458. package/skills/webpack_build.aicomponent/SKILL.md +204 -0
  459. package/skills/webpack_build.aicomponent/manifest.json +29 -0
  460. package/skills/webpack_build.aicomponent/ref/package.json +16 -0
  461. package/skills/webpack_build.aicomponent/ref/webpack.config.js +53 -0
  462. package/skills/win_anim_sfx.aiaudio/SKILL.md +59 -0
  463. package/skills/win_anim_sfx.aiaudio/manifest.json +46 -0
  464. package/skills/win_anim_sfx.aiaudio/ref/win_anim.mp3 +0 -0
  465. package/skills/win_dot.aiimage/SKILL.md +58 -0
  466. package/skills/win_dot.aiimage/manifest.json +47 -0
  467. package/skills/win_dot.aiimage/ref/win_dot.png +0 -0
  468. package/skills/win_dot.aiimage/ref/win_dot.webp +0 -0
  469. package/skills/win_result_panel.aiimage/SKILL.md +58 -0
  470. package/skills/win_result_panel.aiimage/manifest.json +47 -0
  471. package/skills/win_result_panel.aiimage/ref/win.png +0 -0
  472. package/skills/win_result_panel.aiimage/ref/win.webp +0 -0
  473. package/skills/word_connect.aigameplay/SKILL.md +86 -0
  474. package/skills/word_connect.aigameplay/manifest.json +154 -0
  475. package/skills/word_connect.aigameplay/ref/pgs-schema.json +212 -0
  476. package/skills/word_connect.aigameplay/ref/reducer.template.ts +186 -0
  477. package/src/index.ts +10 -0
  478. package/src/skills.loader.ts +225 -0
  479. package/src/skills.types.ts +42 -0
@@ -0,0 +1,84 @@
1
+ ---
2
+ name: match_engine.aicomponent
3
+ description: 通用篮子匹配引擎。纯函数实现,无 Phaser 依赖。提供同类聚合插入、N消检测、移除、满溢判断。通过 groupKey 回调函数确定匹配分组,支持单维度(颜色)和多维度(颜色×形状)匹配。
4
+ triggers: 需要篮子匹配逻辑、三消检测、同类聚合插入时触发。
5
+ ---
6
+
7
+ # 通用篮子匹配引擎(Match Engine)
8
+
9
+ ## 说明
10
+
11
+ 纯逻辑组件,**零 Phaser 依赖**,可独立单元测试。提供篮子中物品的核心操作:
12
+
13
+ - **同类聚合插入**:新物品插到最后一个同类物品旁边(非追加末尾)
14
+ - **N 消检测**:检查是否有 N 个同类物品,返回匹配列表
15
+ - **移除**:从篮子中删除匹配物品
16
+ - **满溢判断**:当前数量是否达到容量上限
17
+
18
+ ## Scaffold
19
+
20
+ | 目标路径 | 来源 | 说明 |
21
+ |---------|-----|------|
22
+ | `src/game/logic/MatchEngine.ts` | `ref/MatchEngine.ts` | 匹配引擎 |
23
+
24
+ ## Recipe
25
+
26
+ | 决策 | 原因 |
27
+ |------|------|
28
+ | **纯函数 + 零依赖** | 匹配逻辑不依赖 Phaser 或 DOM,可在 Node.js 中单元测试;同一套 MatchEngine 可以在 Phaser 和 Three.js 渲染后端复用 |
29
+ | **静态方法类** | MatchEngine 是无状态算法集合,不需要实例化;静态方法调用更简洁,不需要传递 this |
30
+ | **groupKey 回调** | 分组依据(颜色 / 颜色+形状)由调用方决定,MatchEngine 不绑定具体字段;泛化设计支持多维度匹配扩展 |
31
+ | **同类聚合插入** | 新物品插到最后一个同类旁边(非追加末尾),符合三消类游戏标准交互模式,视觉反馈更直观 |
32
+
33
+ ## Adapter
34
+
35
+ - **Role**: `matchEngine` — 通用篮子同类聚合匹配引擎(纯逻辑,零渲染依赖)
36
+ - **Provides**: `MatchEngine` 静态类(`insertToTray()`、`checkMatch()`、`removeFromTray()`、`isTrayFull()`),`TrayItem` 类型
37
+ - **Requires**: 无(纯 TypeScript,零外部依赖)
38
+ - **Consumed by**: `game_scene.aicomponent`(pick_and_match 玩法中管理篮子逻辑)、`gameplay_unit_test.aivalidator`(匹配逻辑单元测试)
39
+ - **Integration point**: `src/game/logic/MatchEngine.ts` → `Game.ts` 在物品插入/消除时调用
40
+
41
+ ## Imports
42
+
43
+ 无(纯 TypeScript,零外部依赖)
44
+
45
+ ## 关键接口
46
+
47
+ ```typescript
48
+ interface TrayItem {
49
+ id: string;
50
+ color: string; // 或任意分组键
51
+ }
52
+
53
+ class MatchEngine {
54
+ static insertToTray(item: TrayItem, tray: TrayItem[]): { newTray: TrayItem[]; insertIndex: number };
55
+ static checkMatch(tray: TrayItem[], matchCount?: number): TrayItem[];
56
+ static removeFromTray(tray: TrayItem[], matchedIds: string[]): TrayItem[];
57
+ static isTrayFull(tray: TrayItem[], capacity: number): boolean;
58
+ }
59
+ ```
60
+
61
+ ## 配置
62
+
63
+ | 参数 | 默认 | 说明 |
64
+ |------|------|------|
65
+ | matchCount | 3 | 消除所需的同类数量 |
66
+ | groupKey | `item.color` | 分组依据字段 |
67
+
68
+ ## 使用示例
69
+
70
+ ```typescript
71
+ // 插入
72
+ const { newTray, insertIndex } = MatchEngine.insertToTray(item, tray);
73
+
74
+ // 检测匹配
75
+ const matched = MatchEngine.checkMatch(newTray);
76
+ if (matched.length > 0) {
77
+ const finalTray = MatchEngine.removeFromTray(newTray, matched.map(m => m.id));
78
+ }
79
+
80
+ // 满溢检查
81
+ if (MatchEngine.isTrayFull(newTray, 7)) {
82
+ // 游戏失败
83
+ }
84
+ ```
@@ -0,0 +1,23 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "atomId": "match_engine.aicomponent",
4
+ "bundleType": "aicomponent",
5
+ "category": "logic",
6
+ "mode": "fixed",
7
+ "label": {
8
+ "zh": "通用篮子匹配引擎(N消检测)",
9
+ "en": "Generic tray match engine (N-match detection)"
10
+ },
11
+ "tags": ["logic", "match", "tray", "engine", "match-3", "grouping", "eliminate", "pure-function"],
12
+ "bindingRoles": ["matchEngine"],
13
+ "imports": [],
14
+ "binding": {
15
+ "role": "matchEngine",
16
+ "target": "src/game/logic/MatchEngine.ts",
17
+ "type": "code-module-reference"
18
+ },
19
+ "files": {
20
+ "skill": "SKILL.md",
21
+ "ref": ["ref/MatchEngine.ts"]
22
+ }
23
+ }
@@ -0,0 +1,75 @@
1
+ import type { TrayItem, CarColor } from "./types";
2
+ import { GameConfig } from "../GameConfig";
3
+
4
+ /**
5
+ * 篮子匹配引擎
6
+ * 同类聚合插入 + 3 消检测
7
+ */
8
+ export class MatchEngine {
9
+ /**
10
+ * 将物品插入篮子(同类聚合:新物品插到最后一个同色物品旁边)
11
+ */
12
+ static insertToTray(
13
+ item: TrayItem,
14
+ tray: TrayItem[],
15
+ ): { newTray: TrayItem[]; insertIndex: number } {
16
+ const newTray = [...tray];
17
+
18
+ // 寻找最后一个同色物品的位置
19
+ let lastSameColorIndex = -1;
20
+ for (let i = newTray.length - 1; i >= 0; i--) {
21
+ if (newTray[i].color === item.color) {
22
+ lastSameColorIndex = i;
23
+ break;
24
+ }
25
+ }
26
+
27
+ let insertIndex: number;
28
+ if (lastSameColorIndex >= 0) {
29
+ insertIndex = lastSameColorIndex + 1;
30
+ newTray.splice(insertIndex, 0, item);
31
+ } else {
32
+ insertIndex = newTray.length;
33
+ newTray.push(item);
34
+ }
35
+
36
+ return { newTray, insertIndex };
37
+ }
38
+
39
+ /**
40
+ * 检测篮子中是否有 3 个同色物品
41
+ * @returns 匹配的物品列表(空数组表示无匹配)
42
+ */
43
+ static checkMatch(tray: TrayItem[]): TrayItem[] {
44
+ const colorCount = new Map<CarColor, TrayItem[]>();
45
+
46
+ for (const item of tray) {
47
+ const list = colorCount.get(item.color) || [];
48
+ list.push(item);
49
+ colorCount.set(item.color, list);
50
+ }
51
+
52
+ for (const [, items] of colorCount) {
53
+ if (items.length >= GameConfig.MATCH_COUNT) {
54
+ return items.slice(0, GameConfig.MATCH_COUNT);
55
+ }
56
+ }
57
+
58
+ return [];
59
+ }
60
+
61
+ /**
62
+ * 从篮子中移除匹配的物品
63
+ */
64
+ static removeFromTray(tray: TrayItem[], matchedIds: string[]): TrayItem[] {
65
+ const idSet = new Set(matchedIds);
66
+ return tray.filter(item => !idSet.has(item.id));
67
+ }
68
+
69
+ /**
70
+ * 判断篮子是否已满
71
+ */
72
+ static isTrayFull(tray: TrayItem[], capacity: number): boolean {
73
+ return tray.length >= capacity;
74
+ }
75
+ }
@@ -0,0 +1,111 @@
1
+ ---
2
+ name: memory_match.aigameplay
3
+ description: 记忆翻牌配对玩法封包 - 经典记忆游戏,翻开卡牌找到所有匹配对,以最少翻牌次数通关
4
+ triggers: 记忆,memory,翻牌,flip,配对,match,pair,卡牌,card,寻找,find,格子,grid,消除,eliminate
5
+ ---
6
+
7
+ # memory_match.aigameplay
8
+
9
+ 记忆翻牌配对玩法封包。实现经典记忆配对规则的 PGS JSON 和 reducer,玩家翻开卡牌寻找图案相同的一对,所有对子找到后游戏胜利,以最少翻牌次数为优化目标。
10
+
11
+ ## Recipe
12
+
13
+ - **玩法类型**:memory_match(记忆翻牌配对)
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
+ - `gridCols × gridRows`: 4×4(默认16张牌,8对)
19
+ - `maxFaceUpCount`: 2(同时最多翻开2张)
20
+ - `flipBackDelayMs`: 1000(两张不匹配时延迟1秒后翻回)
21
+ - `matchCondition`: 两张 face_up 状态的牌 pairId 相同则配对成功
22
+ - `winCondition`: 所有牌变为 matched 状态
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
+ - 计时模式:添加 `timeLimitSeconds` 限制游戏时间
31
+ - 更大网格:修改 `gridCols/gridRows`,如 6×6=36张牌
32
+ - 三元配对:修改为每组3张相同,`maxFaceUpCount: 3`
33
+
34
+ ## Result
35
+
36
+ - **产物文件**:`reducer.ts`
37
+ - **格式**:TypeScript,导出 `init(config)`、`dispatch(action)`、`getState()` + 分步函数接口
38
+ - **验证**:所有 testCases 必须通过
39
+
40
+ ## 渲染集成(⚠️ 场景层必读)
41
+
42
+ ### 设计原则:逻辑与动画分离
43
+
44
+ reducer 提供两套接口:
45
+
46
+ | 接口 | 适用场景 | 特点 |
47
+ |------|---------|------|
48
+ | `dispatch()` | 无头测试、AI 模拟、跳过动画 | 一步到位,只返回最终状态 |
49
+ | 分步函数 | **渲染层/GameScene** | 逐步执行,返回中间过程数据 |
50
+
51
+ ### ⚠️ 翻牌动画必须使用分步函数驱动
52
+
53
+ 正确做法是**分步驱动动画链**:
54
+
55
+ ```ts
56
+ // ✅ 正确做法:逐步调用分步函数,每步之间插入动画
57
+ // Step 1: 翻开卡牌(逻辑更新)
58
+ const newState = flipCard(state, cardId);
59
+ await playFlipAnimation(cardId, 'face_up'); // 播放翻牌动画(旋转180°)
60
+
61
+ // Step 2: 检查配对
62
+ const matchResult = checkMatch(newState);
63
+ if (matchResult.isMatch) {
64
+ // 配对成功:播放消除/高亮动画
65
+ await playMatchAnimation(matchResult.cardIds);
66
+ } else if (matchResult.shouldFlipBack) {
67
+ // 两张牌都已翻开但不匹配:延迟后翻回
68
+ await delay(flipBackDelayMs);
69
+ const flippedState = flipBackMismatched(newState);
70
+ await playFlipAnimation(matchResult.cardIds, 'face_down'); // 翻回动画
71
+ }
72
+
73
+ // Step 3: 检测胜利
74
+ if (checkWin(newState)) { showWinPanel(); }
75
+ ```
76
+
77
+ ### 分步函数返回值与动画映射
78
+
79
+ | 分步函数 | 返回值 | 场景层动画 |
80
+ |---------|--------|-----------|
81
+ | `flipCard()` | `MemoryMatchState` | 对目标卡牌播放翻转 Tween(Y轴旋转180°)|
82
+ | `checkMatch()` | `{ isMatch, cardIds, shouldFlipBack }` | 匹配→高亮动画;不匹配→等待后翻回 |
83
+ | `flipBackMismatched()` | `MemoryMatchState` | 对两张牌播放翻回动画 |
84
+ | `checkWin()` | `boolean` | 触发所有牌欢庆动画 + 胜利面板 |
85
+
86
+ ## Binding
87
+
88
+ - **Binding Role**:`gameplayRule`
89
+ - **挂载目标**:`game/gameplay/memory_match/reducer.ts`
90
+ - **引用类型**:`gameplay-module-reference`
91
+ - **接口契约**:`init(config)` / `dispatch(state, action)` / `getState(state)` / `flipCard(cardId)` / `checkMatch()` / `flipBackMismatched()` / `checkWin()`
92
+
93
+ ## Skill Definition
94
+
95
+ tools:
96
+ - bash
97
+ - write
98
+ - read
99
+ prompt_extension: |
100
+ You are implementing a memory match card gameplay module following the PGS specification.
101
+ Write the PGS JSON with entities (cards with id/pairId/state, board, moves_count, matched_pairs),
102
+ rules (flip_card, check_pair, flip_back, win_check), algorithm, and testCases
103
+ (at least 3: match success, mismatch, win condition).
104
+ Implement reducer.ts with:
105
+ - init/dispatch/getState (一体化接口,用于测试)
106
+ - flipCard/checkMatch/flipBackMismatched/checkWin (分步函数,用于渲染层动画驱动)
107
+ Card states: face_down → face_up → matched (or face_down on mismatch).
108
+ Maximum 2 cards face_up at once. If already 2 face_up, reject new flip.
109
+ Win: all pairs matched (all cards in 'matched' state).
110
+ Run all testCases to verify logic before finalizing.
111
+ Apply the Binding to wire the reducer into the game's gameplay module path.
@@ -0,0 +1,164 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "atomId": "memory_match.aigameplay",
4
+ "bundleType": "aigameplay",
5
+ "category": "gameplay",
6
+ "mode": "fixed",
7
+ "label": {
8
+ "zh": "记忆翻牌配对玩法",
9
+ "en": "Memory Match Card gameplay"
10
+ },
11
+ "tags": [
12
+ "gameplay",
13
+ "memory",
14
+ "cards",
15
+ "match",
16
+ "casual",
17
+ "puzzle"
18
+ ],
19
+ "bindingRoles": [
20
+ "gameplayRule"
21
+ ],
22
+ "imports": [
23
+ {
24
+ "slot": "engine",
25
+ "pinAtomId": "phaser.aicomponent",
26
+ "edgeKind": "requires",
27
+ "bindAs": "engine"
28
+ },
29
+ {
30
+ "slot": "bgMusic",
31
+ "description": "背景循环音乐",
32
+ "bindAs": "bgm",
33
+ "required": false,
34
+ "edgeKind": "compatibleWith",
35
+ "matchBindingRoles": [
36
+ "bgMusic"
37
+ ],
38
+ "allowedBundleTypes": [
39
+ "aiaudio"
40
+ ],
41
+ "constraints": {
42
+ "loop": true
43
+ }
44
+ },
45
+ {
46
+ "slot": "cardFaces",
47
+ "description": "卡牌正面贴图集",
48
+ "bindAs": "cardFaces",
49
+ "required": false,
50
+ "edgeKind": "compatibleWith",
51
+ "matchBindingRoles": [
52
+ "tileTextureSet"
53
+ ],
54
+ "allowedBundleTypes": [
55
+ "aiimage"
56
+ ]
57
+ },
58
+ {
59
+ "slot": "background",
60
+ "description": "游戏背景图",
61
+ "bindAs": "bg",
62
+ "required": false,
63
+ "edgeKind": "compatibleWith",
64
+ "matchBindingRoles": [
65
+ "backgroundTexture"
66
+ ],
67
+ "allowedBundleTypes": [
68
+ "aiimage"
69
+ ]
70
+ },
71
+ {
72
+ "slot": "tutorial",
73
+ "description": "新手引导浮层",
74
+ "bindAs": "tutorial",
75
+ "required": false,
76
+ "edgeKind": "compatibleWith",
77
+ "matchBindingRoles": [
78
+ "tutorialOverlay"
79
+ ],
80
+ "allowedBundleTypes": [
81
+ "aicomponent"
82
+ ]
83
+ },
84
+ {
85
+ "slot": "winPanel",
86
+ "description": "通关反馈面板视觉",
87
+ "bindAs": "winPanel",
88
+ "required": false,
89
+ "edgeKind": "compatibleWith",
90
+ "matchBindingRoles": [
91
+ "successFeedbackPanel"
92
+ ],
93
+ "allowedBundleTypes": [
94
+ "aiimage"
95
+ ]
96
+ },
97
+ {
98
+ "slot": "losePanel",
99
+ "description": "失败反馈面板视觉",
100
+ "bindAs": "losePanel",
101
+ "required": false,
102
+ "edgeKind": "compatibleWith",
103
+ "matchBindingRoles": [
104
+ "failFeedbackPanel"
105
+ ],
106
+ "allowedBundleTypes": [
107
+ "aiimage"
108
+ ]
109
+ },
110
+ {
111
+ "slot": "endScreen",
112
+ "description": "可玩广告结算屏(含 CTA 按钮)",
113
+ "bindAs": "endScreen",
114
+ "required": false,
115
+ "edgeKind": "compatibleWith",
116
+ "matchBindingRoles": [
117
+ "playableEndScreenLayout"
118
+ ],
119
+ "allowedBundleTypes": [
120
+ "aicomponent"
121
+ ]
122
+ }
123
+ ],
124
+ "generation": {
125
+ "kind": "pgs",
126
+ "pgsVersion": "1.0",
127
+ "gameplayType": "memory_match",
128
+ "rules": {
129
+ "gridCols": 4,
130
+ "gridRows": 4,
131
+ "pairCount": 8,
132
+ "maxFaceUpCount": 2,
133
+ "flipBackDelayMs": 1000
134
+ }
135
+ },
136
+ "result": {
137
+ "outputFile": "reducer.ts",
138
+ "format": "typescript",
139
+ "constraints": {
140
+ "testCasesMustPass": true
141
+ }
142
+ },
143
+ "binding": {
144
+ "role": "gameplayRule",
145
+ "target": "game/gameplay/memory_match/reducer.ts",
146
+ "type": "gameplay-module-reference",
147
+ "constraints": {
148
+ "interface": [
149
+ "init(config)",
150
+ "dispatch(state, action)",
151
+ "getState(state)",
152
+ "flipCard(state, cardId)",
153
+ "checkMatch(state)",
154
+ "flipBackMismatched(state)",
155
+ "checkWin(state)"
156
+ ]
157
+ }
158
+ },
159
+ "files": {
160
+ "skill": "SKILL.md",
161
+ "pgsSchema": "ref/pgs-schema.json",
162
+ "reducerTemplate": "ref/reducer.template.ts"
163
+ }
164
+ }
@@ -0,0 +1,190 @@
1
+ {
2
+ "_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 记忆翻牌配对玩法。Agent 以此为起点编写或 fork 玩法规则。",
3
+ "version": "1.0",
4
+ "gameplayType": "memory_match",
5
+ "entities": {
6
+ "board": {
7
+ "type": "grid",
8
+ "cols": 4,
9
+ "rows": 4,
10
+ "description": "游戏棋盘,默认 4×4 排列 16 张牌(8对),可通过 config 覆盖"
11
+ },
12
+ "card": {
13
+ "type": "cell-item",
14
+ "description": "棋盘上的卡牌",
15
+ "fields": {
16
+ "id": "number,卡牌唯一 ID(0 ~ totalCards-1)",
17
+ "pairId": "number,配对组 ID,相同 pairId 的两张牌为一对",
18
+ "state": "'face_down'(背面朝上,初始状态)| 'face_up'(正面朝上,已翻开)| 'matched'(已配对,保持翻开)"
19
+ }
20
+ },
21
+ "movesCount": {
22
+ "type": "counter",
23
+ "initial": 0,
24
+ "description": "玩家翻牌总次数(每翻开一张 +1)"
25
+ },
26
+ "matchedPairs": {
27
+ "type": "counter",
28
+ "initial": 0,
29
+ "description": "已成功配对的对数"
30
+ },
31
+ "faceUpCards": {
32
+ "type": "list",
33
+ "maxLength": 2,
34
+ "description": "当前正面朝上(face_up 状态)的卡牌 ID 列表,最多2张"
35
+ }
36
+ },
37
+ "rules": {
38
+ "flip_card": {
39
+ "description": "玩家翻开一张背面朝下的牌",
40
+ "preconditions": [
41
+ "目标牌必须为 face_down 状态",
42
+ "当前 face_up 的牌不超过 1 张(若已有2张 face_up 未处理,则拒绝新翻牌)"
43
+ ],
44
+ "effect": "目标牌 state 变为 face_up;movesCount + 1;加入 faceUpCards 列表"
45
+ },
46
+ "check_pair": {
47
+ "description": "当 faceUpCards 恰好有2张时自动触发配对检测",
48
+ "condition": "faceUpCards[0].pairId === faceUpCards[1].pairId",
49
+ "onMatch": "两张牌 state 变为 matched;matchedPairs + 1;faceUpCards 清空",
50
+ "onMismatch": "不立即翻回,标记为 pending_flip_back,等待 flipBackDelayMs 后翻回"
51
+ },
52
+ "flip_back": {
53
+ "description": "两张不匹配的 face_up 牌在延迟后翻回 face_down",
54
+ "delayMs": 1000,
55
+ "effect": "两张牌 state 变回 face_down;faceUpCards 清空"
56
+ },
57
+ "win_check": {
58
+ "description": "每次配对成功后检测胜利条件",
59
+ "condition": "matchedPairs === totalPairs",
60
+ "result": "win=true,游戏结束"
61
+ }
62
+ },
63
+ "algorithm": {
64
+ "description": "主循环:翻牌 → 配对检测 → 翻回/胜利",
65
+ "steps": [
66
+ "1. 玩家点击一张 face_down 的牌",
67
+ "2. 若当前 faceUpCards 已有2张(pending flip back),拒绝操作",
68
+ "3. 翻开牌:state → face_up,movesCount + 1,加入 faceUpCards",
69
+ "4. 若 faceUpCards.length < 2,等待玩家翻第二张",
70
+ "5. 若 faceUpCards.length === 2,触发 check_pair",
71
+ "6a. 若 pairId 相同(配对成功):两张 state → matched,matchedPairs + 1,faceUpCards 清空",
72
+ "6b. 若 pairId 不同(不匹配):标记 pending,等待 flipBackDelayMs 毫秒后翻回 face_down",
73
+ "7. 配对成功后检测 win_check:matchedPairs === totalPairs → 胜利"
74
+ ]
75
+ },
76
+ "winCondition": {
77
+ "type": "all_pairs_matched",
78
+ "description": "所有牌对均已配对(matchedPairs === totalPairs,即所有卡牌均为 matched 状态)"
79
+ },
80
+ "loseCondition": {
81
+ "type": "none",
82
+ "description": "无失败条件(或可通过 config 设置 maxMoves 以步数限制为失败条件)"
83
+ },
84
+ "testCases": [
85
+ {
86
+ "id": "tc_match_success",
87
+ "description": "配对成功:翻开两张相同 pairId 的牌",
88
+ "initialState": {
89
+ "cards": [
90
+ { "id": 0, "pairId": 1, "state": "face_down" },
91
+ { "id": 1, "pairId": 2, "state": "face_down" },
92
+ { "id": 2, "pairId": 1, "state": "face_down" },
93
+ { "id": 3, "pairId": 2, "state": "face_down" }
94
+ ],
95
+ "movesCount": 0,
96
+ "matchedPairs": 0,
97
+ "faceUpCards": []
98
+ },
99
+ "actions": [
100
+ { "type": "flip_card", "cardId": 0 },
101
+ { "type": "flip_card", "cardId": 2 }
102
+ ],
103
+ "expectedState": {
104
+ "cards": [
105
+ { "id": 0, "state": "matched" },
106
+ { "id": 2, "state": "matched" }
107
+ ],
108
+ "matchedPairs": 1,
109
+ "movesCount": 2,
110
+ "faceUpCards": []
111
+ }
112
+ },
113
+ {
114
+ "id": "tc_mismatch_flip_back",
115
+ "description": "不匹配翻回:翻开两张 pairId 不同的牌,等待延迟后两张回到 face_down",
116
+ "initialState": {
117
+ "cards": [
118
+ { "id": 0, "pairId": 1, "state": "face_down" },
119
+ { "id": 1, "pairId": 2, "state": "face_down" },
120
+ { "id": 2, "pairId": 1, "state": "face_down" },
121
+ { "id": 3, "pairId": 2, "state": "face_down" }
122
+ ],
123
+ "movesCount": 0,
124
+ "matchedPairs": 0,
125
+ "faceUpCards": []
126
+ },
127
+ "actions": [
128
+ { "type": "flip_card", "cardId": 0 },
129
+ { "type": "flip_card", "cardId": 1 },
130
+ { "type": "flip_back_mismatched" }
131
+ ],
132
+ "expectedState": {
133
+ "cards": [
134
+ { "id": 0, "state": "face_down" },
135
+ { "id": 1, "state": "face_down" }
136
+ ],
137
+ "matchedPairs": 0,
138
+ "movesCount": 2,
139
+ "faceUpCards": []
140
+ }
141
+ },
142
+ {
143
+ "id": "tc_win_condition",
144
+ "description": "胜利条件:所有配对完成后 win=true",
145
+ "initialState": {
146
+ "cards": [
147
+ { "id": 0, "pairId": 1, "state": "face_down" },
148
+ { "id": 1, "pairId": 1, "state": "face_down" }
149
+ ],
150
+ "movesCount": 0,
151
+ "matchedPairs": 0,
152
+ "faceUpCards": [],
153
+ "totalPairs": 1
154
+ },
155
+ "actions": [
156
+ { "type": "flip_card", "cardId": 0 },
157
+ { "type": "flip_card", "cardId": 1 }
158
+ ],
159
+ "expectedState": {
160
+ "matchedPairs": 1,
161
+ "win": true,
162
+ "gameOver": true
163
+ }
164
+ },
165
+ {
166
+ "id": "tc_reject_flip_when_two_faceup",
167
+ "description": "拒绝翻牌:已有2张 face_up 未处理时,拒绝新的翻牌请求",
168
+ "initialState": {
169
+ "cards": [
170
+ { "id": 0, "pairId": 1, "state": "face_up" },
171
+ { "id": 1, "pairId": 2, "state": "face_up" },
172
+ { "id": 2, "pairId": 1, "state": "face_down" }
173
+ ],
174
+ "movesCount": 2,
175
+ "matchedPairs": 0,
176
+ "faceUpCards": [0, 1]
177
+ },
178
+ "actions": [
179
+ { "type": "flip_card", "cardId": 2 }
180
+ ],
181
+ "expectedState": {
182
+ "cards": [
183
+ { "id": 2, "state": "face_down" }
184
+ ],
185
+ "movesCount": 2,
186
+ "note": "翻牌请求被拒绝,状态不变"
187
+ }
188
+ }
189
+ ]
190
+ }