@playcraft/skills 0.0.2

package/skills/basketball_shot.aigameplay/ref/pgs-schema.json

@@ -0,0 +1,229 @@
+{
+  "_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 篮球投篮玩法。Agent 以此为起点编写或 fork 玩法规则。",
+  "version": "1.0",
+  "gameplayType": "basketball_shot",
+  "entities": {
+    "hoop": {
+      "type": "target",
+      "description": "篮筐，固定位置",
+      "fields": {
+        "position": { "type": "vector2", "description": "篮筐中心坐标 {x, y}" },
+        "radius":   { "type": "number",  "value": 45, "description": "篮筐内径半径（像素）" },
+        "rimY":     { "type": "number",  "description": "篮筐顶部 y 坐标，球必须从上方穿过此线" }
+      }
+    },
+    "ball": {
+      "type": "projectile",
+      "description": "篮球，抛物线运动",
+      "fields": {
+        "position": { "type": "vector2", "description": "当前位置 {x, y}" },
+        "velocity": { "type": "vector2", "description": "当前速度 {vx, vy}" },
+        "inFlight": { "type": "boolean", "default": false }
+      }
+    },
+    "player_position": {
+      "type": "spawn-point",
+      "description": "玩家投篮位置（不同关卡有不同距离/角度）",
+      "fields": {
+        "position": { "type": "vector2" },
+        "distance":  { "type": "number", "description": "距篮筐距离（米），影响难度" }
+      }
+    },
+    "score": {
+      "type": "counter",
+      "initial": 0,
+      "description": "当前得分"
+    },
+    "shots_remaining": {
+      "type": "counter",
+      "description": "剩余投篮次数",
+      "initial": 10
+    },
+    "combo_count": {
+      "type": "counter",
+      "initial": 0,
+      "description": "当前连续命中次数"
+    }
+  },
+  "rules": {
+    "aim": {
+      "description": "玩家设置投篮角度和力度",
+      "fields": {
+        "angle": { "type": "number", "range": [10, 85], "description": "投篮仰角（度），相对于水平方向" },
+        "power": { "type": "number", "range": [0, 100], "description": "力度百分比，决定初速度大小" }
+      }
+    },
+    "shoot": {
+      "description": "将力度和角度转换为初始速度向量，球开始飞行",
+      "formula": {
+        "vx": "cos(angle) × power × maxSpeed",
+        "vy": "-sin(angle) × power × maxSpeed"
+      },
+      "effect": "ball.inFlight = true; shots_remaining--"
+    },
+    "trajectory": {
+      "description": "抛物线物理模拟",
+      "formula": {
+        "x(t)": "x0 + vx × t",
+        "y(t)": "y0 + vy × t + 0.5 × gravity × t²",
+        "vy(t)": "vy0 + gravity × t"
+      },
+      "gravity": 980,
+      "description2": "重力单位 px/s²，每帧 dt 秒更新位置"
+    },
+    "hoop_check": {
+      "description": "入筐检测：球从 rimY 上方穿越到下方，且球心 x 在筐内",
+      "conditions": [
+        "ball.prev_y < hoop.rimY AND ball.y >= hoop.rimY",
+        "abs(ball.x - hoop.position.x) <= hoop.radius × (1 + rimTolerance)"
+      ],
+      "rimTolerance": 0.15,
+      "scoreOnHit": "baseScore × comboMultiplier",
+      "baseScore": 100
+    },
+    "rim_miss": {
+      "description": "球碰到篮筐边缘但未入筐（可选：添加弹跳效果）",
+      "trigger": "ball within rim band but fails hoop_check",
+      "effect": "ball bounces off rim (optional visual)"
+    },
+    "combo": {
+      "description": "连续命中加成：每次命中 combo_count++，倍率 = 1 + combo_count × 0.5",
+      "comboMultiplierStep": 0.5,
+      "maxMultiplier": 5.0,
+      "resetOnMiss": true
+    },
+    "miss": {
+      "description": "球落地或飞出边界且未入筐",
+      "effect": "combo_count = 0"
+    }
+  },
+  "algorithm": {
+    "description": "主循环：aim → shoot → simulate_trajectory → hoop_check → score → repeat",
+    "steps": [
+      "1. 玩家设置投篮角度和力度",
+      "2. 确认投篮：shots_remaining--，计算初始速度向量",
+      "3. 每帧更新球的位置（抛物线物理：位移 = 速度×dt，vy += gravity×dt）",
+      "4. 每帧检测入筐：球穿过 rimY 且 x 在筐内",
+      "5. 入筐：score += baseScore × comboMultiplier；combo_count++；ball 重置",
+      "6. 落地/出界：combo_count = 0；ball 重置",
+      "7. 检测胜负：shots_remaining==0 时检查 score >= goalScore"
+    ]
+  },
+  "winCondition": {
+    "type": "score_goal",
+    "description": "在 shots_remaining 耗尽前达到 goalScore（由 config 中定义）"
+  },
+  "loseCondition": {
+    "type": "shots_exhausted",
+    "description": "shots_remaining == 0 且 score < goalScore"
+  },
+  "testCases": [
+    {
+      "id": "tc_perfect_shot",
+      "description": "完美入筐：正确角度和力度，球穿过篮筐中心",
+      "initialState": {
+        "ball": { "position": { "x": 200, "y": 600 }, "inFlight": false },
+        "hoop": { "position": { "x": 600, "y": 300 }, "radius": 45, "rimY": 300 },
+        "score": 0,
+        "shots_remaining": 5,
+        "combo_count": 0
+      },
+      "actions": [
+        { "type": "aim",   "angle": 45, "power": 65 },
+        { "type": "shoot" },
+        { "type": "simulate_until_land" }
+      ],
+      "expectedState": {
+        "scored": true,
+        "score": 100,
+        "combo_count": 1,
+        "shots_remaining": 4
+      }
+    },
+    {
+      "id": "tc_rim_miss",
+      "description": "打铁：球碰到篮筐边缘但未入筐",
+      "initialState": {
+        "ball": { "position": { "x": 200, "y": 600 }, "inFlight": false },
+        "hoop": { "position": { "x": 600, "y": 300 }, "radius": 45, "rimY": 300 },
+        "score": 0,
+        "shots_remaining": 5,
+        "combo_count": 2
+      },
+      "actions": [
+        { "type": "aim",   "angle": 45, "power": 50 },
+        { "type": "shoot" },
+        { "type": "simulate_until_land" }
+      ],
+      "expectedState": {
+        "scored": false,
+        "combo_count": 0,
+        "shots_remaining": 4
+      }
+    },
+    {
+      "id": "tc_combo_multiplier",
+      "description": "连击加成：连续命中3次，第3次得分翻倍",
+      "initialState": {
+        "ball": { "position": { "x": 200, "y": 600 }, "inFlight": false },
+        "hoop": { "position": { "x": 600, "y": 300 }, "radius": 45, "rimY": 300 },
+        "score": 200,
+        "shots_remaining": 5,
+        "combo_count": 2
+      },
+      "actions": [
+        { "type": "aim",   "angle": 45, "power": 65 },
+        { "type": "shoot" },
+        { "type": "simulate_until_land" }
+      ],
+      "expectedState": {
+        "scored": true,
+        "combo_count": 3,
+        "score": 400,
+        "score_gained": 200
+      }
+    },
+    {
+      "id": "tc_win",
+      "description": "胜利：最后一投命中，总分达到目标",
+      "initialState": {
+        "score": 900,
+        "goalScore": 1000,
+        "shots_remaining": 1,
+        "combo_count": 0
+      },
+      "actions": [
+        { "type": "aim",   "angle": 45, "power": 65 },
+        { "type": "shoot" },
+        { "type": "simulate_until_land" }
+      ],
+      "expectedState": {
+        "scored": true,
+        "gameOver": true,
+        "win": true,
+        "score": { "min": 1000 }
+      }
+    },
+    {
+      "id": "tc_lose",
+      "description": "失败：最后一投未中，分数不达标",
+      "initialState": {
+        "score": 500,
+        "goalScore": 1000,
+        "shots_remaining": 1,
+        "combo_count": 0
+      },
+      "actions": [
+        { "type": "aim",   "angle": 20, "power": 30 },
+        { "type": "shoot" },
+        { "type": "simulate_until_land" }
+      ],
+      "expectedState": {
+        "scored": false,
+        "shots_remaining": 0,
+        "gameOver": true,
+        "win": false
+      }
+    }
+  ]
+}

package/skills/basketball_shot.aigameplay/ref/reducer.template.ts

@@ -0,0 +1,189 @@
+/**
+ * basketball_shot.aigameplay — reducer 接口模板
+ *
+ * Agent 生成实际 reducer 时，必须导出以下函数。
+ * 此文件是接口约束模板，不是可执行代码。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * ⚠️ 重要：渲染层（GameScene）不应直接调用 dispatch()
+ *
+ * dispatch() 一步完成整个投篮模拟，丢失中间轨迹数据。
+ * 渲染层需要播放球的飞行动画，必须使用 calculateTrajectory
+ * 获取轨迹点列表，逐帧插值渲染球的位置。
+ *
+ * dispatch() 的用途：无头测试、AI 模拟、批量计算等场景。
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+// ─── 配置类型 ─────────────────────────────────────────────────────────────────
+
+export type BasketballConfig = {
+  /** 重力加速度（像素/秒²），默认 980 */
+  gravity: number;
+  /** 最大初始速度（像素/秒） */
+  maxSpeed: number;
+  /** 连击倍率步进，默认 0.5（每次连击增加 0.5x） */
+  comboMultiplierStep: number;
+  /** 入筐容差系数，默认 0.15（增大让入筐更宽松） */
+  rimTolerance: number;
+  /** 每关投篮次数 */
+  initialShots: number;
+  /** 目标分数 */
+  goalScore: number;
+  /** 每次投中基础分 */
+  baseScore: number;
+  /** 模拟步长（秒），默认 1/120 */
+  simulationStep: number;
+};
+
+// ─── 核心类型 ─────────────────────────────────────────────────────────────────
+
+export type Vector2 = { x: number; y: number };
+
+export type Hoop = {
+  position: Vector2;   // 篮筐中心
+  radius: number;      // 篮筐内径半径
+  rimY: number;        // 篮筐顶部 y（球必须从上方穿过）
+};
+
+export type PlayerPosition = {
+  position: Vector2;   // 玩家（球的起始位置）
+  label?: string;      // 例如 "3-point line", "mid-range"
+};
+
+// ─── 动作类型 ─────────────────────────────────────────────────────────────────
+
+export type BasketballAction =
+  | { type: 'aim'; angle: number; power: number }   // 设置投篮参数
+  | { type: 'shoot'; angle: number; power: number } // 投篮（一步完成）
+  | { type: 'reset' };
+
+// ─── 状态类型 ─────────────────────────────────────────────────────────────────
+
+export type BasketballState = {
+  hoop: Hoop;
+  playerPosition: PlayerPosition;
+  score: number;
+  shotsRemaining: number;
+  comboCount: number;
+  /** 当前连击倍率 = 1 + comboCount × comboMultiplierStep */
+  comboMultiplier: number;
+  gameOver: boolean;
+  win: boolean;
+  /** 上一次投篮是否命中 */
+  lastShotScored: boolean;
+  /** 上一次投篮轨迹（用于渲染层 replay 或回放） */
+  lastTrajectory: TrajectoryPoint[] | null;
+};
+
+// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
+
+/** 轨迹点（位置 + 时间戳） */
+export type TrajectoryPoint = {
+  position: Vector2;
+  t: number;   // 飞行时间（秒）
+};
+
+/** 投篮模拟结果 */
+export type ShotResult = {
+  trajectoryPoints: TrajectoryPoint[];  // 完整轨迹点列表
+  scored: boolean;                       // 是否入筐
+  finalPosition: Vector2;               // 落点
+  hoopContactPoint?: Vector2;           // 入筐接触点（若 scored）
+};
+
+/** 入筐检测结果 */
+export type HoopCheckResult = {
+  scored: boolean;
+  /** 球心穿过 rimY 时的 x 偏移量（0 = 完美中心） */
+  centerOffset: number;
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 必须导出的函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+
+/**
+ * init：根据配置初始化游戏状态
+ */
+export declare function init(config: BasketballConfig & { hoop: Hoop; playerPosition: PlayerPosition }): BasketballState;
+
+// ─── 一体化接口（测试/AI 模拟用） ───────────────────────────────────────────
+
+/**
+ * dispatch：接收动作，返回新状态（纯函数）
+ * - aim：更新当前瞄准参数（不消耗次数）
+ * - shoot：执行完整投篮模拟，更新状态
+ * - reset：重置游戏
+ *
+ * ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
+ */
+export declare function dispatch(state: BasketballState, action: BasketballAction): BasketballState;
+
+/**
+ * getState：返回当前状态快照
+ */
+export declare function getState(state: BasketballState): BasketballState;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 分步函数（渲染层/场景层必须使用这些函数驱动动画）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * calculateTrajectory：根据起始位置、角度、力度计算完整抛物线轨迹
+ * 公式：x(t)=x0+vx·t, y(t)=y0+vy·t+0.5·g·t²（g 为正值，y 轴向下为正）
+ *
+ * 渲染层用途：
+ * 1. 玩家调整参数时实时预览轨迹（虚线）
+ * 2. 实际投篮时获取逐帧插值点
+ */
+export declare function calculateTrajectory(
+  startPos: Vector2,
+  angle: number,      // 投篮仰角（度），相对水平方向
+  power: number,      // 力度百分比 0~100
+  config: Pick<BasketballConfig, 'gravity' | 'maxSpeed' | 'simulationStep'>,
+): TrajectoryPoint[];
+
+/**
+ * checkHoop：检测球在某一时刻是否穿过篮筐
+ * 条件：球从 rimY 上方穿越到下方，且球心 x 在 hoop.radius × (1 + rimTolerance) 内
+ *
+ * 渲染层在逐帧播放轨迹动画时调用，检测入筐瞬间以触发入筐动画
+ */
+export declare function checkHoop(
+  ball: Vector2,
+  prevBall: Vector2,  // 上一帧位置（用于判断穿越方向）
+  hoop: Hoop,
+  rimTolerance: number,
+): HoopCheckResult;
+
+/**
+ * updateScore：根据本次投篮结果更新分数和连击数
+ * - 命中：score += baseScore × comboMultiplier；comboCount++
+ * - 未中：comboCount = 0；comboMultiplier = 1
+ * - shotsRemaining--
+ * - 检测 gameOver 和 win
+ */
+export declare function updateScore(
+  state: BasketballState,
+  isHit: boolean,
+  config: Pick<BasketballConfig, 'baseScore' | 'comboMultiplierStep' | 'goalScore'>,
+): BasketballState;
+
+/**
+ * simulateShot：执行完整投篮模拟，返回轨迹点和结果
+ * 内部调用 calculateTrajectory + checkHoop，不修改 state
+ *
+ * 渲染层调用流程：
+ * 1. const result = simulateShot(state, angle, power)
+ * 2. 逐帧渲染 result.trajectoryPoints
+ * 3. 结束后调用 updateScore(state, result.scored, config)
+ */
+export declare function simulateShot(
+  state: BasketballState,
+  angle: number,
+  power: number,
+  config: BasketballConfig,
+): ShotResult;

package/skills/bg_music.aiaudio/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: bg_music.aiaudio
+description: 路径消除玩法的背景循环音乐，营造轻松欢快的益智游戏氛围。
+triggers: 需要生成路径消除玩法背景音乐时触发。
+---
+
+# 路径消除 BGM
+
+## Recipe
+
+生成提示词见 manifest.json generation.prompt。
+- model: Google Lyria 3（平台默认，见 manifest.json generation.platformSkill）
+- format: mp3
+- loop: true
+
+## Result
+
+- 产物文件：`bg.mp3`
+- 在 Preloader.ts 中作为 `bgMusic` key 加载
+
+## Binding
+
+```json
+{
+  "role": "bgMusic",
+  "target": "assets/sounds/bg.mp3",
+  "type": "audio-asset-reference"
+}
+```
+
+## 生成方式
+
+Platform Skill: `playcraft-audio-generation`
+
+```bash
+# 1. 生成 BGM（Google Lyria 3，固定 30s）
+playcraft tools generate-bgm \
+     --prompt "upbeat casual mobile puzzle game background music, energetic and fun, 120 BPM, loop" \
+     --style casual \
+     --bpm 120 \
+     --output ta-workspace/raw_bgm.mp3
+
+# 2. 处理无缝循环 + 归一化
+playcraft audio loop --input ta-workspace/raw_bgm.mp3 --output ta-workspace/bgm_loop.mp3 --crossfade 0.5
+playcraft audio normalize --input ta-workspace/bgm_loop.mp3 --output ta-workspace/bgm_loop.mp3 --target-loudness -16
+
+# 3. 压缩至体积预算（Facebook 可玩广告 BGM 目标 ≤60KB）
+playcraft audio compress --input ta-workspace/bgm_loop.mp3 --output ta-workspace/bg.mp3 --target-size 60KB
+
+# 4. 将产物写入 sandbox 对应路径（见 binding.target）
+```
+## Skill Definition
+
+```yaml
+tools:
+  - generate_audio
+inputs:
+  - prompt: see manifest.json
+outputs:
+  - audio: bg.mp3
+```

package/skills/bg_music.aiaudio/manifest.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": 1,
+  "atomId": "bg_music.aiaudio",
+  "bundleType": "aiaudio",
+  "category": "audio",
+  "mode": "generative",
+  "label": {
+    "zh": "路径消除背景音乐",
+    "en": "Path elimination BGM"
+  },
+  "tags": [
+    "audio",
+    "bgm",
+    "music",
+    "loop",
+    "puzzle",
+    "casual"
+  ],
+  "bindingRoles": [
+    "bgMusic"
+  ],
+  "generation": {
+    "kind": "bgm",
+    "prompt": "upbeat casual mobile puzzle game background music, energetic and fun, 120 BPM, loop",
+    "duration": 30,
+    "loop": true,
+    "referenceAudio": "ref/bg.mp3",
+    "platformSkill": "playcraft-audio-generation",
+    "bgmStyle": "casual",
+    "bpm": 120
+  },
+  "result": {
+    "outputFile": "ref/bg.mp3",
+    "format": "mp3",
+    "constraints": {
+      "maxDuration": 30
+    }
+  },
+  "binding": {
+    "role": "bgMusic",
+    "target": "assets/sounds/bg.mp3",
+    "type": "audio-asset-reference"
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "asset": "ref/bg.mp3"
+  }
+}

package/skills/big_watermelon.aigameplay/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: big_watermelon.aigameplay
+description: 合成西瓜玩法封包 - 下落水果物理碰撞、相同等级合并升级、容器溢出判定的 PGS 实现
+triggers: 合成,merge,西瓜,watermelon,水果,fruit,下落,drop,物理,physics,合并,combine,叠加,stack,溢出,overflow
+---
+
+# big_watermelon.aigameplay
+
+合成西瓜玩法封包。实现下落物理合成玩法的 PGS (PlayCraft Gameplay Schema, 玩法定义规范) JSON 和 reducer，玩家控制水果左右位置后释放，相同等级水果碰撞时合并为更大一级，容器溢出则游戏结束。
+
+## Recipe
+
+- **玩法类型**：big_watermelon（合成西瓜）
+- **参考文件**：
+  - `ref/pgs-schema.json`：PGS (PlayCraft Gameplay Schema, 玩法定义规范) 规则骨架（entities、rules、algorithm、testCases）
+  - `ref/reducer.template.ts`：reducer 接口约束模板（`init` / `dispatch` / `getState` + 分步函数）
+- **核心规则**：
+  - `fruitTiers`: 11（葡萄→樱桃→草莓→橙子→柿子→苹果→梨→桃子→菠萝→椰子→西瓜）
+  - `gravity`: 980（重力加速度，px/s²）
+  - `containerWidth`: 400 / `containerHeight`: 600（容器尺寸）
+  - `overflowLine`: 80（溢出判定线距顶部距离，任何静止水果超过此线则游戏结束）
+  - `nextFruitMaxTier`: 5（下一个水果随机范围限制在前 5 级，避免一开始就出现大水果）
+- **PGS Agent 操作流程**：
+  1. 读取 `ref/pgs-schema.json` 作为规则骨架起点
+  2. 读取 `ref/reducer.template.ts` 了解接口约束
+  3. 实现 `reducer.ts`，导出 `init(config)`、`dispatch(state, action)`、`getState(state)` 以及**全部分步函数**
+  4. 运行 `ref/pgs-schema.json` 中的所有 `testCases`，全部通过后才算完成
+  5. 更新 manifest 的 `generation.pgsVersion` 和 `result.outputFile`
+- **可 fork 变体**：
+  - 主题替换：将水果替换为宠物/星球/食物等，保持 11 级合成逻辑不变
+  - 特殊道具：某些等级的水果具有爆炸/磁铁特效，合并时触发特殊效果
+  - 挑战模式：设置分数目标，限制时间内达到目标分数
+
+## Result
+
+- **产物文件**：`reducer.ts`
+- **格式**：TypeScript，导出 `init(config)`、`dispatch(state, action)`、`getState(state)` + 分步函数接口
+- **验证**：所有 testCases 必须通过
+
+## 渲染集成（⚠️ 场景层必读）
+
+### 设计原则：逻辑与渲染分离
+
+reducer 管理逻辑状态（位置、速度、合并），渲染层（GameScene）使用 Matter.js 或 Phaser Arcade Physics 同步精灵：
+
+| 接口 | 适用场景 | 特点 |
+|------|---------|------|
+| `dispatch()` | 无头测试、AI 模拟 | 一步到位，只返回最终状态 |
+| 分步函数 | **渲染层/GameScene** | 逐帧更新，返回物理结果驱动精灵 |
+
+### 分步函数返回值与动画映射
+
+| 分步函数 | 返回值 | 场景层动画 |
+|---------|--------|-----------|
+| `aimFruit(x)` | `{ currentFruit }` | 移动瞄准指示线和当前水果预览精灵 |
+| `dropFruit()` | `{ droppedFruit, nextFruit }` | 创建下落水果刚体，生成下一个预览 |
+| `applyPhysics(deltaMs)` | `Fruit[]` | 逐帧同步所有水果精灵位置到物理状态 |
+| `checkMerges()` | `MergeEvent[]` | 播放合并特效，销毁旧精灵，创建新精灵 |
+| `mergeFruits(fruitA, fruitB)` | `{ newFruit, score }` | 合并动画：缩小两个旧精灵 → 在中点生成新精灵 |
+| `checkOverflow()` | `{ gameOver }` | 触发溢出警告 → 游戏结束面板 |
+| `calculateScore(tier)` | `number` | 更新分数 HUD |
+
+### ⚠️ 物理引擎集成建议
+
+由于真实物理模拟（圆形碰撞体、弹性、摩擦）超出纯 reducer 的能力范围，实际项目中：
+- reducer 管理**逻辑状态**（tier、分数、溢出检测、合并触发）
+- 渲染层使用 **Matter.js** 或 **Phaser Arcade** 管理物理碰撞体
+- 每帧结束后将物理引擎的位置数据同步回 reducer state
+
+## Binding
+
+- **Binding Role**：`gameplayRule`
+- **挂载目标**：`game/gameplay/big_watermelon/reducer.ts`
+- **引用类型**：`gameplay-module-reference`
+- **接口契约**：`init(config)` / `dispatch(action)` / `getState()` / `aimFruit()` / `dropFruit()` / `applyPhysics()` / `checkMerges()` / `mergeFruits()` / `checkOverflow()` / `calculateScore()`
+
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are implementing a merge-fruit (big watermelon) gameplay module following the PGS specification.
+  Write the PGS JSON with entities (container, fruits, score, next_fruit, current_fruit), rules, algorithm, and testCases.
+  Implement the reducer.ts with:
+    - init/dispatch/getState (一体化接口，用于测试)
+    - aimFruit/dropFruit/applyPhysics/checkMerges/mergeFruits/checkOverflow/calculateScore (分步函数，用于渲染层驱动)
+  Physics simulation in reducer: simplified circle collision detection (distance < r1+r2).
+  Merge trigger: two fruits with same tier AND overlapping circles → remove both, spawn tier+1 at midpoint.
+  Score per merge: tier^2 * 10 (higher tier merges give exponentially more points).
+  Overflow check: any resting fruit whose center y < overflowLine triggers gameOver.
+  Run the testCases to verify the logic before finalizing.
+  Apply the Binding to wire the reducer into the game's gameplay module path.