@playcraft/skills 0.0.2

package/skills/tween-animation-2d.aicomponent/SKILL.md

@@ -0,0 +1,35 @@
+# tween-animation-2d — 2D Tween Animation
+
+Programmatic smooth transitions for position, scale, rotation, and opacity. Uses easing functions to create polished UI and game feel.
+
+## Easing Functions
+
+| Name | Effect | Best For |
+|------|--------|----------|
+| `linear` | Constant speed | Progress bars, counters |
+| `easeIn` | Slow start, fast end | Objects falling, accelerating |
+| `easeOut` | Fast start, slow end | Objects landing, decelerating |
+| `easeInOut` | Smooth start and end | UI panels, modal transitions |
+| `bounce` | Elastic bounce at end | Button press, item pickup |
+| `elastic` | Spring overshoot | Score popup, notification |
+
+## Common Presets
+
+```js
+// Scale pop-in (item spawn)
+{ property: 'scale', from: 0, to: 1, duration: 300, easing: 'elastic' }
+
+// Fade out
+{ property: 'alpha', from: 1, to: 0, duration: 200, easing: 'easeIn' }
+
+// Float up (score text)
+{ property: 'y', from: 0, to: -60, duration: 800, easing: 'easeOut' }
+
+// Bounce in
+{ property: 'scale', from: 1.2, to: 1, duration: 400, easing: 'bounce' }
+```
+
+## Engine References
+
+- **PlayCanvas**: `ref/playcanvas.js` — uses `pc.Tween`
+- **Phaser 3**: `ref/phaser.js` — uses `this.tweens.add()`

package/skills/tween-animation-2d.aicomponent/manifest.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "atomId": "tween-animation-2d.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "animation",
+  "mode": "fixed",
+  "label": { "zh": "2D 缓动动画", "en": "2D Tween Animation" },
+  "tags": ["animation", "tween", "easing", "2d", "playcanvas", "phaser"],
+  "generation": {
+    "animationType": "tween",
+    "engineSupport": ["playcanvas", "phaser", "html5"],
+    "parameters": {
+      "property": "string — position|scale|alpha|rotation",
+      "from": "number|object — starting value",
+      "to": "number|object — target value",
+      "duration": "number — milliseconds",
+      "easing": "string — linear|easeIn|easeOut|easeInOut|bounce|elastic",
+      "delay": "number — ms before starting (default: 0)",
+      "loop": "boolean — whether to repeat (default: false)",
+      "yoyo": "boolean — reverse direction on repeat"
+    }
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "playcanvas": "ref/playcanvas.js",
+    "phaser": "ref/phaser.js"
+  }
+}

package/skills/tween-animation-2d.aicomponent/ref/phaser.js

@@ -0,0 +1,49 @@
+// tween-animation-2d — Phaser 3 implementation
+
+// Scale pop-in
+scene.tweens.add({
+  targets: gameObject,
+  scaleX: { from: 0, to: 1 },
+  scaleY: { from: 0, to: 1 },
+  duration: 300,
+  ease: 'Elastic.Out',
+});
+
+// Fade out
+scene.tweens.add({
+  targets: gameObject,
+  alpha: { from: 1, to: 0 },
+  duration: 200,
+  ease: 'Linear',
+});
+
+// Float up (score text)
+scene.tweens.add({
+  targets: gameObject,
+  y: gameObject.y - 60,
+  alpha: 0,
+  duration: 800,
+  ease: 'Cubic.Out',
+});
+
+// Phaser ease name mapping
+const PHASER_EASING = {
+  linear: 'Linear',
+  easeIn: 'Cubic.In',
+  easeOut: 'Cubic.Out',
+  easeInOut: 'Cubic.InOut',
+  bounce: 'Bounce.Out',
+  elastic: 'Elastic.Out',
+};
+
+function tween(scene, target, { property, to, duration, easing = 'easeOut', delay = 0, yoyo = false, loop = false }) {
+  return scene.tweens.add({
+    targets: target,
+    [property]: to,
+    duration,
+    ease: PHASER_EASING[easing] ?? 'Cubic.Out',
+    delay,
+    yoyo,
+    repeat: loop ? -1 : 0,
+  });
+}

package/skills/tween-animation-2d.aicomponent/ref/playcanvas.js

@@ -0,0 +1,36 @@
+// tween-animation-2d — PlayCanvas implementation
+// Requires pc.TweenManager plugin (or use the built-in pc.app.tween if available)
+
+// Scale pop-in example
+entity.setLocalScale(0, 0, 1);
+entity.tween(entity.getLocalScale())
+  .to({ x: 1, y: 1, z: 1 }, 0.3, pc.ElasticOut)
+  .start();
+
+// Fade out example
+entity.tween(entity.script.sprite)
+  .to({ opacity: 0 }, 0.2, pc.Linear)
+  .start();
+
+// Float up (score text)
+entity.tween(entity.getLocalPosition())
+  .to({ y: entity.getLocalPosition().y + 60 }, 0.8, pc.QuadOut)
+  .start();
+
+// Helper for common easing aliases
+const EASING = {
+  linear: pc.Linear,
+  easeIn: pc.QuadIn,
+  easeOut: pc.QuadOut,
+  easeInOut: pc.QuadInOut,
+  bounce: pc.BounceOut,
+  elastic: pc.ElasticOut,
+};
+
+function tween(entity, { property, from, to, duration, easing = 'easeOut', delay = 0 }) {
+  const ease = EASING[easing] ?? pc.QuadOut;
+  return entity.tween(from)
+    .to(to, duration / 1000, ease)
+    .delay(delay / 1000)
+    .start();
+}

package/skills/typescript_module_patterns.aicomponent/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: typescript_module_patterns.aicomponent
+description: TypeScript 项目中资源导入模式、模块声明模板和常见编译错误的修复指南。帮助 Agent 在第一次就写出正确的 import 代码，避免 TS 编译报错。
+triggers: TypeScript 编译错误,TS2580,TS2300,TS2307,Cannot find module,require,import 资源,模块声明,globals.d.ts
+---
+
+# TypeScript 模块模式与错误修复指南
+
+## 说明
+
+在 Phaser + Webpack + TypeScript 项目中，资源导入是最常见的出错点。本 skill 提供：
+
+1. **标准模块声明模板**（`globals.d.ts`）
+2. **资源导入的正确方式**（ES import vs require vs 路径字符串）
+3. **常见 TS 错误→修复映射表**（遇到错误直接查表）
+
+## Scaffold
+
+| 目标路径 | 来源 | 说明 |
+|---------|-----|------|
+| `globals.d.ts` | `ref/globals.d.ts` | 所有资源类型的模块声明 |
+
+## 模块声明模板（globals.d.ts）
+
+```typescript
+// 图片资源
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+// 音频资源
+declare module "*.mp3" {
+  const src: string;
+  export default src;
+}
+declare module "*.ogg" {
+  const src: string;
+  export default src;
+}
+declare module "*.wav" {
+  const src: string;
+  export default src;
+}
+
+// JSON（TypeScript 内置支持，但需要 tsconfig 中 resolveJsonModule: true）
+// declare module "*.json" { ... }  // 通常不需要
+```
+
+## 资源导入正确方式
+
+### ✅ 正确：ES import（推荐）
+
+```typescript
+import carImage from "assets/images/car.webp";
+import clickSfx from "assets/sounds/click.mp3";
+import levelData from "./levels/level1.json";
+
+// 在 Phaser 中使用
+this.load.image("car", carImage);     // carImage 是 webpack 生成的文件 URL
+this.load.audio("click", clickSfx);
+```
+
+**原理**：webpack 的 `asset/resource` 规则处理这些文件，输出到 dist/ 并返回最终 URL 字符串。TypeScript 通过 `globals.d.ts` 中的模块声明知道 `import *.webp` 返回 `string` 类型。
+
+### ❌ 错误：require（ESM 项目不可用）
+
+```typescript
+// ❌ 报错：TS2580: Cannot find name 'require'
+this.load.image("car", require("assets/images/car.webp"));
+```
+
+**原因**：项目 tsconfig 配置为 `module: "esnext"`，不支持 CommonJS 的 `require`。
+
+**修复**：改为 ES import：
+```typescript
+import carImage from "assets/images/car.webp";
+this.load.image("car", carImage);
+```
+
+### ❌ 错误：路径字符串（webpack 无法追踪）
+
+```typescript
+// ❌ 运行时 404：webpack 不会打包这个文件
+this.load.image("car", "./assets/images/car.webp");
+```
+
+**原因**：字符串路径不会被 webpack 的 module 规则处理，文件不会被复制到 dist/。
+
+## 常见错误→修复映射表
+
+| TS 错误码 | 错误信息 | 原因 | 修复 |
+|-----------|---------|------|------|
+| **TS2580** | `Cannot find name 'require'` | ESM 项目用了 CJS 语法 | 改为 `import x from "..."` |
+| **TS2300** | `Duplicate identifier 'xxx'` | 同一变量名被 import 两次 | 删除重复的 import 行 |
+| **TS2307** | `Cannot find module '*.webp'` | 缺少模块声明 | `globals.d.ts` 加 `declare module "*.webp"` |
+| **TS2307** | `Cannot find module './Foo'` | 文件路径错误或缺少 | 检查文件是否存在，大小写是否一致 |
+| **TS7016** | `Could not find declaration file for module 'xxx'` | 第三方库缺少类型 | 安装 `@types/xxx` 或创建 `.d.ts` |
+| **TS1259** | `Module can only be default-imported using esModuleInterop` | 导入 CJS 模块格式不对 | tsconfig 加 `"esModuleInterop": true` |
+| **TS2339** | `Property 'xxx' does not exist on type` | 类型不匹配 | 添加类型断言 `as any` 或修正类型 |
+| **TS2345** | `Argument of type 'X' is not assignable to 'Y'` | 类型不兼容 | 检查接口定义，或用 `as any` 临时绕过 |
+
+## import 规范
+
+### 导入顺序（推荐）
+
+```typescript
+// 1. 第三方库
+import * as Phaser from "phaser";
+import { Scene } from "phaser";
+
+// 2. 内部模块（绝对路径或 alias）
+import { GameConfig } from "../GameConfig";
+import { computeUiLayout } from "../utils/UiLayout";
+
+// 3. 资源文件（放最后）
+import carImage from "assets/images/car.webp";
+import clickSfx from "assets/sounds/click.mp3";
+```
+
+### 避免重复 import
+
+每个模块/资源只 import 一次，放在文件顶部。如果需要在多处使用，import 一次后传参：
+
+```typescript
+// ✅ 正确：顶部 import 一次
+import carImage from "assets/images/car.webp";
+
+// 然后在代码中多次引用变量 carImage
+this.load.image("car", carImage);
+```
+
+```typescript
+// ❌ 错误：多次 import 同一模块
+import carImage from "assets/images/car.webp";
+import carImage from "assets/images/car.webp"; // TS2300: Duplicate identifier
+```
+
+## tsconfig.json 关键配置
+
+```json
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "paths": {
+      "assets/*": ["./assets/*"]
+    }
+  }
+}
+```
+
+| 配置项 | 作用 | 缺少的后果 |
+|--------|------|-----------|
+| `module: "esnext"` | 使用 ES module 语法 | 无法用 `import` |
+| `moduleResolution: "bundler"` | webpack 兼容的模块解析 | 路径解析失败 |
+| `esModuleInterop: true` | 允许 `import x from "cjs-lib"` | CJS 库导入报错 |
+| `resolveJsonModule: true` | 允许 `import data from "./x.json"` | JSON import 报错 |
+| `paths.assets/*` | alias 路径映射 | `import from "assets/..."` TS 报错 |
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **独立知识 skill** | TS 资源导入报错是高频问题，与引擎 skill 分离后 Agent 可按需加载，不污染 phaser/threejs skill 的主流程 |
+| **错误码→修复映射表** | Agent 遇到 TS 编译报错时可直接查表定位修复，避免反复试错 |
+| **偏向文档而非 Scaffold** | 模块声明本质是一份固定模板；核心价值在于教 Agent 正确的 import 模式，比直接写文件更重要 |
+
+## Adapter
+
+- **Role**: `tsModulePatterns` — TypeScript 资源导入规范与错误修复知识库
+- **Provides**: `globals.d.ts` 模块声明模板、正确 import 模式示例、TS 错误码→修复映射表
+- **Requires**: `webpack_build.aicomponent`（alias 需与 tsconfig `paths` 一致）、`phaser.aicomponent`（提供 tsconfig.json 骨架）
+- **Consumed by**: 所有在 Webpack + TypeScript 项目中导入图片/音频资源时遇到 TS 报错的 skill
+- **Integration point**: 根目录 `globals.d.ts` —— 所有资源 `import` 的类型声明来源
+
+## Imports
+
+- `webpack_build.aicomponent`（配合使用：webpack alias 与 tsconfig paths 需一致）
+- `phaser.aicomponent`（配合使用：提供 tsconfig.json 骨架）
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - source: ref/globals.d.ts
+outputs:
+  - typeDeclaration: globals.d.ts module declarations
+  - patterns: correct import patterns for webpack + TypeScript
+  - errorFixMap: TS error code → fix mapping
+```

package/skills/typescript_module_patterns.aicomponent/manifest.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": 1,
+  "atomId": "typescript_module_patterns.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "infrastructure",
+  "mode": "fixed",
+  "label": {
+    "zh": "TypeScript 模块模式与错误修复指南",
+    "en": "TypeScript module patterns & error fix guide"
+  },
+  "tags": [
+    "typescript",
+    "module",
+    "import",
+    "error-fix",
+    "infrastructure",
+    "dx"
+  ],
+  "bindingRoles": [
+    "typeDeclaration"
+  ],
+  "files": {
+    "skill": "SKILL.md",
+    "ref": [
+      "ref/globals.d.ts"
+    ]
+  }
+}

package/skills/typescript_module_patterns.aicomponent/ref/globals.d.ts

@@ -0,0 +1,31 @@
+// 图片资源
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+// 音频资源
+declare module "*.mp3" {
+  const src: string;
+  export default src;
+}
+declare module "*.ogg" {
+  const src: string;
+  export default src;
+}
+declare module "*.wav" {
+  const src: string;
+  export default src;
+}

package/skills/ui-transition.aicomponent/SKILL.md

@@ -0,0 +1,33 @@
+# ui-transition — UI Panel Transition Animation
+
+Smooth enter/exit animations for UI panels, modals, HUD elements, and overlays.
+
+## Transition Types
+
+| Type | In Effect | Out Effect | Best For |
+|------|-----------|------------|----------|
+| `fade` | opacity 0→1 | opacity 1→0 | Overlays, modals |
+| `slide-up` | y+offset→0 | 0→y-offset | Bottom sheets |
+| `slide-down` | y-offset→0 | 0→y+offset | Top notifications |
+| `slide-left` | x+offset→0 | 0→x-offset | Right panels |
+| `slide-right` | x-offset→0 | 0→x+offset | Left panels |
+| `scale` | scale 0→1 | scale 1→0 | Popups, tooltips |
+
+## Parameters
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `type` | `fade` | Transition style |
+| `direction` | `in` | Enter or exit |
+| `duration` | 200ms | Animation speed |
+| `distance` | 30px | Slide distance |
+| `ease` | `easeOut` (in) / `easeIn` (out) | Easing function |
+| `onComplete` | — | Callback when done |
+
+## Decision Notes
+
+| Decision | Reason |
+|----------|--------|
+| 200ms default | Apple HIG and Material Design standard for UI transitions |
+| Ease asymmetry | Enter: easeOut (fast start = responsive feel); Exit: easeIn (slow start = content lingers) |
+| Slide distance 30px | Subtle movement; large values feel sluggish on mobile |

package/skills/ui-transition.aicomponent/manifest.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "atomId": "ui-transition.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "animation",
+  "mode": "fixed",
+  "label": { "zh": "UI 面板过渡动画", "en": "UI Panel Transition Animation" },
+  "tags": ["animation", "ui", "transition", "fade", "slide", "panel", "playcanvas", "phaser"],
+  "generation": {
+    "animationType": "tween",
+    "engineSupport": ["playcanvas", "phaser", "html5"],
+    "parameters": {
+      "type": "string — fade|slide-up|slide-down|slide-left|slide-right|scale",
+      "direction": "string — in|out",
+      "duration": "number — ms (default: 200)"
+    }
+  },
+  "files": { "skill": "SKILL.md", "phaser": "ref/phaser.js" }
+}

package/skills/ui-transition.aicomponent/ref/phaser.js

@@ -0,0 +1,45 @@
+// ui-transition — Phaser 3 implementation
+
+const TRANSITIONS = {
+  fade: {
+    in:  (t, obj, d) => ({ alpha: { from: 0, to: 1 }, duration: d, ease: 'Cubic.Out' }),
+    out: (t, obj, d) => ({ alpha: { from: 1, to: 0 }, duration: d, ease: 'Cubic.In' }),
+  },
+  'slide-up': {
+    in:  (t, obj, d, dist = 30) => ({ y: { from: obj.y + dist, to: obj.y }, alpha: { from: 0, to: 1 }, duration: d, ease: 'Cubic.Out' }),
+    out: (t, obj, d, dist = 30) => ({ y: obj.y - dist, alpha: 0, duration: d, ease: 'Cubic.In' }),
+  },
+  'slide-down': {
+    in:  (t, obj, d, dist = 30) => ({ y: { from: obj.y - dist, to: obj.y }, alpha: { from: 0, to: 1 }, duration: d, ease: 'Cubic.Out' }),
+    out: (t, obj, d, dist = 30) => ({ y: obj.y + dist, alpha: 0, duration: d, ease: 'Cubic.In' }),
+  },
+  'slide-left': {
+    in:  (t, obj, d, dist = 30) => ({ x: { from: obj.x + dist, to: obj.x }, alpha: { from: 0, to: 1 }, duration: d, ease: 'Cubic.Out' }),
+    out: (t, obj, d, dist = 30) => ({ x: obj.x - dist, alpha: 0, duration: d, ease: 'Cubic.In' }),
+  },
+  scale: {
+    in:  (t, obj, d) => ({ scaleX: { from: 0, to: obj.scaleX }, scaleY: { from: 0, to: obj.scaleY }, alpha: { from: 0, to: 1 }, duration: d, ease: 'Back.Out' }),
+    out: (t, obj, d) => ({ scaleX: 0, scaleY: 0, alpha: 0, duration: d, ease: 'Cubic.In' }),
+  },
+};
+
+function uiTransition(scene, target, {
+  type = 'fade',
+  direction = 'in',
+  duration = 200,
+  distance = 30,
+  onComplete,
+} = {}) {
+  const def = TRANSITIONS[type]?.[direction];
+  if (!def) return;
+
+  const config = def(scene, target, duration, distance);
+  config.targets = target;
+  if (onComplete) config.onComplete = onComplete;
+
+  scene.tweens.add(config);
+}
+
+// Usage:
+// uiTransition(this, panel, { type: 'slide-up', direction: 'in' });
+// uiTransition(this, modal, { type: 'scale', direction: 'out', onComplete: () => modal.destroy() });

package/skills/ux_flow_spec.aiconfig/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: ux_flow_spec.aiconfig
+description: 试玩广告 UX 流程规范 - 定义 Loading → Tutorial → Gameplay → CTA 的完整用户流程
+triggers: UX 流程,ux flow,用户体验,user experience,教程,tutorial,引导,onboarding,试玩流程,playable flow
+---
+
+# ux_flow_spec.aiconfig
+
+试玩广告 UX 流程规范。定义从 Loading → Tutorial → Gameplay → CTA 的完整用户流程，包括每个阶段的时长预算、转场方式、交互模式。
+
+### 流程概览
+
+```
+Loading (≤3s) → Tutorial (≤8s) → Gameplay (≤30s) → Endcard/CTA
+   fade          guided-tap       free-play         cta-button
+```
+
+**核心原则：**
+- 首次交互必须在 3 秒内发生（`firstInteractionWithin`）
+- 教程阶段使用引导式点击（`guided-tap`），5 秒后可跳过
+- Gameplay 阶段是核心体验区，关卡数与难度曲线联动
+- Endcard 阶段展示 CTA，无时长限制
+
+## Recipe
+
+- **配置方式**：参数化（parametric）
+- **核心参数**：
+  - `totalDuration`: `45` — 预期总时长（秒）
+  - `phases`: 四阶段配置数组
+    - `loading`: 最长 3 秒，fade 转场
+    - `tutorial`: 最长 8 秒，引导式点击，5 秒后可跳过
+    - `gameplay`: 最长 30 秒，3 个关卡
+    - `endcard`: 无时长限制，展示 CTA
+  - `firstInteractionWithin`: `3` — 首次交互必须在几秒内
+  - `ctaVisibility`: `"after-first-level"` — CTA 何时首次可见
+- **可 fork 变体**：
+  - 极速体验：`totalDuration: 30`, tutorial `maxDuration: 3`, gameplay `levels: 2`
+  - 深度体验：`totalDuration: 60`, gameplay `maxDuration: 45, levels: 5`
+  - 无教程：移除 tutorial 阶段，直接进入 gameplay
+
+**配置步骤：**
+1. 读取项目的 `game/config.json`
+2. 写入 `ux.flow` 配置块，包含 `totalDuration` 和 `phases` 数组
+3. 写入 `ux.firstInteractionWithin` 控制首次交互时机
+4. 设置 `ux.ctaVisibility` 与 CTA 配置联动
+5. 验证各阶段 `maxDuration` 之和 ≤ `totalDuration`
+
+## Result
+
+- **产物**：修改 `game/config.json` 的 UX 流程配置块
+- **格式**：JSON patch
+- **目标键**：`ux.flow`
+- **包含子键**：`totalDuration`, `phases`, `firstInteractionWithin`, `ctaVisibility`
+
+## Binding
+
+- **Binding Role**：`gameConfig`
+- **挂载目标**：`game/config.json`
+- **引用类型**：`config-key-value`
+- **与其他 Skill 的关系**：
+  - 与 `difficulty_curve_designer.aiconfig` 联动：gameplay 阶段的 `levels` 应与 `totalLevels` 一致
+  - 与 `cta_platform_config.aiconfig` 联动：endcard 阶段的 CTA 配置
+  - 与 `playtest_report.aivalidator` 联动：试玩报告按此流程评估体验
+
+## Skill Definition
+
+tools:
+  - read
+  - write
+prompt_extension: |
+  You are designing the UX flow for a playable ad (试玩广告).
+  The flow follows a strict 4-phase structure:
+  1. Loading (≤3s): Show a simple loading screen with brand logo. Use fade transition.
+     Player must be able to interact within 3 seconds of the ad loading.
+  2. Tutorial (≤8s): Guided-tap interaction showing the core mechanic.
+     Auto-skip after 5 seconds if no interaction. Keep it minimal.
+  3. Gameplay (≤30s): The core game experience, typically 3 levels.
+     This is where the difficulty curve and balance checks apply.
+  4. Endcard (no time limit): Show CTA button prominently.
+  Read game/config.json, write the ux.flow config block, and validate that
+  the sum of phase maxDurations does not exceed totalDuration.
+  Ensure firstInteractionWithin is set to 3 seconds or less.

package/skills/ux_flow_spec.aiconfig/manifest.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "atomId": "ux_flow_spec.aiconfig",
+  "bundleType": "aiconfig",
+  "category": "config",
+  "mode": "parametric",
+  "label": {
+    "zh": "试玩广告 UX 流程规范",
+    "en": "Playable ads UX flow spec"
+  },
+  "tags": ["config", "ux", "flow", "user-experience", "playable-ads", "tutorial", "onboarding", "cta"],
+  "bindingRoles": ["gameConfig"],
+  "generation": {
+    "kind": "config-patch",
+    "params": {
+      "totalDuration": 45,
+      "phases": [
+        { "name": "loading", "maxDuration": 3, "transition": "fade" },
+        { "name": "tutorial", "maxDuration": 8, "interaction": "guided-tap", "skipAfter": 5 },
+        { "name": "gameplay", "maxDuration": 30, "levels": 3 },
+        { "name": "endcard", "maxDuration": 0, "cta": true }
+      ],
+      "firstInteractionWithin": 3,
+      "ctaVisibility": "after-first-level"
+    }
+  },
+  "result": {
+    "configKey": "ux.flow",
+    "format": "json-patch"
+  },
+  "binding": {
+    "role": "gameConfig",
+    "target": "game/config.json",
+    "type": "config-key-value"
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}