@playcraft/skills 0.0.2

package/skills/eight_ball_pool.aigameplay/manifest.json

@@ -0,0 +1,152 @@
+{
+  "schemaVersion": 1,
+  "atomId": "eight_ball_pool.aigameplay",
+  "bundleType": "aigameplay",
+  "category": "gameplay",
+  "mode": "fixed",
+  "label": {
+    "zh": "8球台球玩法",
+    "en": "8-Ball Pool gameplay"
+  },
+  "tags": [
+    "gameplay",
+    "billiards",
+    "pool",
+    "physics",
+    "aim",
+    "sports"
+  ],
+  "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": "eight_ball_pool",
+    "rules": {
+      "ballCount": 16,
+      "pocketCount": 6,
+      "physicsStepsPerFrame": 10,
+      "minSeparationAngle": 5,
+      "singlePlayer": true
+    }
+  },
+  "result": {
+    "outputFile": "reducer.ts",
+    "format": "typescript",
+    "constraints": {
+      "testCasesMustPass": true
+    }
+  },
+  "binding": {
+    "role": "gameplayRule",
+    "target": "game/gameplay/eight_ball_pool/reducer.ts",
+    "type": "gameplay-module-reference",
+    "constraints": {
+      "interface": [
+        "init(config)",
+        "dispatch(action)",
+        "getState()",
+        "aimCueBall(state, angle, power)",
+        "shootCueBall(state)",
+        "applyPhysicsStep(state, dt)",
+        "checkPockets(state)",
+        "determineTurn(state)"
+      ]
+    }
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "pgsSchema": "ref/pgs-schema.json",
+    "reducerTemplate": "ref/reducer.template.ts"
+  }
+}

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

@@ -0,0 +1,205 @@
+{
+  "_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 8球台球简化版。Agent 以此为起点编写或 fork 玩法规则。",
+  "version": "1.0",
+  "gameplayType": "eight_ball_pool",
+  "entities": {
+    "table": {
+      "type": "play-field",
+      "width": 1000,
+      "height": 500,
+      "description": "台球桌，包含6个球袋",
+      "pockets": [
+        { "id": "top_left",     "x": 0,    "y": 0   },
+        { "id": "top_mid",      "x": 500,  "y": 0   },
+        { "id": "top_right",    "x": 1000, "y": 0   },
+        { "id": "bot_left",     "x": 0,    "y": 500 },
+        { "id": "bot_mid",      "x": 500,  "y": 500 },
+        { "id": "bot_right",    "x": 1000, "y": 500 }
+      ],
+      "pocketRadius": 28
+    },
+    "ball": {
+      "type": "physics-object",
+      "radius": 14,
+      "description": "台球实体，包含白球(cue)、实心球(solid,1-7)、条纹球(stripe,9-15)、黑8(eight)",
+      "fields": {
+        "id":       { "type": "integer",  "range": [0, 15], "description": "0=白球，1-7=实心，8=黑球，9-15=条纹" },
+        "type":     { "type": "enum",     "values": ["cue", "solid", "stripe", "eight"] },
+        "position": { "type": "vector2",  "description": "球心坐标 {x, y}" },
+        "velocity": { "type": "vector2",  "description": "当前速度 {vx, vy}，单位 px/s" },
+        "state":    { "type": "enum",     "values": ["on_table", "pocketed"], "default": "on_table" }
+      }
+    },
+    "aim": {
+      "type": "input-state",
+      "description": "当前瞄准状态",
+      "fields": {
+        "angle": { "type": "number",  "range": [0, 360], "description": "击球方向角度（度），0=向右" },
+        "power": { "type": "number",  "range": [0, 100], "description": "力度百分比" }
+      }
+    },
+    "turn_state": {
+      "type": "game-state",
+      "description": "回合状态",
+      "fields": {
+        "playerGroup": { "type": "enum",    "values": ["solid", "stripe", "unassigned"], "default": "unassigned" },
+        "pocketedOwn": { "type": "integer", "default": 0, "description": "已入袋的己方球数量" },
+        "phase":       { "type": "enum",    "values": ["assign", "clear_own", "sink_eight"], "default": "assign" },
+        "ballsMoving": { "type": "boolean", "default": false },
+        "shotInProgress": { "type": "boolean", "default": false }
+      }
+    },
+    "score": {
+      "type": "counter",
+      "initial": 0,
+      "description": "当前得分（每入袋己方球+100，消灭对方球-50，仅用于展示）"
+    }
+  },
+  "rules": {
+    "aim_cue_ball": {
+      "description": "玩家设置白球击打角度和力度，不消耗回合",
+      "trigger": "player_input",
+      "effect": "update aim.angle and aim.power"
+    },
+    "shoot": {
+      "description": "玩家确认击打：给白球施加速度 velocity = power × maxSpeed × direction(angle)",
+      "trigger": "player_confirm",
+      "effect": "cue_ball.velocity = powerToVelocity(aim.power, aim.angle); turn_state.shotInProgress = true"
+    },
+    "physics_step": {
+      "description": "每帧更新：所有球按速度移动，速度每帧乘以 frictionFactor（约0.985），低于阈值停止",
+      "frictionFactor": 0.985,
+      "stopThreshold": 1,
+      "wallBounce": true,
+      "ballCollision": "elastic"
+    },
+    "pocket_check": {
+      "description": "球心进入任意球袋半径内则进袋；白球进袋=犯规（scratch）",
+      "pocketRadius": 28,
+      "effects": {
+        "own_group_ball":  "ball.state=pocketed, pocketedOwn++, score+100",
+        "other_group_ball":"ball.state=pocketed（对方获利）",
+        "eight_ball_early":"game_over(lose) unless all own balls pocketed",
+        "eight_ball_win":  "game_over(win) if all own balls pocketed AND phase==sink_eight",
+        "cue_ball":        "scratch: cue ball respawn at kitchen area"
+      }
+    },
+    "turn_switch": {
+      "description": "所有球停止后检查回合结果：若入袋>=1个己方球则继续，否则结束本次回合",
+      "trigger": "all_balls_stopped"
+    },
+    "group_assign": {
+      "description": "首次入袋时根据球类型分配玩家球组",
+      "trigger": "first_pocket_event",
+      "effect": "playerGroup = ball.type (solid or stripe)"
+    }
+  },
+  "algorithm": {
+    "description": "主循环：aim → shoot → physics → pocket_check → turn_switch",
+    "steps": [
+      "1. 玩家调整瞄准参数（angle, power），可多次设置",
+      "2. 玩家确认击打，给白球赋予初始速度",
+      "3. 物理帧循环：移动所有球、处理碰撞、处理边界反弹",
+      "4. 每帧检测所有球是否进入球袋",
+      "5. 所有球停止后进行入袋判定：己方球入袋加分，犯规处理",
+      "6. 若 phase==assign 且首次有球入袋，分配玩家球组",
+      "7. 检测胜利（phase==sink_eight 且8号球入袋）或失败（8号球提前入袋/scratch on 8ball shot）",
+      "8. 回合切换，等待下一次击球"
+    ]
+  },
+  "winCondition": {
+    "type": "pocket_eight_ball",
+    "description": "先将己方7个球（实心或条纹）全部打入球袋，再将8号黑球打入球袋"
+  },
+  "loseCondition": {
+    "type": "foul_on_eight",
+    "description": "在己方球未全部入袋时打入8号球，或在击打8号球时白球入袋（scratch）"
+  },
+  "testCases": [
+    {
+      "id": "tc_pocket_own_ball",
+      "description": "成功入袋己方球（实心球）：白球击中1号实心球，1号球进袋",
+      "initialState": {
+        "balls": [
+          { "id": 0, "type": "cue",   "position": { "x": 300, "y": 250 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" },
+          { "id": 1, "type": "solid", "position": { "x": 30,  "y": 30  }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" }
+        ],
+        "turn_state": { "playerGroup": "solid", "pocketedOwn": 0, "phase": "clear_own" },
+        "aim": { "angle": 315, "power": 80 }
+      },
+      "actions": [
+        { "type": "shoot" },
+        { "type": "simulate_until_stop" }
+      ],
+      "expectedState": {
+        "ball_1_state": "pocketed",
+        "turn_state.pocketedOwn": 1,
+        "score_gained": 100
+      }
+    },
+    {
+      "id": "tc_win_sink_eight",
+      "description": "胜利条件：己方7球已全入袋，成功打入8号球",
+      "initialState": {
+        "balls": [
+          { "id": 0, "type": "cue",   "position": { "x": 500, "y": 250 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" },
+          { "id": 8, "type": "eight", "position": { "x": 480, "y": 25  }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" }
+        ],
+        "turn_state": { "playerGroup": "solid", "pocketedOwn": 7, "phase": "sink_eight" },
+        "aim": { "angle": 90, "power": 70 }
+      },
+      "actions": [
+        { "type": "shoot" },
+        { "type": "simulate_until_stop" }
+      ],
+      "expectedState": {
+        "gameOver": true,
+        "win": true,
+        "ball_8_state": "pocketed"
+      }
+    },
+    {
+      "id": "tc_scratch_lose",
+      "description": "失败：击打8号球时白球入袋（scratch on 8ball shot）",
+      "initialState": {
+        "balls": [
+          { "id": 0, "type": "cue",   "position": { "x": 500, "y": 470 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" },
+          { "id": 8, "type": "eight", "position": { "x": 500, "y": 400 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" }
+        ],
+        "turn_state": { "playerGroup": "solid", "pocketedOwn": 7, "phase": "sink_eight" },
+        "aim": { "angle": 90, "power": 100 }
+      },
+      "actions": [
+        { "type": "shoot" },
+        { "type": "simulate_until_stop" }
+      ],
+      "expectedState": {
+        "gameOver": true,
+        "win": false,
+        "loseReason": "scratch_on_eight_ball"
+      }
+    },
+    {
+      "id": "tc_early_eight_lose",
+      "description": "失败：己方球未清空时打入8号球",
+      "initialState": {
+        "balls": [
+          { "id": 0, "type": "cue",   "position": { "x": 500, "y": 250 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" },
+          { "id": 8, "type": "eight", "position": { "x": 480, "y": 25  }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" },
+          { "id": 1, "type": "solid", "position": { "x": 600, "y": 250 }, "velocity": { "vx": 0, "vy": 0 }, "state": "on_table" }
+        ],
+        "turn_state": { "playerGroup": "solid", "pocketedOwn": 6, "phase": "clear_own" },
+        "aim": { "angle": 90, "power": 70 }
+      },
+      "actions": [
+        { "type": "shoot" },
+        { "type": "simulate_until_stop" }
+      ],
+      "expectedState": {
+        "gameOver": true,
+        "win": false,
+        "loseReason": "eight_ball_pocketed_early"
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,198 @@
+/**
+ * eight_ball_pool.aigameplay — reducer 接口模板
+ *
+ * Agent 生成实际 reducer 时，必须导出以下函数。
+ * 此文件是接口约束模板，不是可执行代码。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * ⚠️ 重要：渲染层（GameScene）不应直接调用 dispatch()
+ *
+ * dispatch() 是一体化接口，内部跑完整个物理模拟后只返回最终状态，
+ * 中间每帧球的位置、碰撞事件、进袋事件全部丢失。
+ *
+ * 渲染层需要逐帧更新球的精灵位置，因此必须使用下方的「分步函数」，
+ * 每帧调用 applyPhysicsStep + checkPockets，渲染层根据状态更新精灵。
+ *
+ * dispatch() 的用途：无头测试、AI 模拟、快速跳过动画等场景。
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+// ─── 配置类型 ─────────────────────────────────────────────────────────────────
+
+export type EightBallConfig = {
+  /** 台球桌宽度（像素），默认 1000 */
+  tableWidth: number;
+  /** 台球桌高度（像素），默认 500 */
+  tableHeight: number;
+  /** 球的半径（像素），默认 14 */
+  ballRadius: number;
+  /** 球袋半径（像素），默认 28 */
+  pocketRadius: number;
+  /** 最大击球速度（像素/秒） */
+  maxShotSpeed: number;
+  /** 摩擦系数（每帧速度乘以此值，约 0.985） */
+  frictionFactor: number;
+  /** 球停止阈值（速度小于此值视为停止，像素/秒） */
+  stopThreshold: number;
+  /** 物理模拟每帧步数 */
+  physicsStepsPerFrame: number;
+};
+
+// ─── 核心类型 ─────────────────────────────────────────────────────────────────
+
+export type BallType = 'cue' | 'solid' | 'stripe' | 'eight';
+export type BallState = 'on_table' | 'pocketed';
+export type PlayerGroup = 'solid' | 'stripe' | 'unassigned';
+export type GamePhase = 'assign' | 'clear_own' | 'sink_eight';
+export type LoseReason = 'eight_ball_pocketed_early' | 'scratch_on_eight_ball' | null;
+
+export type Vector2 = { x: number; y: number };
+
+export type Ball = {
+  id: number;          // 0=白球，1-7=实心，8=黑球，9-15=条纹
+  type: BallType;
+  position: Vector2;
+  velocity: Vector2;
+  state: BallState;
+};
+
+export type Pocket = {
+  id: string;
+  position: Vector2;
+};
+
+// ─── 动作类型 ─────────────────────────────────────────────────────────────────
+
+export type EightBallAction =
+  | { type: 'aim'; angle: number; power: number }        // 设置瞄准参数
+  | { type: 'shoot' }                                     // 确认击球
+  | { type: 'simulate_until_stop' }                       // （测试用）模拟直到所有球停止
+  | { type: 'simulate_step'; dt: number }                 // 模拟单帧
+  | { type: 'reset' };
+
+// ─── 状态类型 ─────────────────────────────────────────────────────────────────
+
+export type EightBallState = {
+  balls: Ball[];
+  pockets: Pocket[];
+  aim: { angle: number; power: number };
+  playerGroup: PlayerGroup;
+  pocketedOwn: number;          // 已入袋的己方球数量
+  phase: GamePhase;
+  ballsMoving: boolean;
+  shotInProgress: boolean;
+  gameOver: boolean;
+  win: boolean;
+  loseReason: LoseReason;
+  score: number;
+  /** 上一次物理步骤产生的进袋事件 */
+  lastPocketEvents: PocketEvent[];
+  /** 上一次物理步骤产生的碰撞事件 */
+  lastCollisionEvents: CollisionEvent[];
+};
+
+// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
+
+/** 进袋事件 */
+export type PocketEvent = {
+  ballId: number;
+  pocketId: string;
+  ballType: BallType;
+  isOwnGroup: boolean;
+  isFoul: boolean;    // scratch（白球入袋）或提前入8号球
+};
+
+/** 球碰撞事件（渲染层可据此播放碰撞音效） */
+export type CollisionEvent = {
+  ball1Id: number;
+  ball2Id: number;
+  impactSpeed: number;  // 碰撞速度大小，用于决定音效强度
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 必须导出的函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+
+/**
+ * init：根据配置初始化游戏状态，摆放标准开球阵型（三角形排列）
+ */
+export declare function init(config: EightBallConfig): EightBallState;
+
+// ─── 一体化接口（测试/AI 模拟用） ───────────────────────────────────────────
+
+/**
+ * dispatch：接收动作，返回新状态（纯函数，不得修改原 state）
+ * - aim：设置瞄准参数
+ * - shoot：执行击球，模拟到所有球停止，返回最终状态
+ * - simulate_step：单帧物理模拟
+ * - simulate_until_stop：模拟直到所有球停止
+ * - reset：重置
+ *
+ * ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
+ */
+export declare function dispatch(state: EightBallState, action: EightBallAction): EightBallState;
+
+/**
+ * getState：返回当前状态快照
+ */
+export declare function getState(state: EightBallState): EightBallState;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 分步函数（渲染层/场景层必须使用这些函数逐帧驱动）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * aimCueBall：设置瞄准参数（角度和力度），不触发击球
+ * 渲染层在玩家拖动瞄准线时调用，用于预览击球方向
+ */
+export declare function aimCueBall(
+  state: EightBallState,
+  angle: number,   // 0~360 度
+  power: number,   // 0~100
+): EightBallState;
+
+/**
+ * shootCueBall：根据当前 aim 参数给白球施加初始速度
+ * 渲染层在玩家确认击球时调用，之后进入物理帧循环
+ */
+export declare function shootCueBall(state: EightBallState): EightBallState;
+
+/**
+ * applyPhysicsStep：执行单帧物理模拟
+ * - 更新所有球的位置（position += velocity × dt）
+ * - 应用摩擦力（velocity *= frictionFactor）
+ * - 处理边界反弹（velocity 分量取反）
+ * - 处理球与球碰撞（弹性碰撞，交换速度分量）
+ * - 返回包含碰撞事件的新状态
+ *
+ * 渲染层每帧调用此函数，根据 state.balls 更新精灵位置
+ */
+export declare function applyPhysicsStep(
+  state: EightBallState,
+  dt: number,  // 帧时间（秒），典型值 1/60
+): EightBallState;
+
+/**
+ * checkPockets：检测所有球是否进入球袋
+ * - 球心距任意球袋中心 <= pocketRadius → 进袋
+ * - 更新 ball.state = 'pocketed'
+ * - 白球进袋：scratch 处理
+ * - 8号球进袋：根据 phase 判断胜负
+ * - 返回含进袋事件的新状态
+ *
+ * 渲染层在每次 applyPhysicsStep 后调用，检测进袋并播放进袋动画
+ */
+export declare function checkPockets(state: EightBallState): EightBallState;
+
+/**
+ * determineTurn：所有球停止后，判断回合结果并更新 turn_state
+ * - 处理球组分配（首次进袋时）
+ * - 检测胜利/失败条件
+ * - 更新 phase（assign → clear_own → sink_eight）
+ * - 返回更新后的状态（含 gameOver/win 标记）
+ *
+ * 渲染层在检测到 ballsMoving 由 true 变为 false 时调用
+ */
+export declare function determineTurn(state: EightBallState): EightBallState;

package/skills/energetic_electronic.aiaudio/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: energetic_electronic.aiaudio
+description: 紧张电子 BGM 封包 - 高能量电子音乐循环，适合逃脱益智、箭头逃脱等需要营造紧迫感的游戏
+triggers: 背景音乐,bgm,紧张,tension,电子,electronic,激昂,energetic,逃脱,escape,紧迫,intense,合成器,synth
+---
+
+# energetic_electronic.aiaudio
+
+紧张电子 BGM 封包。高能量电子音乐，营造紧迫逃脱的游戏氛围，适合箭头逃脱、停车逃脱等玩法。
+
+## Recipe
+
+- **基础 prompt**：`intense energetic electronic loop, tension-building background music for escape puzzle game, driving beat, synth, 140 BPM`
+- **时长**：30 秒（循环）
+- **BPM**：约 140
+- **风格**：电子、合成器、紧张感
+- **可 fork 变体**：
+  - 极限紧张：BPM 提升至 160，加入倒计时节拍感
+  - 赛博朋克：添加 cyberpunk 风格合成器元素
+  - 动作冒险：加入打击乐器和管弦乐
+
+**生成步骤：**
+1. 调用音频生成 API，传入 prompt 和 30s 时长
+2. 验证时长并检查循环无缝衔接
+3. 写入 `audio.mp3`，更新 manifest
+
+## Result
+
+- **产物文件**：`audio.mp3`
+- **格式**：MP3，15-60 秒循环
+
+## Binding
+
+- **Binding Role**：`backgroundMusic`
+- **挂载目标**：`scene://entities/AudioManager/bgm/asset`
+- **引用类型**：`audio-asset-reference`
+- **播放模式**：loop
+
+## 生成方式
+
+Platform Skill: `playcraft-audio-generation`
+
+```bash
+# 1. 生成 BGM（Google Lyria 3，固定 30s）
+playcraft tools generate-bgm \
+     --prompt "intense energetic electronic loop, tension-building background music for escape puzzle game, driving beat, synth, 140 BPM" \
+     --style electronic \
+     --bpm 140 \
+     --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/asset --target-size 60KB
+
+# 4. 将产物写入 sandbox 对应路径（见 binding.target）
+```
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are generating an energetic electronic BGM for an escape puzzle game.
+  Follow the Recipe to generate a high-energy, tension-building electronic track.
+  Ensure the loop is seamless. Apply the Binding to the AudioManager.

package/skills/energetic_electronic.aiaudio/manifest.json

@@ -0,0 +1,51 @@
+{
+  "schemaVersion": 1,
+  "atomId": "energetic_electronic.aiaudio",
+  "bundleType": "aiaudio",
+  "category": "audio",
+  "mode": "generative",
+  "label": {
+    "zh": "紧张电子 BGM",
+    "en": "Energetic electronic BGM"
+  },
+  "tags": [
+    "audio",
+    "bgm",
+    "music",
+    "energetic",
+    "electronic",
+    "tension",
+    "escape",
+    "loop",
+    "intense"
+  ],
+  "bindingRoles": ["bgMusic"],
+  "generation": {
+    "kind": "bgm",
+    "prompt": "intense energetic electronic loop, tension-building background music for escape puzzle game, driving beat, synth, 140 BPM",
+    "duration": 30,
+    "loop": true,
+    "platformSkill": "playcraft-audio-generation",
+    "bgmStyle": "electronic",
+    "bpm": 140
+  },
+  "result": {
+    "outputFile": "audio.mp3",
+    "format": "mp3",
+    "constraints": {
+      "minDuration": 15,
+      "maxDuration": 60
+    }
+  },
+  "binding": {
+    "role": "backgroundMusic",
+    "target": "scene://entities/AudioManager/bgm/asset",
+    "type": "audio-asset-reference",
+    "constraints": {
+      "playMode": "loop"
+    }
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}