@playcraft/skills 0.0.2

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

@@ -0,0 +1,180 @@
+{
+  "_comment": "PGS (PlayCraft Gameplay Schema) - 箭头推出三消玩法（arrow_pick_match）。棋盘上有带颜色和方向的路径，玩家点击路径触发方向推出，推出后飞入底部篮子。篮子中凑齐 3 条同色路径自动消除。所有路径推出且篮子清空为胜利。",
+  "version": "1.0",
+  "gameplayType": "arrow_pick_match",
+  "parentTypes": ["path_elimination", "pick_and_match"],
+  "entities": {
+    "board": {
+      "type": "grid",
+      "rows": "dynamic (4~7)",
+      "cols": "dynamic (4~7)",
+      "description": "棋盘网格，路径在其上占据格子。"
+    },
+    "path": {
+      "type": "multi-cell-entity",
+      "fields": {
+        "points": "GridPoint[]  路径覆盖的格子坐标列表",
+        "head": "GridPoint     车头位置（最后一个点）",
+        "direction": "string   推出方向 (up|down|left|right)",
+        "color": "string       颜色标识",
+        "indices": "number[]   覆盖的所有格子索引（row-major）",
+        "pathIndex": "number   在 level.paths 中的索引"
+      },
+      "state": "idle | sliding_out | in_tray | matched | removed",
+      "description": "棋盘上的路径实体，占据连续格子。方向由最后两点推导。推出时整体滑出。"
+    },
+    "tray": {
+      "type": "container",
+      "capacity": 7,
+      "fields": {
+        "items": "TrayItem[]   当前篮子中的物品（id + color）",
+        "maxSlots": "number    篮子最大容量（默认 7）"
+      },
+      "description": "底部篮子。路径推出后飞入此处。同色聚合排列，凑齐 3 个消除。"
+    },
+    "timer": {
+      "type": "countdown",
+      "initial": "levelTime 秒（来自关卡数据）",
+      "description": "倒计时计时器。归零时触发失败。"
+    }
+  },
+  "rules": {
+    "pathClickDetection": {
+      "description": "玩家点击棋盘上的任意路径格子即命中该路径。",
+      "trigger": "pointer_up",
+      "conditions": ["path.state === 'idle'", "not inputLocked"]
+    },
+    "blockingCheck": {
+      "description": "检测路径推出方向上是否有其他路径阻挡。从 head 沿 direction 逐格检测，直到出界或碰到其他路径占据的格子。",
+      "steps": [
+        "1. 计算 direction 对应的 delta (dx, dy)",
+        "2. 从 head 位置开始，逐步 += delta",
+        "3. 若到达棋盘边界 → 记录 stepsToExit，返回 unblocked",
+        "4. 若碰到其他未移除路径的格子 → 返回 blocked"
+      ]
+    },
+    "blockedFeedback": {
+      "description": "路径被阻挡时的反馈：棋盘抖动 + 路径短暂变红。不扣命不扣分。",
+      "trigger": "blocking_check_failed"
+    },
+    "slideOut": {
+      "description": "路径无阻挡时，整条路径沿方向滑出棋盘。所有格子上的精灵作为容器一起移动。",
+      "trigger": "blocking_check_passed",
+      "steps": [
+        "1. 锁定输入",
+        "2. 标记路径为 sliding_out",
+        "3. 创建临时容器包含路径所有精灵",
+        "4. Tween 容器沿方向移动 slideDistance",
+        "5. 完成后标记路径为 removed，触发 flyToTray"
+      ]
+    },
+    "flyToTray": {
+      "description": "路径滑出后，head 精灵贝塞尔曲线飞入篮子对应槽位。",
+      "trigger": "after_slide_out",
+      "steps": [
+        "1. 计算篮子中的插入位置（同色聚合）",
+        "2. head 精灵从滑出终点贝塞尔曲线飞入目标槽位",
+        "3. 到达后在篮子中创建物品精灵",
+        "4. 触发 matchDetection"
+      ]
+    },
+    "matchDetection": {
+      "description": "每次物品入篮后，检查是否有 3 个同色。有则消除。",
+      "trigger": "after_fly_to_tray",
+      "matchCondition": "3 items with identical color",
+      "steps": [
+        "1. 按 color 分组计数",
+        "2. 找到 count >= 3 的组",
+        "3. 消除该组前 3 个（放大+淡出动画）",
+        "4. 剩余物品左移填补",
+        "5. 若仍有 count >= 3，递归消除",
+        "6. 检查胜负条件"
+      ]
+    },
+    "winCondition": {
+      "description": "所有路径推出棋盘 + 篮子中物品全部消除 = 胜利",
+      "check": "removedPaths.size >= level.paths.length && tray.length === 0"
+    },
+    "loseCondition_trayFull": {
+      "description": "篮子物品数达到 maxSlots 且无消除触发 = 失败",
+      "check": "tray.length >= maxSlots && no match found"
+    },
+    "loseCondition_timeout": {
+      "description": "倒计时归零时棋盘仍有未推出路径 = 失败",
+      "check": "timer <= 0 && removedPaths.size < level.paths.length"
+    },
+    "inputLock": {
+      "description": "滑出动画、飞入动画、消除动画期间锁定输入"
+    }
+  },
+  "levelDataSchema": {
+    "format": {
+      "name": "number   关卡序号",
+      "row": "number    棋盘行数",
+      "col": "number    棋盘列数",
+      "arrows": "(number|string)[][][] 路径点数组，第一个点第三元素为颜色",
+      "levelTime": "number 关卡时限秒数",
+      "trayCapacity": "number? 篮子容量（默认7）"
+    },
+    "constraints": {
+      "tripleGuarantee": "每种颜色的路径数量必须恰好为 3",
+      "noOverlap": "任意两条路径不共享格子",
+      "allUnblocked": "建议所有路径可无阻挡推出（或存在合法推出序列）",
+      "minPaths": 6,
+      "minColors": 2
+    }
+  },
+  "testCases": [
+    {
+      "id": "tc_basic_slide_and_match",
+      "description": "基础通关：6 条路径(2色×3)，全部无阻挡，连续推出同色即消除",
+      "initialState": {
+        "board": "4×4",
+        "paths": [
+          { "points": [[0,0],[1,0]], "color": "red", "direction": "right" },
+          { "points": [[3,1],[2,1]], "color": "red", "direction": "left" },
+          { "points": [[0,2],[0,3]], "color": "red", "direction": "down" },
+          { "points": [[3,3],[3,2]], "color": "blue", "direction": "up" },
+          { "points": [[1,3],[2,3]], "color": "blue", "direction": "right" },
+          { "points": [[2,2],[1,2]], "color": "blue", "direction": "left" }
+        ],
+        "tray": [],
+        "trayCapacity": 7
+      },
+      "actions": [
+        { "type": "clickPath", "pathIndex": 0 },
+        { "type": "clickPath", "pathIndex": 1 },
+        { "type": "clickPath", "pathIndex": 2 },
+        { "type": "clickPath", "pathIndex": 3 },
+        { "type": "clickPath", "pathIndex": 4 },
+        { "type": "clickPath", "pathIndex": 5 }
+      ],
+      "expectedState": {
+        "tray": [],
+        "removedCount": 6,
+        "win": true
+      }
+    },
+    {
+      "id": "tc_tray_overflow",
+      "description": "篮子溢出：乱序推出导致篮子满",
+      "initialState": {
+        "board": "5×5, 9 paths (3色×3)",
+        "trayCapacity": 5
+      },
+      "actions": "交替推出不同颜色，每色只推2个不足3消",
+      "expectedState": {
+        "win": false,
+        "loseReason": "tray_full"
+      }
+    },
+    {
+      "id": "tc_blocked_feedback",
+      "description": "阻挡反馈：路径被挡时不推出，只抖动",
+      "expectedState": {
+        "actionResult": "blocked",
+        "pathStillOnBoard": true
+      }
+    }
+  ]
+}

package/skills/asset_pipeline_scripts.aicomponent/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: asset_pipeline_scripts.aicomponent
+description: AI 生图资源管线自动化。一键完成 generate → remove-background → trim → convert webp → 输出集成提示。与 board_entity_sprite.aiimage 配套使用。
+triggers: 资源管线,asset pipeline,生成图片,generate sprite,一键生图,自动化,gen-sprite
+---
+
+# 资源管线自动化脚本（Asset Pipeline Scripts）
+
+## 说明
+
+将 AI 生图到项目集成的**全流程自动化**为一条命令：
+
+```bash
+pnpm gen:sprite car
+# 等价于：
+pnpm gen:sprite "cute cartoon car"
+```
+
+**自动完成：**
+1. 构造 prompt（填充 entity 变量）
+2. 调用 `playcraft tools generate-image`
+3. `playcraft image remove-background`
+4. `playcraft image trim`
+5. `playcraft image convert --format webp --quality 90`
+6. 清理中间文件
+7. 输出集成代码提示
+
+## Scaffold
+
+| 目标路径 | 来源 | 说明 |
+|---------|-----|------|
+| `scripts/gen-sprite.sh` | `ref/gen-sprite.sh` | 一键生图脚本 |
+
+`package.json` 新增：
+```json
+{
+  "scripts": {
+    "gen:sprite": "bash scripts/gen-sprite.sh"
+  }
+}
+```
+
+## 使用方式
+
+```bash
+# 基础用法（默认 cartoon flat 风格）
+pnpm gen:sprite car
+
+# 指定完整描述
+pnpm gen:sprite "red race car with flames"
+
+# 指定输出名
+pnpm gen:sprite car --name racing_car
+```
+
+## 输出
+
+```
+🎨 Generating: car
+📦 Model: google/gemini-3.1-flash-image-preview
+⏳ Generating image...
+✅ Generated raw image
+🔲 Removing background...
+✂️  Trimming...
+🔄 Converting to webp...
+🧹 Cleaning up...
+
+✅ Done: assets/images/car.webp (24KB)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Integration code:
+
+  // Add to Preloader.ts imports:
+  import carImage from "assets/images/car.webp";
+
+  // Add to preload():
+  this.load.image("car", carImage);
+
+  // Use in scene:
+  const sprite = scene.add.image(x, y, "car");
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **自动化为单一命令** | 手动执行 generate → remove-bg → trim → convert 五步极易遗漏步骤；脚本保证每次流程一致 |
+| **Bash 脚本而非 Node.js** | Bash 调用 CLI 命令更直观，零额外依赖，PlayCraft CLI 工具已覆盖所有后处理需求 |
+| **输出集成代码提示** | Agent 生成图片后立即得到 Preloader.ts 的 import 和 load 代码片段，减少上下文切换成本 |
+| **与 aiimage skill 解耦** | Recipe（prompt 模板）在 `board_entity_sprite.aiimage` 中维护；本 skill 只负责执行流程，不重复定义 prompt |
+
+## Adapter
+
+- **Role**: `assetPipeline` — AI 生图管线自动化工具（开发时脚本，非运行时组件）
+- **Provides**: `scripts/gen-sprite.sh` 脚本、`pnpm gen:sprite` npm 命令
+- **Requires**: `board_entity_sprite.aiimage`（prompt 模板知识）、PlayCraft CLI（`playcraft` 命令）
+- **Consumed by**: Agent 在需要生成新精灵图资产时直接调用；无上游 skill 依赖
+- **Integration point**: `package.json` `scripts.gen:sprite` —— Agent 执行 `pnpm gen:sprite <entity>` 触发完整管线
+
+## Imports
+
+- `board_entity_sprite.aiimage`（知识层配套：prompt 模板 + 后处理规范）
+
+## Skill Definition
+
+```yaml
+tools:
+  - bash
+  - write
+  - read
+inputs:
+  - source: ref/gen-sprite.sh
+outputs:
+  - script: scripts/gen-sprite.sh
+  - npmScript: gen:sprite
+```

package/skills/asset_pipeline_scripts.aicomponent/manifest.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "atomId": "asset_pipeline_scripts.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "tool",
+  "mode": "fixed",
+  "label": {
+    "zh": "资源管线自动化脚本",
+    "en": "Asset pipeline automation scripts"
+  },
+  "tags": ["asset", "pipeline", "automation", "image", "generate", "script"],
+  "bindingRoles": ["assetPipeline"],
+  "files": {
+    "skill": "SKILL.md",
+    "ref": ["ref/gen-sprite.sh"]
+  }
+}

package/skills/asset_pipeline_scripts.aicomponent/ref/gen-sprite.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+# gen-sprite.sh — AI 生图资源管线一键脚本
+# 用法: bash scripts/gen-sprite.sh <entity> [--name output_name]
+#
+# 示例:
+#   bash scripts/gen-sprite.sh car
+#   bash scripts/gen-sprite.sh "red race car" --name racing_car
+
+set -e
+
+ENTITY="${1:-car}"
+OUTPUT_NAME=""
+MODEL="google/gemini-3.1-flash-image-preview"
+ASSETS_DIR="assets/images"
+
+# 解析参数
+shift 2>/dev/null || true
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --name) OUTPUT_NAME="$2"; shift 2 ;;
+    --model) MODEL="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+# 如果没有指定输出名，从 entity 提取（取第一个单词，小写）
+if [ -z "$OUTPUT_NAME" ]; then
+  OUTPUT_NAME=$(echo "$ENTITY" | awk '{print $1}' | tr '[:upper:]' '[:lower:]')
+fi
+
+PROMPT="top-down bird's eye view of a cute cartoon ${ENTITY}, facing upward, simple flat design, bright vivid colors, game asset, white background, centered on canvas, no shadow, 256x256 icon style"
+
+echo "🎨 Generating: ${ENTITY}"
+echo "📦 Model: ${MODEL}"
+echo "📂 Output: ${ASSETS_DIR}/${OUTPUT_NAME}.webp"
+echo ""
+
+# 确保目录存在
+mkdir -p "${ASSETS_DIR}"
+
+RAW_FILE="${ASSETS_DIR}/${OUTPUT_NAME}_raw.jpg"
+NOBG_FILE="${ASSETS_DIR}/${OUTPUT_NAME}_nobg.png"
+TRIM_FILE="${ASSETS_DIR}/${OUTPUT_NAME}_trimmed.png"
+FINAL_FILE="${ASSETS_DIR}/${OUTPUT_NAME}.webp"
+
+# Step 1: 生成
+echo "⏳ Generating image..."
+playcraft tools generate-image \
+  --prompt "${PROMPT}" \
+  --aspect-ratio 1:1 \
+  --image-model "${MODEL}" \
+  --output "${RAW_FILE}" 2>&1 | tail -1
+
+# 处理 playcraft 可能将输出改为 .jpg
+if [ ! -f "${RAW_FILE}" ]; then
+  # playcraft 可能输出了不同扩展名
+  POSSIBLE_JPG="${RAW_FILE%.png}.jpg"
+  if [ -f "${POSSIBLE_JPG}" ]; then
+    RAW_FILE="${POSSIBLE_JPG}"
+  fi
+fi
+
+echo "✅ Generated raw image"
+
+# Step 2: 去背景
+echo "🔲 Removing background..."
+playcraft image remove-background \
+  --input "${RAW_FILE}" \
+  --output "${NOBG_FILE}" 2>&1 | tail -1
+
+# Step 3: 裁切
+echo "✂️  Trimming..."
+playcraft image trim \
+  --input "${NOBG_FILE}" \
+  --output "${TRIM_FILE}" 2>&1 | tail -1
+
+# Step 4: 转 webp
+echo "🔄 Converting to webp..."
+playcraft image convert \
+  --input "${TRIM_FILE}" \
+  --output "${FINAL_FILE}" \
+  --quality 90 2>&1 | tail -1
+
+# Step 5: 清理
+echo "🧹 Cleaning up..."
+rm -f "${RAW_FILE}" "${NOBG_FILE}" "${TRIM_FILE}"
+
+# 获取文件大小
+FILE_SIZE=$(du -h "${FINAL_FILE}" | awk '{print $1}')
+
+echo ""
+echo "✅ Done: ${FINAL_FILE} (${FILE_SIZE})"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Integration code:"
+echo ""
+echo "  // Add to Preloader.ts imports:"
+echo "  import ${OUTPUT_NAME}Image from \"assets/images/${OUTPUT_NAME}.webp\";"
+echo ""
+echo "  // Add to preload():"
+echo "  this.load.image(\"${OUTPUT_NAME}\", ${OUTPUT_NAME}Image);"
+echo ""
+echo "  // Use in scene:"
+echo "  const sprite = scene.add.image(x, y, \"${OUTPUT_NAME}\");"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/skills/ball_sort.aigameplay/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: ball_sort.aigameplay
+description: 球排序核心玩法封包 - 水管/试管球排序的 PGS 实现，玩家通过移动彩色球让每个容器中的球颜色一致
+triggers: 球排序,ball sort,水排序,water sort,试管,tube,容器,排序,sorting,puzzle,玩法,gameplay
+---
+
+# ball_sort.aigameplay
+
+球排序（水排序）核心玩法封包。实现标准球排序规则的 PGS JSON 和 reducer，玩家将球从一个容器移到另一个容器，目标是让每个容器中的球颜色完全相同。
+
+## Recipe
+
+- **玩法类型**：ball_sort（球排序/水排序）
+- **参考文件**：
+  - `ref/pgs-schema.json`：PGS (PlayCraft Gameplay Schema) 规则骨架（entities、rules、algorithm、testCases）
+  - `ref/reducer.template.ts`：reducer 接口约束模板（`init` / `dispatch` / `getState` + 分步函数）
+- **核心规则**：
+  - `tubeCapacity`: 4（每个容器最多容纳 4 个球）
+  - `moveRule`: top_ball_only（只能移动最顶层的球）
+  - `validMoveCheck`: same_color_or_empty_target（目标容器顶部颜色相同或容器为空）+ capacity_check（目标未满）
+  - `emptyTubeCount`: 2（额外提供 2 个空容器作为缓冲）
+- **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 变体**：
+  - 更多颜色：修改 `colorCount` 提升难度
+  - 更大容量：修改 `tubeCapacity` 改变玩法深度
+  - 限步模式：添加 `maxMoves` 规则限制操作次数
+
+## Result
+
+- **产物文件**：`reducer.ts`
+- **格式**：TypeScript，导出 `init(config)`、`dispatch(state, action)`、`getState(state)` + 分步函数接口
+- **验证**：所有 testCases 必须通过
+
+## 渲染集成（⚠️ 场景层必读）
+
+### 设计原则：逻辑与动画分离
+
+reducer 提供两套接口：
+
+| 接口 | 适用场景 | 特点 |
+|------|---------|------|
+| `dispatch()` | 无头测试、AI 模拟、跳过动画 | 一步到位，只返回最终状态 |
+| 分步函数 | **渲染层/GameScene** | 逐步执行，返回中间过程数据 |
+
+### ⚠️ 禁止在渲染层使用 dispatch() 然后全量重建容器
+
+正确做法是**分步驱动动画链**：
+
+```ts
+// ✅ 正确做法：逐步调用分步函数，每步之间插入动画
+// Step 1: 验证移动是否合法
+const valid = isValidMove(state, fromTube, toTube);
+if (!valid) { playShakeAnimation(fromTube); return; }
+
+// Step 2: 执行移动，获取被移动的球信息
+const { ball, newState } = moveBall(state, fromTube, toTube);
+await playBallMoveAnimation(ball, fromTube, toTube);  // 只对该球做弧线移动动画
+
+// Step 3: 检测胜利
+const win = checkWin(newState);
+if (win) { playWinAnimation(); return; }
+
+// Step 4: 检测死锁
+const validMoves = findValidMoves(newState);
+if (validMoves.length === 0) { playDeadlockAnimation(); }
+```
+
+### 分步函数返回值与动画映射
+
+| 分步函数 | 返回值 | 场景层动画 |
+|---------|--------|-----------|
+| `isValidMove()` | `boolean` | false → 播放容器抖动/禁止提示动画 |
+| `moveBall()` | `{ ball, fromTube, toTube, newState }` | 对该球播放弧线移动 Tween 到目标容器顶部 |
+| `checkWin()` | `boolean` | true → 播放通关庆祝动画 |
+| `findValidMoves()` | `Move[]` | 空数组 → 触发死锁提示（Hint 按钮高亮） |
+
+## Binding
+
+- **Binding Role**：`gameplayRule`
+- **挂载目标**：`game/gameplay/ball_sort/reducer.ts`
+- **引用类型**：`gameplay-module-reference`
+- **接口契约**：`init(config)` / `dispatch(state, action)` / `getState(state)` / `isValidMove()` / `moveBall()` / `checkWin()` / `findValidMoves()`
+
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are implementing a ball sort (water sort) core gameplay module following the PGS specification.
+  Write the PGS JSON with entities, rules, algorithm, and testCases.
+  Implement the reducer.ts with:
+    - init/dispatch/getState (一体化接口，用于测试)
+    - isValidMove/moveBall/checkWin/findValidMoves (分步函数，用于渲染层动画驱动)
+  Key constraints:
+    - Only the top ball of each tube can be moved
+    - A ball can only move to a tube if the top color matches OR the tube is empty
+    - A tube can only receive a ball if it has capacity remaining
+    - Win condition: every tube contains balls of only one color (or is empty)
+    - Lose/deadlock: no valid moves exist
+  The step-by-step functions are CRITICAL for smooth ball move animations.
+  Run the testCases to verify the logic before finalizing.
+  Apply the Binding to wire the reducer into the game's gameplay module path.

package/skills/ball_sort.aigameplay/manifest.json

@@ -0,0 +1,155 @@
+{
+  "schemaVersion": 1,
+  "atomId": "ball_sort.aigameplay",
+  "bundleType": "aigameplay",
+  "category": "gameplay",
+  "mode": "fixed",
+  "label": {
+    "zh": "球排序核心玩法",
+    "en": "Ball sort core gameplay"
+  },
+  "tags": [
+    "gameplay",
+    "ball-sort",
+    "puzzle",
+    "sorting",
+    "tubes",
+    "casual",
+    "core"
+  ],
+  "bindingRoles": [
+    "gameplayRule"
+  ],
+  "imports": [
+    {
+      "slot": "engine",
+      "pinAtomId": "phaser.aicomponent",
+      "edgeKind": "requires",
+      "bindAs": "engine"
+    },
+    {
+      "slot": "bgMusic",
+      "description": "背景循环音乐",
+      "bindAs": "bgm",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "bgMusic"
+      ],
+      "allowedBundleTypes": [
+        "aiaudio"
+      ],
+      "constraints": {
+        "loop": true
+      }
+    },
+    {
+      "slot": "background",
+      "description": "游戏背景图",
+      "bindAs": "bg",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "backgroundTexture"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "winPanel",
+      "description": "通关反馈面板视觉",
+      "bindAs": "winPanel",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "successFeedbackPanel"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "tutorial",
+      "description": "新手引导浮层",
+      "bindAs": "tutorial",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "tutorialOverlay"
+      ],
+      "allowedBundleTypes": [
+        "aicomponent"
+      ]
+    },
+    {
+      "slot": "losePanel",
+      "description": "失败反馈面板视觉",
+      "bindAs": "losePanel",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "failFeedbackPanel"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "endScreen",
+      "description": "可玩广告结算屏（含 CTA 按钮）",
+      "bindAs": "endScreen",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "playableEndScreenLayout"
+      ],
+      "allowedBundleTypes": [
+        "aicomponent"
+      ]
+    }
+  ],
+  "generation": {
+    "kind": "pgs",
+    "pgsVersion": "1.0",
+    "gameplayType": "ball_sort",
+    "rules": {
+      "tubeCapacity": 4,
+      "emptyTubeCount": 2,
+      "colorCount": 6,
+      "moveRule": "top_ball_only",
+      "validMoveCheck": [
+        "same_color_or_empty_target",
+        "capacity_check"
+      ]
+    }
+  },
+  "result": {
+    "outputFile": "reducer.ts",
+    "format": "typescript",
+    "constraints": {
+      "testCasesMustPass": true
+    }
+  },
+  "binding": {
+    "role": "gameplayRule",
+    "target": "game/gameplay/ball_sort/reducer.ts",
+    "type": "gameplay-module-reference",
+    "constraints": {
+      "interface": [
+        "init(config)",
+        "dispatch(state, action)",
+        "getState(state)",
+        "isValidMove(state, from, to)",
+        "moveBall(state, from, to)",
+        "checkWin(state)",
+        "findValidMoves(state)"
+      ]
+    }
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "pgsSchema": "ref/pgs-schema.json",
+    "reducerTemplate": "ref/reducer.template.ts"
+  }
+}