@playcraft/skills 0.0.2

package/skills/sniper_shot.aigameplay/manifest.json

@@ -0,0 +1,153 @@
+{
+  "schemaVersion": 1,
+  "atomId": "sniper_shot.aigameplay",
+  "bundleType": "aigameplay",
+  "category": "gameplay",
+  "mode": "fixed",
+  "label": {
+    "zh": "狙击射击玩法",
+    "en": "Sniper Shot gameplay"
+  },
+  "tags": [
+    "gameplay",
+    "sniper",
+    "shooting",
+    "action",
+    "aim",
+    "casual"
+  ],
+  "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": "tutorial",
+      "description": "新手引导浮层",
+      "bindAs": "tutorial",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "tutorialOverlay"
+      ],
+      "allowedBundleTypes": [
+        "aicomponent"
+      ]
+    },
+    {
+      "slot": "winPanel",
+      "description": "通关反馈面板视觉",
+      "bindAs": "winPanel",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "successFeedbackPanel"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "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": "sniper_shot",
+    "rules": {
+      "scopeDriftEnabled": true,
+      "breathCycleMs": 3000,
+      "windEnabled": true,
+      "friendlyFirePenalty": true,
+      "maxFriendlyFireHits": 1
+    }
+  },
+  "result": {
+    "outputFile": "reducer.ts",
+    "format": "typescript",
+    "constraints": {
+      "testCasesMustPass": true
+    }
+  },
+  "binding": {
+    "role": "gameplayRule",
+    "target": "game/gameplay/sniper_shot/reducer.ts",
+    "type": "gameplay-module-reference",
+    "constraints": {
+      "interface": [
+        "init(config)",
+        "dispatch(action)",
+        "getState()",
+        "aimScope(state, dx, dy)",
+        "applyBreathDrift(state, deltaMs)",
+        "shoot(state)",
+        "hitDetection(state, scopePos)",
+        "updateTargets(state, deltaMs)",
+        "calculateScore(hit, target)"
+      ]
+    }
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "pgsSchema": "ref/pgs-schema.json",
+    "reducerTemplate": "ref/reducer.template.ts"
+  }
+}

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

@@ -0,0 +1,211 @@
+{
+  "_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 狙击射击玩法。Agent 以此为起点编写或 fork 玩法规则。",
+  "version": "1.0",
+  "gameplayType": "sniper_shot",
+  "entities": {
+    "scope": {
+      "type": "aim-overlay",
+      "description": "瞄准镜，覆盖在场景上的瞄准视图",
+      "fields": {
+        "position": { "type": "vec2", "description": "瞄准镜中心坐标（世界空间）" },
+        "driftOffset": { "type": "vec2", "description": "呼吸抖动叠加偏移量，周期性变化" },
+        "zoom": { "type": "number", "default": 4, "description": "当前放大倍数（2/4/8）" }
+      }
+    },
+    "targets": {
+      "type": "entity-list",
+      "description": "场景中的所有目标",
+      "item": {
+        "id": { "type": "string" },
+        "targetType": { "type": "enum", "values": ["enemy", "civilian"], "description": "敌人可击杀，平民误伤扣分" },
+        "position": { "type": "vec2" },
+        "radius": { "type": "number", "description": "命中判定圆半径（px）" },
+        "movementPattern": {
+          "type": "enum",
+          "values": ["static", "linear", "patrol", "random"],
+          "description": "运动模式"
+        },
+        "movementSpeed": { "type": "number", "default": 0 },
+        "patrolPoints": { "type": "vec2[]", "description": "巡逻路径点（patrol 模式）" },
+        "state": { "type": "enum", "values": ["alive", "dead"], "default": "alive" }
+      }
+    },
+    "wind": {
+      "type": "environmental",
+      "description": "风力，影响弹道偏移",
+      "fields": {
+        "direction": { "type": "number", "description": "风向角度（度，0=右，90=下）" },
+        "strength": { "type": "number", "description": "风力强度（0~1），影响弹道偏移量" }
+      }
+    },
+    "ammoCount": {
+      "type": "counter",
+      "initial": 10,
+      "description": "剩余子弹数（由 config 覆盖）"
+    },
+    "score": {
+      "type": "counter",
+      "initial": 0,
+      "description": "当前得分"
+    },
+    "friendlyFireCount": {
+      "type": "counter",
+      "initial": 0,
+      "description": "误伤平民次数"
+    }
+  },
+  "rules": {
+    "aim": {
+      "description": "玩家拖动屏幕，移动瞄准镜中心位置",
+      "input": "drag (dx, dy)",
+      "effect": "scope.position += (dx, dy)，受边界钳制"
+    },
+    "breathe_cycle": {
+      "description": "瞄准镜随呼吸周期自动漂移，形成正弦曲线抖动",
+      "period": "breathCycleMs（默认 3000ms）",
+      "amplitude": { "base": 8, "zoomScale": "amplitude / zoom", "description": "放大倍数越高抖动越小" },
+      "formula": "driftOffset.x = sin(t/period * 2π) * amplitude; driftOffset.y = cos(t/period * 2π) * amplitude * 0.5"
+    },
+    "wind_correction": {
+      "description": "玩家需手动调整瞄准偏移来补偿风力",
+      "trajectoryOffset": "wind.strength * wind.direction_vector * 20px（基础偏移量）",
+      "note": "实际命中检测使用 scope.position + wind_trajectory_offset，玩家须预判"
+    },
+    "shoot": {
+      "description": "玩家点击屏幕发射子弹",
+      "steps": [
+        "1. ammoCount - 1",
+        "2. 计算有效瞄准位置 = scope.position + driftOffset + wind_trajectory_offset",
+        "3. 检测命中：遍历所有 alive 目标，判断有效瞄准位置是否在目标圆内",
+        "4a. 命中 enemy：target.state = dead，score += calculateScore(target)",
+        "4b. 命中 civilian：friendlyFireCount++，score -= 200，若 friendlyFireCount >= max 则 gameOver",
+        "4c. 未命中：无效果"
+      ]
+    },
+    "target_move": {
+      "description": "目标按运动模式移动",
+      "linear": "以固定速度向初始方向运动，碰壁反弹",
+      "patrol": "在 patrolPoints 之间来回巡逻",
+      "random": "每隔 1~3 秒随机改变方向"
+    },
+    "ammo_depletion": {
+      "description": "子弹耗尽时检查胜负条件"
+    }
+  },
+  "algorithm": {
+    "description": "主循环：aim → drift → shoot → check",
+    "steps": [
+      "1. 每帧：applyBreathDrift(deltaMs) 更新 scope.driftOffset",
+      "2. 每帧：updateTargets(deltaMs) 按运动模式移动目标",
+      "3. 玩家拖动：aimScope(dx, dy) 移动 scope.position",
+      "4. 玩家点击射击：shoot()",
+      "   4a. ammoCount - 1",
+      "   4b. hitDetection(effectiveScopePos)",
+      "   4c. 根据命中类型更新 score / friendlyFireCount / target.state",
+      "5. 检查胜负：",
+      "   - Win: 所有 enemy targets 均为 dead",
+      "   - Lose: ammoCount == 0 且仍有 alive enemy，或 friendlyFireCount >= maxFriendlyFireHits"
+    ]
+  },
+  "winCondition": {
+    "type": "all_enemies_eliminated",
+    "description": "在子弹耗尽前，将所有 enemy 类型目标射杀"
+  },
+  "loseCondition": {
+    "type": "ammo_exhausted_or_friendly_fire",
+    "description": "ammoCount == 0 且有 alive enemy，或累计误伤平民超过 maxFriendlyFireHits"
+  },
+  "testCases": [
+    {
+      "id": "tc_direct_hit_win",
+      "description": "直接命中：瞄准位置正好在唯一敌人圆内，射击后胜利",
+      "initialState": {
+        "scope": { "position": { "x": 200, "y": 150 }, "driftOffset": { "x": 0, "y": 0 }, "zoom": 4 },
+        "targets": [
+          { "id": "enemy_1", "targetType": "enemy", "position": { "x": 200, "y": 150 }, "radius": 20, "movementPattern": "static", "state": "alive" }
+        ],
+        "wind": { "direction": 0, "strength": 0 },
+        "ammoCount": 3,
+        "score": 0,
+        "friendlyFireCount": 0
+      },
+      "actions": [
+        { "type": "shoot" }
+      ],
+      "expectedState": {
+        "targets[0].state": "dead",
+        "ammoCount": 2,
+        "score": { "min": 100 },
+        "gameOver": false,
+        "win": true
+      }
+    },
+    {
+      "id": "tc_miss_ammo_depleted",
+      "description": "连续射失：子弹耗尽仍有存活敌人，游戏失败",
+      "initialState": {
+        "scope": { "position": { "x": 0, "y": 0 }, "driftOffset": { "x": 0, "y": 0 }, "zoom": 4 },
+        "targets": [
+          { "id": "enemy_1", "targetType": "enemy", "position": { "x": 300, "y": 300 }, "radius": 20, "movementPattern": "static", "state": "alive" }
+        ],
+        "wind": { "direction": 0, "strength": 0 },
+        "ammoCount": 1,
+        "score": 0,
+        "friendlyFireCount": 0
+      },
+      "actions": [
+        { "type": "shoot" }
+      ],
+      "expectedState": {
+        "targets[0].state": "alive",
+        "ammoCount": 0,
+        "win": false,
+        "gameOver": true
+      }
+    },
+    {
+      "id": "tc_civilian_hit_penalty",
+      "description": "误伤平民：命中平民扣分，friendlyFireCount 达上限后游戏失败",
+      "initialState": {
+        "scope": { "position": { "x": 150, "y": 150 }, "driftOffset": { "x": 0, "y": 0 }, "zoom": 4 },
+        "targets": [
+          { "id": "civilian_1", "targetType": "civilian", "position": { "x": 150, "y": 150 }, "radius": 20, "movementPattern": "static", "state": "alive" },
+          { "id": "enemy_1", "targetType": "enemy", "position": { "x": 400, "y": 400 }, "radius": 20, "movementPattern": "static", "state": "alive" }
+        ],
+        "wind": { "direction": 0, "strength": 0 },
+        "ammoCount": 5,
+        "score": 500,
+        "friendlyFireCount": 0,
+        "config": { "maxFriendlyFireHits": 1 }
+      },
+      "actions": [
+        { "type": "shoot" }
+      ],
+      "expectedState": {
+        "friendlyFireCount": 1,
+        "score": 300,
+        "win": false,
+        "gameOver": true
+      }
+    },
+    {
+      "id": "tc_breath_drift_applied",
+      "description": "呼吸抖动：经过半个呼吸周期后 driftOffset 不为零",
+      "initialState": {
+        "scope": { "position": { "x": 200, "y": 200 }, "driftOffset": { "x": 0, "y": 0 }, "zoom": 4 },
+        "targets": [],
+        "wind": { "direction": 0, "strength": 0 },
+        "ammoCount": 5,
+        "score": 0,
+        "friendlyFireCount": 0,
+        "breathTimer": 0
+      },
+      "actions": [
+        { "type": "tick", "deltaMs": 1500 }
+      ],
+      "expectedState": {
+        "scope.driftOffset.x": { "notEqual": 0 }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,211 @@
+/**
+ * sniper_shot.aigameplay — reducer 接口模板
+ *
+ * Agent 生成实际 reducer 时，必须导出以下函数。
+ * 此文件是接口约束模板，不是可执行代码。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * ⚠️ 重要：渲染层（GameScene）不应直接调用 dispatch()
+ *
+ * dispatch() 是一体化接口，内部跑完整个射击判定后只返回最终状态，
+ * 中间过程（瞄准位置、呼吸偏移、命中特效触发点）全部丢失。
+ *
+ * 渲染层需要分步动画（抖动更新 → 移动精灵 → 枪声+特效 → HUD 刷新），
+ * 因此必须使用下方的「分步函数」逐步驱动，每步之间播放对应动画。
+ *
+ * dispatch() 的用途：无头测试、AI 模拟、快速跳过动画等场景。
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+// ─── 配置类型 ─────────────────────────────────────────────────────────────────
+
+export type SniperConfig = {
+  /** 场景宽度（px） */
+  sceneWidth: number;
+  /** 场景高度（px） */
+  sceneHeight: number;
+  /** 初始子弹数 */
+  initialAmmo: number;
+  /** 瞄准镜默认放大倍数 */
+  defaultZoom: number;
+  /** 呼吸周期（ms） */
+  breathCycleMs: number;
+  /** 呼吸抖动基础振幅（px，zoom=1 时） */
+  breathAmplitude: number;
+  /** 风力是否启用 */
+  windEnabled: boolean;
+  /** 最大误伤次数（超过则游戏失败） */
+  maxFriendlyFireHits: number;
+  /** 命中敌人基础得分 */
+  baseScorePerKill: number;
+};
+
+// ─── 动作类型 ─────────────────────────────────────────────────────────────────
+
+export type SniperAction =
+  | { type: 'aim'; dx: number; dy: number }
+  | { type: 'shoot' }
+  | { type: 'tick'; deltaMs: number }
+  | { type: 'reset' };
+
+// ─── 状态类型 ─────────────────────────────────────────────────────────────────
+
+export type Vec2 = { x: number; y: number };
+
+export type TargetType = 'enemy' | 'civilian';
+export type TargetState = 'alive' | 'dead';
+export type MovementPattern = 'static' | 'linear' | 'patrol' | 'random';
+
+export type Target = {
+  id: string;
+  targetType: TargetType;
+  position: Vec2;
+  radius: number;
+  movementPattern: MovementPattern;
+  movementSpeed: number;
+  patrolPoints: Vec2[];
+  patrolIndex: number;
+  randomMoveTimer: number;
+  moveDirection: Vec2;
+  state: TargetState;
+};
+
+export type Wind = {
+  direction: number;
+  strength: number;
+};
+
+export type Scope = {
+  position: Vec2;
+  driftOffset: Vec2;
+  zoom: number;
+};
+
+export type SniperState = {
+  scope: Scope;
+  targets: Target[];
+  wind: Wind;
+  ammoCount: number;
+  score: number;
+  friendlyFireCount: number;
+  breathTimer: number;
+  gameOver: boolean;
+  win: boolean;
+  lastShotResult: ShootResult | null;
+};
+
+// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
+
+export type HitResult = {
+  hit: boolean;
+  targetId: string | null;
+  targetType: TargetType | null;
+};
+
+export type ShootResult = {
+  hit: boolean;
+  targetId: string | null;
+  isCivilian: boolean;
+  scoreGained: number;
+  scoreLost: number;
+  effectiveScopePos: Vec2;
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 必须导出的函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+
+/**
+ * init：根据配置初始化游戏状态
+ */
+export declare function init(config: SniperConfig, targets: Target[], wind?: Wind): SniperState;
+
+// ─── 一体化接口（测试/AI 模拟用） ───────────────────────────────────────────
+
+/**
+ * dispatch：接收动作，返回新状态（纯函数，不得修改原 state）
+ * - aim：移动瞄准镜位置
+ * - shoot：发射子弹，包含命中检测、计分、胜负判定（一步到位）
+ * - tick：更新物理（呼吸抖动、目标移动）
+ * - reset：重置到初始状态
+ *
+ * ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
+ */
+export declare function dispatch(state: SniperState, action: SniperAction): SniperState;
+
+/**
+ * getState：返回当前状态快照
+ */
+export declare function getState(state: SniperState): SniperState;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 分步函数（渲染层/场景层必须使用这些函数驱动动画）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * aimScope：玩家拖动屏幕，移动瞄准镜中心位置
+ * 返回更新后的 scope position（已钳制在场景边界内）
+ *
+ * 场景层根据返回值移动瞄准镜 overlay Sprite/Container 的位置。
+ */
+export declare function aimScope(
+  state: SniperState,
+  dx: number,
+  dy: number,
+): { scopePos: Vec2 };
+
+/**
+ * applyBreathDrift：更新呼吸抖动偏移
+ * 基于正弦函数，每帧调用，deltaMs 为帧时长
+ *
+ * 场景层将 driftOffset 叠加到瞄准镜显示位置（但不修改 scope.position）。
+ * driftOffset 随 zoom 增大而减小（放大镜稳定瞄准）。
+ */
+export declare function applyBreathDrift(
+  state: SniperState,
+  deltaMs: number,
+): { driftOffset: Vec2 };
+
+/**
+ * shoot：执行射击
+ * 内部调用 hitDetection，根据结果更新 ammoCount / score / target.state / friendlyFireCount
+ *
+ * 场景层根据返回值：
+ * - 播放枪声音效
+ * - 若 hit=true 且非平民：播放命中特效
+ * - 若 hit=true 且平民：播放误伤警告
+ * - 更新 HUD（弹药数、得分）
+ */
+export declare function shoot(state: SniperState): ShootResult;
+
+/**
+ * hitDetection：判断有效瞄准位置是否命中任何目标
+ * 有效瞄准位置 = scope.position + scope.driftOffset + wind_trajectory_offset
+ */
+export declare function hitDetection(
+  state: SniperState,
+  scopePos: Vec2,
+): HitResult;
+
+/**
+ * updateTargets：按运动模式更新所有目标位置
+ * 每帧调用，deltaMs 为帧时长
+ *
+ * 场景层根据返回的 targets 数组更新每个目标精灵的位置。
+ */
+export declare function updateTargets(
+  state: SniperState,
+  deltaMs: number,
+): Target[];
+
+/**
+ * calculateScore：计算命中该类型目标所得的分数
+ * - enemy：baseScorePerKill（可加距离/难度系数）
+ * - civilian：负分（-200）
+ */
+export declare function calculateScore(
+  hit: boolean,
+  target: Target,
+): number;

package/skills/solitaire.aigameplay/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: solitaire.aigameplay
+description: Klondike 纸牌接龙核心玩法封包 - 标准 7 列牌堆、翻牌堆、4 个花色目标堆的 PGS 实现
+triggers: 纸牌,solitaire,接龙,klondike,扑克,poker,cards,牌堆,tableau,foundation,stock,waste,翻牌,移牌
+---
+
+# solitaire.aigameplay
+
+Klondike 纸牌接龙核心玩法封包。实现标准 Klondike 单人纸牌接龙的 PGS (PlayCraft Gameplay Schema, 玩法定义规范) JSON 和 reducer。7 列牌堆（交替颜色降序叠放）+ 翻牌堆 + 4 个花色目标堆（A→K），将所有牌移到目标堆则胜利。
+
+## Recipe
+
+- **玩法类型**：solitaire（Klondike 纸牌接龙）
+- **参考文件**：
+  - `ref/pgs-schema.json`：PGS 规则骨架（entities、rules、algorithm、testCases）
+  - `ref/reducer.template.ts`：reducer 接口约束模板
+- **核心规则**：
+  - `tableauColumns`: 7（7 列牌堆，第 i 列初始有 i 张牌，最上面翻开）
+  - `foundationPiles`: 4（4 个花色目标堆：♠♥♦♣）
+  - `drawCount`: 1（翻牌堆每次翻 1 张）
+  - `stockRecycleLimit`: -1（-1 表示无限次循环翻牌堆）
+- **移牌规则**：
+  - `move_to_tableau`：目标列顶牌 face_up，且颜色交替（红↔黑），数值恰好比移动牌大 1
+  - `move_to_foundation`：目标堆同花色，数值比当前堆顶大 1（空堆只接受 A）
+  - 空列（tableau）只接受 K 作为起始牌
+- **PGS Agent 操作流程**：
+  1. 读取 `ref/pgs-schema.json` 作为规则骨架起点
+  2. 读取 `ref/reducer.template.ts` 了解接口约束
+  3. 实现 `reducer.ts`，导出所有必需函数
+  4. 翻牌逻辑：移走 tableau 顶牌后，若新顶牌 face_down → 自动翻开
+  5. 运行 `ref/pgs-schema.json` 中的所有 `testCases`，全部通过后才算完成
+- **自动完成（auto_complete）**：
+  - 当所有牌都已翻面（face_up）时，可启用自动完成
+  - 自动将可移到目标堆的牌逐一移入
+- **可 fork 变体**：
+  - Spider Solitaire：2副牌，8列，可同色叠放
+  - FreeCell：4个自由格，不同叠牌规则
+  - 计时/计分模式：添加时间奖励分、撤销惩罚
+
+## Result
+
+- **产物文件**：`reducer.ts`
+- **格式**：TypeScript，导出 `init(config)`、`dispatch(action)`、`getState()` + 分步函数接口
+- **验证**：所有 testCases 必须通过
+
+## 渲染集成（⚠️ 场景层必读）
+
+### 设计原则：逻辑校验先行，动画后置
+
+```ts
+// ✅ 正确做法：先验证合法性，再播放动画
+// Step 1: 玩家拖动一组牌到目标列
+const targetCol = getDropTargetColumn(dragPos);
+const movingCards = state.tableau[fromCol].slice(-count);
+
+// Step 2: 验证是否合法
+const canMove = canMoveToTableau(state, movingCards[0], targetCol);
+if (!canMove) {
+  await playSnapbackAnimation(movingCards);
+  return;
+}
+
+// Step 3: 执行移牌
+const newState = moveCards(state, { zone: 'tableau', col: fromCol }, { zone: 'tableau', col: targetCol }, count);
+
+// Step 4: 若源列有牌需要翻面
+if (newState.lastFlipped) {
+  await playFlipAnimation(fromCol);
+}
+
+// Step 5: 检查是否可以自动完成
+if (newState.allFaceUp) {
+  triggerAutoComplete(newState);
+}
+```
+
+## Binding
+
+- **Binding Role**：`gameplayRule`
+- **挂载目标**：`game/gameplay/solitaire/reducer.ts`
+- **引用类型**：`gameplay-module-reference`
+- **接口契约**：`init(config)` / `dispatch(action)` / `getState()` / `canMoveToTableau()` / `canMoveToFoundation()` / `moveCards()` / `drawFromStock()` / `getValidMoves()`
+
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are implementing a Klondike Solitaire gameplay module following the PGS specification.
+  Write the PGS JSON with entities, rules, algorithm, and testCases.
+  Implement the reducer.ts with:
+    - init/dispatch/getState (一体化接口，用于测试)
+    - canMoveToTableau/canMoveToFoundation/moveCards/drawFromStock/getValidMoves (分步函数)
+  Card suits: 'S' (Spades♠), 'H' (Hearts♥), 'D' (Diamonds♦), 'C' (Clubs♣)
+  Card colors: Spades+Clubs = black, Hearts+Diamonds = red
+  Tableau rule: alternating color, descending value (K=13, Q=12, J=11, A=1)
+  Foundation rule: same suit, ascending from A (1) to K (13)
+  After moving cards, auto-flip the new top card of source column if face_down.
+  Run the testCases to verify the logic before finalizing.