@playcraft/skills 0.0.2

package/skills/cta_platform_config.aiconfig/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: cta_platform_config.aiconfig
+description: CTA 按钮的多平台适配配置 - 支持 Facebook、Google、TikTok、Unity Ads 等平台的 CTA SDK 差异化接入
+triggers: CTA,call to action,下载按钮,install button,平台适配,platform,facebook,google,tiktok,unity ads
+---
+
+# cta_platform_config.aiconfig
+
+CTA（Call-to-Action）按钮的多平台适配配置。不同广告平台对 CTA 的实现方式有显著差异：
+
+| 平台 | SDK | 调用方式 |
+|------|-----|---------|
+| Facebook | `FbPlayableAd` | `FbPlayableAd.onCTAClick()` |
+| Google | `ExitApi` | `ExitApi.exit()` |
+| TikTok | `window.playableSDK` | `window.playableSDK.openAppStore()` |
+| Unity Ads | `mraid` | `mraid.open(storeUrl)` |
+
+本配置统一管理 CTA 按钮的文案、位置、显示时机和平台 SDK 调用方式。
+
+## Recipe
+
+- **配置方式**：参数化（parametric）
+- **核心参数**：
+  - `defaultPlatform`: `"facebook"` — 默认目标平台
+  - `ctaText`: `{ "zh": "立即下载", "en": "Install Now" }` — CTA 文案（多语言）
+  - `ctaPosition`: `"bottom-center"` — CTA 按钮位置
+  - `ctaShowAfterLevel`: `1` — 第几关后显示 CTA
+  - `ctaAlwaysVisible`: `false` — 是否始终显示
+  - `platforms`: 各平台 SDK 和方法的映射表
+- **可 fork 变体**：
+  - 激进型：`ctaAlwaysVisible: true`，始终显示 CTA
+  - Google 优先：`defaultPlatform: "google"`, `ctaShowAfterLevel: 0`
+  - TikTok 全屏点击：追加 `ctaFullScreenTap: true`
+
+**配置步骤：**
+1. 读取项目的 `game/config.json`
+2. 写入 `cta` 配置块，包含默认平台、文案、位置
+3. 写入 `cta.platforms` 子对象，包含各平台的 SDK 和调用方法
+4. 确保 `cta.showAfterLevel` 与难度曲线的 `ctaTriggerAfterLevel` 一致
+
+## Result
+
+- **产物**：修改 `game/config.json` 的 CTA 配置块
+- **格式**：JSON patch
+- **目标键**：`cta`
+- **包含子键**：`defaultPlatform`, `ctaText`, `ctaPosition`, `ctaShowAfterLevel`, `ctaAlwaysVisible`, `platforms`
+
+## Binding
+
+- **Binding Role**：`gameConfig`
+- **挂载目标**：`game/config.json`
+- **引用类型**：`config-key-value`
+- **与其他 Skill 的关系**：
+  - 与 `difficulty_curve_designer.aiconfig` 联动：CTA 触发时机应在峰值体验之后
+  - 与 `ad_compliance_rules.aiconfig` 联动：CTA 实现必须符合各平台合规要求
+
+## Skill Definition
+
+tools:
+  - read
+  - write
+prompt_extension: |
+  You are configuring CTA (Call-to-Action) behavior for a playable ad.
+  Each ad platform has its own SDK for triggering the app store redirect:
+  - Facebook: FbPlayableAd.onCTAClick()
+  - Google: ExitApi.exit()
+  - TikTok: window.playableSDK.openAppStore()
+  - Unity Ads: mraid.open(storeUrl)
+  Read game/config.json and write the cta config block.
+  The CTA button implementation in code should detect the platform at runtime
+  and call the appropriate SDK method. Write a platform-agnostic wrapper function.
+  Ensure ctaShowAfterLevel aligns with the difficulty curve's peak level.

package/skills/cta_platform_config.aiconfig/manifest.json

@@ -0,0 +1,56 @@
+{
+  "schemaVersion": 1,
+  "atomId": "cta_platform_config.aiconfig",
+  "bundleType": "aiconfig",
+  "category": "config",
+  "mode": "parametric",
+  "label": {
+    "zh": "CTA 多平台适配配置",
+    "en": "CTA platform adaptation config"
+  },
+  "tags": ["config", "cta", "platform", "facebook", "google", "tiktok", "unity-ads", "playable-ads", "download", "install"],
+  "bindingRoles": ["gameConfig"],
+  "generation": {
+    "kind": "config-patch",
+    "params": {
+      "defaultPlatform": "facebook",
+      "ctaText": {
+        "zh": "立即下载",
+        "en": "Install Now"
+      },
+      "ctaPosition": "bottom-center",
+      "ctaShowAfterLevel": 1,
+      "ctaAlwaysVisible": false,
+      "platforms": {
+        "facebook": {
+          "sdk": "FbPlayableAd",
+          "method": "FbPlayableAd.onCTAClick()"
+        },
+        "google": {
+          "sdk": "ExitApi",
+          "method": "ExitApi.exit()"
+        },
+        "tiktok": {
+          "sdk": "window.playableSDK",
+          "method": "window.playableSDK.openAppStore()"
+        },
+        "unity": {
+          "sdk": "mraid",
+          "method": "mraid.open(storeUrl)"
+        }
+      }
+    }
+  },
+  "result": {
+    "configKey": "cta",
+    "format": "json-patch"
+  },
+  "binding": {
+    "role": "gameConfig",
+    "target": "game/config.json",
+    "type": "config-key-value"
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}

package/skills/debug_overlay.aicomponent/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: debug_overlay.aicomponent
+description: 开发调试覆盖层。在游戏画面上叠加可视化调试信息：格子坐标、碰撞区域、命中范围、方向向量、FPS、关卡切换控制。通过 DebugConfig 开关控制。
+triggers: 调试,debug,overlay,格子坐标,碰撞可视化,FPS,开发工具,dev tools
+---
+
+# 开发调试覆盖层（Debug Overlay）
+
+## 说明
+
+在 Game 场景上叠加半透明调试信息层，帮助开发者快速定位问题：
+
+- **格子坐标网格** — 每个格子中心显示 `(col,row)` 文字
+- **碰撞区域高亮** — 被路径占据的格子用半透明色块标记
+- **点击命中范围** — 显示每个箭头头部的点击判定圆形
+- **方向向量** — 从箭头头部画出方向辅助线到棋盘边界
+- **路径索引** — 每条路径显示 `#0` `#1` 编号
+- **FPS / 内存** — 左上角实时帧率
+- **关卡切换** — 底部 ← → 按钮快速切换关卡
+
+## Scaffold
+
+| 目标路径 | 来源 | 说明 |
+|---------|-----|------|
+| `src/game/scenes/GameUI/DebugOverlay.ts` | `ref/DebugOverlay.ts` | 完整调试覆盖层 |
+
+## 开关控制
+
+在 `DebugConfig.ts` 中添加：
+
+```typescript
+/** 是否显示调试覆盖层 */
+export const SHOW_DEBUG_OVERLAY = true; // 发布前改为 false
+```
+
+在 `Game.ts` 的 `create()` 末尾：
+
+```typescript
+if (SHOW_DEBUG_OVERLAY) {
+  new DebugOverlay(this);
+}
+```
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **独立组件，条件加载** | 调试渲染在发布版本中必须零开销；独立 class + 单一开关标志（`SHOW_DEBUG_OVERLAY`）保证发布时完整移除，不影响游戏逻辑 |
+| **Graphics 叠加而非精灵** | 调试信息（坐标网格、碰撞区域）是动态内容，用 Phaser Graphics API 绘制无需额外资产文件 |
+| **可视化命中范围** | 箭头头部的点击判定圆是最常见的调试需求（用户反馈"点不到"），优先可视化 |
+
+## Adapter
+
+- **Role**: `debugOverlay` — 开发期可视化调试层（生产构建中条件禁用）
+- **Provides**: `DebugOverlay` 类（格子坐标、碰撞区域、FPS、关卡切换 UI）
+- **Requires**: `phaser.aicomponent`、`grid_board_layout.aicomponent`（格子坐标计算）
+- **Consumed by**: `game_scene.aicomponent`（在 `Game.create()` 末尾条件实例化）
+- **Integration point**: `src/game/scenes/Game.ts` → `if (SHOW_DEBUG_OVERLAY) new DebugOverlay(this)`
+
+## Imports
+
+- `phaser.aicomponent`（硬依赖）
+- `grid_board_layout.aicomponent`（硬依赖：格子坐标计算）
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - source: ref/DebugOverlay.ts
+outputs:
+  - debugOverlay: DebugOverlay class
+```

package/skills/debug_overlay.aicomponent/manifest.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "atomId": "debug_overlay.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "tool",
+  "mode": "fixed",
+  "label": {
+    "zh": "开发调试覆盖层",
+    "en": "Debug overlay for development"
+  },
+  "tags": ["debug", "overlay", "grid", "collision", "fps", "development"],
+  "bindingRoles": ["debugTool"],
+  "files": {
+    "skill": "SKILL.md",
+    "ref": ["ref/DebugOverlay.ts"]
+  }
+}

package/skills/debug_overlay.aicomponent/ref/DebugOverlay.ts

@@ -0,0 +1,144 @@
+import * as Phaser from "phaser";
+
+/**
+ * 开发调试覆盖层
+ * 在游戏场景上叠加可视化调试信息
+ */
+export class DebugOverlay {
+  private scene: any;
+  private graphics!: Phaser.GameObjects.Graphics;
+  private texts: Phaser.GameObjects.Text[] = [];
+  private fpsText!: Phaser.GameObjects.Text;
+  private visible = true;
+
+  constructor(scene: any) {
+    this.scene = scene;
+    this.create();
+  }
+
+  private create(): void {
+    const scene = this.scene;
+
+    // FPS 文本
+    this.fpsText = scene.add
+      .text(10, 10, "FPS: 0", {
+        fontSize: "14px",
+        color: "#00ff00",
+        backgroundColor: "#00000088",
+        padding: { x: 4, y: 2 },
+      })
+      .setScrollFactor(0)
+      .setDepth(9000);
+
+    // 调试图形层
+    this.graphics = scene.add.graphics();
+    this.graphics.setDepth(8999);
+    scene.boardContainer.add(this.graphics);
+
+    // 绘制初始调试信息
+    this.drawDebugInfo();
+
+    // 每帧更新 FPS
+    scene.events.on("update", () => {
+      this.fpsText.setText(`FPS: ${scene.game.loop.actualFps.toFixed(0)}`);
+    });
+
+    // 按 D 键切换显示/隐藏
+    scene.input.keyboard?.on("keydown-D", () => {
+      this.visible = !this.visible;
+      this.graphics.setVisible(this.visible);
+      this.texts.forEach(t => t.setVisible(this.visible));
+      this.fpsText.setVisible(this.visible);
+    });
+  }
+
+  private drawDebugInfo(): void {
+    const scene = this.scene;
+    const level = scene.level;
+    if (!level) return;
+
+    const g = this.graphics;
+    g.clear();
+
+    // 1. 格子网格线
+    g.lineStyle(1, 0x444444, 0.3);
+    for (let row = 0; row <= level.rows; row++) {
+      const y = row * scene.cellHeight;
+      g.lineBetween(0, y, level.cols * scene.cellWidth, y);
+    }
+    for (let col = 0; col <= level.cols; col++) {
+      const x = col * scene.cellWidth;
+      g.lineBetween(x, 0, x, level.rows * scene.cellHeight);
+    }
+
+    // 2. 格子坐标文字 + 碰撞区域
+    for (let row = 0; row < level.rows; row++) {
+      for (let col = 0; col < level.cols; col++) {
+        const cx = col * scene.cellWidth + scene.cellWidth / 2;
+        const cy = row * scene.cellHeight + scene.cellHeight / 2;
+
+        // 坐标文字
+        const coordText = scene.add
+          .text(cx, cy, `${col},${row}`, {
+            fontSize: "10px",
+            color: "#888888",
+          })
+          .setOrigin(0.5)
+          .setDepth(8998);
+        scene.boardContainer.add(coordText);
+        this.texts.push(coordText);
+
+        // 碰撞区域高亮
+        const idx = row * level.cols + col;
+        const occupied = level.paths.some((p: any, i: number) => {
+          if (scene.removedPaths.has(i)) return false;
+          return p.indices.includes(idx);
+        });
+        if (occupied) {
+          g.fillStyle(0xff0000, 0.1);
+          g.fillRect(
+            col * scene.cellWidth + 2,
+            row * scene.cellHeight + 2,
+            scene.cellWidth - 4,
+            scene.cellHeight - 4,
+          );
+        }
+      }
+    }
+
+    // 3. 路径索引 + 命中范围 + 方向向量
+    for (let i = 0; i < level.paths.length; i++) {
+      if (scene.removedPaths.has(i)) continue;
+
+      const path = level.paths[i];
+      const hx = path.head.x * scene.cellWidth + scene.cellWidth / 2;
+      const hy = path.head.y * scene.cellHeight + scene.cellHeight / 2;
+
+      // 路径编号
+      const idxText = scene.add
+        .text(hx, hy - scene.cellHeight * 0.4, `#${i}`, {
+          fontSize: "12px",
+          color: "#ffff00",
+          fontStyle: "bold",
+          backgroundColor: "#00000088",
+          padding: { x: 2, y: 1 },
+        })
+        .setOrigin(0.5)
+        .setDepth(9001);
+      scene.boardContainer.add(idxText);
+      this.texts.push(idxText);
+
+      // 命中判定圆
+      const hitRadius = scene.cellSize * 0.6;
+      g.lineStyle(1, 0x00ff00, 0.5);
+      g.strokeCircle(hx, hy, hitRadius);
+
+      // 方向辅助线
+      const dx = path.direction === "right" ? 1 : path.direction === "left" ? -1 : 0;
+      const dy = path.direction === "down" ? 1 : path.direction === "up" ? -1 : 0;
+      const lineLen = Math.max(level.cols, level.rows) * scene.cellSize;
+      g.lineStyle(1, 0x00ffff, 0.4);
+      g.lineBetween(hx, hy, hx + dx * lineLen, hy + dy * lineLen);
+    }
+  }
+}

package/skills/desert.aiimage/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: desert.aiimage
+description: 沙漠背景图封包 - 金色沙丘/干旱场景，适合停车逃脱、箭头逃脱类游戏的暖色背景
+triggers: 沙漠,desert,沙丘,sand,背景,background,黄色,yellow,暖色,warm,干旱
+---
+
+# desert.aiimage
+
+沙漠主题背景图封包。适合逃脱益智类游戏，营造紧张干旱的视觉氛围。
+
+## Recipe
+
+- **基础 prompt**：`vast desert landscape, golden sand dunes, clear blue sky, casual mobile game style, flat design, warm colors`
+- **宽高比**：9:16
+- **风格**：cartoon / flat design
+- **可 fork 变体**：
+  - 夜间沙漠：`desert at night, starry sky, moonlit sand dunes, cool blue tones`
+  - 绿洲：`desert oasis, palm trees, turquoise water, lush contrast`
+  - 沙暴：`sandstorm, orange sky, dramatic visibility, tension`
+
+**生成步骤：**
+1. 确认尺寸约束（1080×1920 PNG）
+2. 调用图像生成 API
+3. 验证并写入 `background.png`，更新 manifest
+
+## Result
+
+- **产物文件**：`background.png`
+- **格式**：PNG，最小 1080×1920
+
+## Binding
+
+- **Binding Role**：`backgroundTexture`
+- **挂载目标**：`scene://entities/Background/element/textureAsset`
+- **引用类型**：`texture-asset-reference`
+
+## 生成方式
+
+Platform Skill: `playcraft-image-generation`
+
+```bash
+# 1. 生成图片（参考 ref/ 中的参考图）
+playcraft tools generate-image \
+     --prompt "vast desert landscape, golden sand dunes, clear blue sky, casual mobile game style, flat design, warm colors" \
+     --aspect-ratio 9:16 \
+     --image-model google/imagen-3.0-generate-002 \
+     --output ta-workspace/raw.png
+
+# 2. 后处理（去白底 + 格式转换）
+playcraft image remove-background --input ta-workspace/raw.png --output ta-workspace/trimmed.png
+playcraft image convert --input ta-workspace/trimmed.png --output ta-workspace/background.webp --quality 85
+
+# 3. 将产物写入 sandbox 对应路径（见 binding.target）
+```
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are generating a desert background image for a mobile game.
+  Follow the Recipe to generate the image. Verify output constraints, then apply Binding.

package/skills/desert.aiimage/manifest.json

@@ -0,0 +1,49 @@
+{
+  "schemaVersion": 1,
+  "atomId": "desert.aiimage",
+  "bundleType": "aiimage",
+  "category": "visual",
+  "mode": "generative",
+  "label": {
+    "zh": "沙漠背景",
+    "en": "Desert background"
+  },
+  "tags": [
+    "background",
+    "visual",
+    "desert",
+    "sand",
+    "hot",
+    "arid",
+    "casual"
+  ],
+  "bindingRoles": ["backgroundTexture"],
+  "generation": {
+    "kind": "image",
+    "prompt": "vast desert landscape, golden sand dunes, clear blue sky, casual mobile game style, flat design, warm colors",
+    "aspectRatio": "9:16",
+    "model": "google/imagen-3.0-generate-002",
+    "style": "cartoon",
+    "platformSkill": "playcraft-image-generation"
+  },
+  "result": {
+    "outputFile": "background.png",
+    "format": "png",
+    "constraints": {
+      "minWidth": 1080,
+      "minHeight": 1920
+    }
+  },
+  "binding": {
+    "role": "backgroundTexture",
+    "target": "scene://entities/Background/element/textureAsset",
+    "type": "texture-asset-reference",
+    "constraints": {
+      "format": "png",
+      "minWidth": 1080
+    }
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}

package/skills/difficulty_curve_designer.aiconfig/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: difficulty_curve_designer.aiconfig
+description: 试玩广告全局难度曲线设计配置 - 定义关卡难度递进策略，包括首关保胜、峰值关卡、CTA 触发时机
+triggers: 难度曲线,difficulty curve,关卡难度,level difficulty,曲线设计,progression,试玩广告难度,playable-ads difficulty
+---
+
+# difficulty_curve_designer.aiconfig
+
+试玩广告全局难度曲线设计配置。定义关卡难度递进策略，包括：
+
+- **首关保胜**：第一关必须保证玩家成功，建立正反馈
+- **峰值体验**：在第 3 关左右制造峰值难度，让玩家感受到挑战
+- **CTA 触发时机**：峰值体验后触发 CTA，利用玩家的高参与度
+- **难度回落**：峰值后适当降低难度，给予"差一点就赢"的体验，驱动下载
+
+## Recipe
+
+- **配置方式**：参数化（parametric）
+- **核心参数**：
+  - `curveType`: `"playable-ads-standard"` — 试玩广告标准曲线
+  - `firstLevelGuaranteeWin`: `true` — 首关保胜
+  - `peakDifficultyLevel`: `3` — 峰值难度在第几关
+  - `ctaTriggerAfterLevel`: `3` — CTA 在第几关后触发
+  - `totalLevels`: `5` — 总关卡数
+  - `difficultyScale`: `[0.2, 0.4, 0.8, 0.6, 0.5]` — 每关难度系数（0-1）
+- **可 fork 变体**：
+  - 急速体验：`totalLevels: 3`, `difficultyScale: [0.2, 0.7, 0.5]`
+  - 平缓入门：`difficultyScale: [0.1, 0.2, 0.5, 0.8, 0.4]`
+  - 持续攀升（失败驱动下载）：`difficultyScale: [0.2, 0.4, 0.6, 0.8, 1.0]`
+
+**配置步骤：**
+1. 读取项目的 `game/config.json`
+2. 写入 `difficulty.curve` 配置块，包含曲线类型和关卡参数
+3. 写入 `difficulty.scale` 数组，定义每关的难度系数
+4. 设置 `difficulty.firstLevelGuaranteeWin` 标志
+5. 关联 CTA 触发时机 `cta.triggerAfterLevel`
+
+## Result
+
+- **产物**：修改 `game/config.json` 的难度曲线配置块
+- **格式**：JSON patch
+- **目标键**：`difficulty.curve`
+- **包含子键**：`curveType`, `firstLevelGuaranteeWin`, `peakDifficultyLevel`, `totalLevels`, `difficultyScale`
+
+## Binding
+
+- **Binding Role**：`gameConfig`
+- **挂载目标**：`game/config.json`
+- **引用类型**：`config-key-value`
+- **与其他 Skill 的关系**：
+  - 与 `ux_flow_spec.aiconfig` 联动：`totalLevels` 应与 UX 流程的 gameplay 阶段一致
+  - 与 `gameplay_balance_check.aivalidator` 联动：校验器会读取此配置检查平衡性
+
+## Skill Definition
+
+tools:
+  - read
+  - write
+prompt_extension: |
+  You are designing the difficulty curve for a playable ad (试玩广告).
+  The curve must follow the "hook → challenge → CTA" pattern:
+  1. Level 1 MUST guarantee player success (firstLevelGuaranteeWin: true)
+  2. Difficulty ramps up to a peak around level 3 (peakDifficultyLevel)
+  3. After the peak, trigger CTA while engagement is highest
+  4. Post-peak levels should feel "almost winnable" to drive downloads
+  Read game/config.json, apply the difficulty.curve config patch, and save.
+  The difficultyScale array values range from 0.0 (trivial) to 1.0 (impossible).
+  Total playable ad duration should stay within 30-60 seconds across all levels.

package/skills/difficulty_curve_designer.aiconfig/manifest.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 1,
+  "atomId": "difficulty_curve_designer.aiconfig",
+  "bundleType": "aiconfig",
+  "category": "config",
+  "mode": "parametric",
+  "label": {
+    "zh": "试玩广告难度曲线设计",
+    "en": "Playable ads difficulty curve designer"
+  },
+  "tags": ["config", "difficulty", "curve", "design", "progression", "cta", "playable-ads"],
+  "bindingRoles": ["gameConfig"],
+  "generation": {
+    "kind": "config-patch",
+    "params": {
+      "curveType": "playable-ads-standard",
+      "firstLevelGuaranteeWin": true,
+      "peakDifficultyLevel": 3,
+      "ctaTriggerAfterLevel": 3,
+      "totalLevels": 5,
+      "difficultyScale": [0.2, 0.4, 0.8, 0.6, 0.5]
+    }
+  },
+  "result": {
+    "configKey": "difficulty.curve",
+    "format": "json-patch"
+  },
+  "binding": {
+    "role": "gameConfig",
+    "target": "game/config.json",
+    "type": "config-key-value"
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}

package/skills/digit_renderer.aicomponent/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: digit_renderer.aicomponent
+description: 七段数码管风格数字渲染器。用 Phaser Graphics API 绘制倒计时数字和冒号分隔符，模拟 LED 七段显示效果。
+triggers: 需要绘制七段数码管风格数字显示时触发。
+---
+
+# 七段数码管渲染器（Seven-Segment Digit Renderer）
+
+## Scaffold
+
+`src/game/scenes/GameUI/DigitRenderer.ts`
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **七段数码管风格** | 倒计时数字用 LED 风格，视觉上比普通字体更紧凑、更"游戏感"；且无字体资产依赖 |
+| **纯 Graphics API 实现** | 不依赖字体文件或图片资产；七段数字用矩形拼接，跨平台渲染一致 |
+| **抽取为独立 skill** | `countdown_timer.aicomponent` 复用本渲染器，不同场景（倒计时、得分）可组合使用而不重复实现绘制逻辑 |
+
+## Adapter
+
+- **Role**: `digitRenderer` — 七段数码管风格数字 Graphics 渲染器
+- **Provides**: `DigitRenderer` 类（绘制数字、冒号分隔符）
+- **Requires**: `phaser.aicomponent`（硬依赖：Graphics API）
+- **Consumed by**: `countdown_timer.aicomponent`（倒计时显示）
+- **Integration point**: `src/game/scenes/GameUI/DigitRenderer.ts` → CountdownDisplay 持有实例
+
+## Imports
+
+- `phaser.aicomponent`（硬依赖）
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - source: src/game/scenes/GameUI/DigitRenderer.ts
+outputs:
+  - digitRenderer: DigitRenderer class
+```

package/skills/digit_renderer.aicomponent/manifest.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "atomId": "digit_renderer.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "component",
+  "mode": "fixed",
+  "label": { "zh": "七段数码管渲染器", "en": "Seven-segment digit renderer" },
+  "tags": ["ui", "digit", "seven-segment", "number-display", "graphics", "phaser"],
+  "bindingRoles": ["digitGlyphRenderer"],
+  "scaffold": {
+    "files": {
+      "src/game/scenes/GameUI/DigitRenderer.ts": { "source": "ref/DigitRenderer.ts", "mode": "full", "weight": 10 }
+    }
+  },
+  "imports": [
+    { "slot": "engine", "pinAtomId": "phaser.aicomponent", "edgeKind": "requires", "bindAs": "engine" }
+  ],
+  "exports": [
+    { "name": "DigitRenderer", "kind": "class", "location": "src/game/scenes/GameUI/DigitRenderer.ts" }
+  ],
+  "neutralDescriptor": {
+    "geometry": "seven-segment LED digit renderer drawing numbers and colon separators using Phaser Graphics primitives"
+  },
+  "files": { "skill": "SKILL.md", "digitRenderer": "ref/DigitRenderer.ts" }
+}