@playcraft/skills 0.0.2

package/skills/playable_end_screen_layout.aicomponent/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: playable_end_screen_layout.aicomponent
+description: 可玩广告结算/结束全屏层框架无关布局规范（遮罩、主视觉安全区、主次 CTA、与 download CTA 关系）。Agent 按 Canon 放置胜负 UI；Phaser 默认实现见 game_over_panel。
+triggers: 需要实现胜利/失败全屏结果、转化 CTA、或统一结算层与安全区/缩放规则时触发。
+---
+
+# 可玩结算屏布局（Playable End Screen Layout）
+
+本 skill **不包含**引擎代码，只约束 **全屏结束态** 的结构与缩放；通用缩放数学见 `responsive_2d_layout.aicomponent` **第一节**。
+
+---
+
+## 规范（Layout Canon）
+
+### 1. 结构（由底到顶）
+
+1. **全屏遮罩（Dimmer）**：覆盖 \((0,0)–(W_r,H_r)\)，通常半透明深色，用于打断游玩注意力、突出结果。
+2. **主视觉（Hero）**：胜负插图或动画主体，置于 **视觉安全区** 内——距各边预留 ≥ `m_hero,dp * uiScale`（建议 24–48 dp 量级，项目单点配置），避免刘海/圆角裁切。
+3. **主 CTA（Primary）**：试玩转化核心按钮（如 Install）；宽度建议 ≤ \(W_r - 2 \cdot \text{margin_cta} \cdot \text{uiScale}\)，纵向位置优先 **底区偏上**（与 `playable_hud_layout` 底区协调），使用 **vScale** 锚定距底边 dp。
+4. **次行动（Secondary）**：可选（再看一次、关卡提示）；尺寸与对比度低于主 CTA，避免抢转化。
+
+### 2. 缩放与字体
+
+- 主 CTA 高度、圆角、主文案字号：**dp × uiScale**。
+- **距底 / 距顶边距**：优先 **vScale** 与 Canon 1.4 节一致。
+- 结算层出现时可 **暂停或遮挡** 底部棋盘交互；**不得**在遮罩未铺满时让棋盘仍可缩放导致误触。
+
+### 3. z-order
+
+结算全屏层深度 **高于** 顶/底 HUD 与 **高于** 指引层（结算出现时通常已关闭教程）。若在失败态仍需展示弱提示，提示须附属于结算容器内，避免 depth 混乱。
+
+### 4. 资源与实现对应
+
+- 胜负 **图片** 由 `win_result_panel.aiimage` / `lose_result_panel.aiimage` 等提供；本规范只管 **占位矩形与缩放**，不规定画风。
+- **Phaser 参考**：`game_over_panel.aicomponent`（遮罩 + 结果图 + 与 `download_button` 等组合）。
+
+---
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **结算结构单独规范** | 结算屏的 CTA 位置直接影响广告转化率；明确的安全区边距和 vScale 锚点规范防止 Agent 把 CTA 放到刘海或圆角裁切区域 |
+| **遮罩是必要层** | 全屏 dimmer 打断游玩注意力，引导用户聚焦结果和 CTA；没有遮罩时用户视线在游戏画面和结果按钮间分散 |
+| **引用底区高度** | 主 CTA 的纵向位置必须与底区高度常量（`playable_hud_layout` 约定）一致，避免 CTA 被底部安全区遮挡 |
+
+## Adapter
+
+- **Role**: `playableEndScreenLayout` — 结算全屏布局规范（遮罩/主视觉/CTA 锚点 + z-order 最高），无代码产出
+- **Provides**: 结算层结构规范文档、主视觉安全区边距约定、CTA 位置规范、z-order（高于所有其他层）
+- **Requires**: `responsive_2d_layout.aicomponent`、`playable_hud_layout.aicomponent`（底区 CTA 锚点对齐）
+- **Consumed by**: `game_over_panel.aicomponent`（按此规范实现胜败面板的布局）
+- **Integration point**: 无代码集成点；Agent 加载后按规范实现 GameOverPanel 的布局
+
+## Imports
+
+- `responsive_2d_layout.aicomponent`（硬依赖）
+- 与 `playable_hud_layout.aicomponent` **建议同时加载**：底区高度与主 CTA 锚点需一致
+
+## Scaffold
+
+无 scaffold；落地见 `game_over_panel.aicomponent`。
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - layout: end-screen structure and CTA placement rules from SKILL.md
+outputs:
+  - endScreenLayers: dimmer, hero safe margins, primary/secondary CTA rules
+  - zOrderRelativeToHudAndGuidance: must be on top when shown
+```

package/skills/playable_end_screen_layout.aicomponent/manifest.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "atomId": "playable_end_screen_layout.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "layout",
+  "mode": "fixed",
+  "label": { "zh": "可玩结算屏布局规范", "en": "Playable end-screen layout" },
+  "tags": ["layout", "end-screen", "result", "win", "lose", "cta", "modal", "framework-agnostic"],
+  "bindingRoles": ["playableEndScreenLayout"],
+  "imports": [
+    { "slot": "layout", "pinAtomId": "responsive_2d_layout.aicomponent", "edgeKind": "requires", "bindAs": "layoutCanon" }
+  ],
+  "neutralDescriptor": {
+    "geometry": "full-screen dimmer, hero in safe margins, primary CTA anchored with vScale, optional secondary; above HUD and guidance",
+    "layers": ["modal", "conversion", "safe-area"],
+    "replaceable": ["m_hero,dp", "margin_cta", "opacity of dimmer"]
+  },
+  "usageHints": [
+    "结算层须全屏遮罩；主视觉留在安全区内（dp 边距 × uiScale）",
+    "主 CTA 字号与按钮高宽用 uiScale；距底用 vScale",
+    "实现参考 game_over_panel；素材见 win/lose_result_panel aiimage"
+  ],
+  "files": { "skill": "SKILL.md" }
+}

package/skills/playable_guidance_layer.aicomponent/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: playable_guidance_layer.aicomponent
+description: 可玩广告指引层（新手引导、高亮、手指提示、轻提示）框架无关布局与交互规范。约束遮罩、挖洞、pointer 缩放与深度；步进教程见 tutorial_overlay。
+triggers: 需要新手引导、无步进提示、高亮棋盘区域、手指动画，或统一指引层与 HUD/棋盘的遮挡关系时触发。
+---
+
+# 可玩指引层布局（Playable Guidance Layer）
+
+本 skill 定义 **指引 / 教程 / 轻提示** 的框架无关合同；坐标系与 **uiScale / vScale** 见 `responsive_2d_layout.aicomponent` **第一节**。
+
+---
+
+## 规范（Layout Canon）
+
+### 1. 层级
+
+- 指引层 **高于** 棋盘与 Gameplay 世界内容。
+- 指引层 **低于** 全屏结算层（`playable_end_screen_layout`）。若同时存在，应 **先结束教程** 或 **将 tutorial 收纳在结算容器内**（少见）。
+
+与 `playable_hud_layout`：**默认** 顶栏不被教程遮罩遮挡（玩家仍能看到命/时间时可读）；若全屏 darken 教程，须 **整体提高 darken 的 depth** 但仍 **低于** 顶栏 depth，或 **同时** 在教程中复述关键 HUD 信息——二者选一应项目一致。
+
+### 2. 视觉结构
+
+1. **可选全屏半透层**：`alpha` 建议 0.35–0.6；颜色深色系以保证挖洞对比。
+2. **挖洞（Spotlight）**：对准目标区域，洞缘可软边；洞区域须与 **实际可点热区** 对齐（考虑 uiScale 后的最小点击 44pt 等价）。
+3. **Pointer（手指）**：素材见 `figer_icon.aiimage` 等；尺寸 **dp × uiScale**，摆动动画幅度亦按 uiScale 缩放，避免大屏夸张。
+
+### 3. 类型区分
+
+| 类型 | 行为 | 备注 |
+|------|------|------|
+| **步进教程** | 多步、阻塞直到点击目标 | `tutorial_overlay.aicomponent` |
+| **单条轻提示** | Toast / 横幅、限时消失 | 同一 depth 合同，可不挖洞 |
+| **僵局提示** | 如无可走步 | 可配合 `nomove_hint_overlay` 素材 |
+
+### 4. Agent 义务
+
+- 指引用字号、描边、间距：**dp × uiScale**；自屏幕边缘的位移：**vScale**。
+- **禁止** 在指引层使用与全局不同的自创缩放比。
+- 教程步进状态机与玩法偶合时，须在 skill 文档或代码注释中标明 **与关卡索引的触发条件**（如前 1–2 关）。
+
+---
+
+## 与实现 skill 的对应关系
+
+| 合同项 | Phaser 参考 |
+|--------|------------|
+| 步进引导 | `tutorial_overlay.aicomponent` |
+| 手指素材 | `figer_icon.aiimage`（软槽位） |
+
+---
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **框架无关规范** | 指引层 z-order bug（手指在 HUD 后面、挖洞与实际点击热区错位）在 Phaser 和 Three.js 中都会出现；统一规范防止两个实现走向不同约定 |
+| **指引层低于结算层** | 结算出现时通常已关闭教程；明确约定避免教程遮罩挡住胜利面板的 CTA 按钮 |
+| **Spotlight 热区对齐要求** | 挖洞区域必须与实际可点击区域完全对齐；错位会让玩家点了"高亮区域"却没有响应，严重损害体验 |
+
+## Adapter
+
+- **Role**: `playableGuidanceLayout` — 指引/新手教程层深度与遮罩规范，无代码产出
+- **Provides**: 指引层深度约定（高于棋盘/HUD，低于结算）、Spotlight 对齐要求、Pointer 缩放规范文档
+- **Requires**: `responsive_2d_layout.aicomponent`、`playable_hud_layout.aicomponent`（层级关系参考）
+- **Consumed by**: `tutorial_overlay.aicomponent`（按此规范设置 TutorialManager 的 depth 和挖洞逻辑）
+- **Integration point**: 无代码集成点；Agent 加载后按规范实现 TutorialManager 的视觉层级
+
+## Imports
+
+- `responsive_2d_layout.aicomponent`（硬依赖）
+- 建议加载 `playable_hud_layout.aicomponent` 以统一 depth 合同
+
+## Scaffold
+
+无 scaffold。
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - layout: guidance layer depth, dimmer, spotlight, pointer scaling rules
+outputs:
+  - guidanceZOrder: relative to board, HUD, end screen
+  - pointerAndMarginRules: dp * uiScale; edge offsets with vScale
+```

package/skills/playable_guidance_layer.aicomponent/manifest.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "atomId": "playable_guidance_layer.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "layout",
+  "mode": "fixed",
+  "label": { "zh": "可玩指引层布局规范", "en": "Playable guidance layer layout" },
+  "tags": ["layout", "tutorial", "onboarding", "overlay", "spotlight", "framework-agnostic"],
+  "bindingRoles": ["playableGuidanceLayout"],
+  "imports": [
+    { "slot": "layout", "pinAtomId": "responsive_2d_layout.aicomponent", "edgeKind": "requires", "bindAs": "layoutCanon" }
+  ],
+  "neutralDescriptor": {
+    "geometry": "guidance above board, below end-screen modal; dimmer + spotlight + pointer scaled by uiScale",
+    "layers": ["tutorial", "hint", "z-order"],
+    "replaceable": ["dimmer alpha", "min touch target dp"]
+  },
+  "usageHints": [
+    "pointer 与文案统一 uiScale；顶栏与教程 depth 关系见 SKILL 第一节",
+    "步进实现用 tutorial_overlay；轻提示可复用同一 z-order 合同",
+    "结算全屏出现时指引层须让路"
+  ],
+  "files": { "skill": "SKILL.md" }
+}

package/skills/playable_hud_layout.aicomponent/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: playable_hud_layout.aicomponent
+description: 可玩广告 HUD（顶/底预留区 + 棋盘可用矩形）框架无关布局规范。约束 Agent：在 responsive_2d_layout Layout Canon 下如何划分屏幕、导出高度常量、z-order；默认 Phaser 实现见 top_ui_bar / bottom_ui_bar。
+triggers: 需要摆放顶部 HUD、底部条、计算棋盘可用区域，或统一 HUD 与棋盘的垂直扣减规则时触发。
+---
+
+# 可玩 HUD 屏幕分区（Playable HUD Layout）
+
+本 skill **不包含**具体引擎代码，只定义 **框架无关** 的分区合同；缩放数学见 `responsive_2d_layout.aicomponent` **第一节 Layout Canon**。
+
+---
+
+## 规范（Layout Canon）
+
+### 1. 纵向三层模型
+
+在已应用安全区 inset 后的运行时矩形 \((W_r, H_r)\) 内，自下而上约定：
+
+1. **底区（Bottom band）**：高度 \(H\_{\text{bottom}} = h\_{\text{bottom,dp}} \cdot \text{vScale}\)。`h_bottom,dp` 默认与 `GameConfig.GAME_BOTTOM_UI_BAR_HEIGHT`（如 110）一致，**单点配置**；可放置 CTA、品牌条或策略性留白。
+2. **中间区（Play area）**：供棋盘 / 世界内容；高度  
+   \(H\_{\text{mid}} = H_r - H\_{\text{top}} - H\_{\text{bottom}}\)。  
+   **禁止** 在棋盘布局器内硬编码「整屏高度」而不扣顶底。
+3. **顶区（Top band）**：高度 \(H\_{\text{top}} = h\_{\text{top,dp}} \cdot \text{vScale}\)。`h_top,dp` 由顶部 HUD skill 导出（如 `GAME_TOP_UI_BAR_HEIGHT`）。
+
+### 2. 横向与尺寸
+
+- 顶/底区 **背景与通栏控件** 宽度为 \(W_r\)。
+- 顶区内子控件（命、计时、进度）的间距与字号遵循 Canon：**dp × uiScale**（或垂向间距用 **vScale** 与顶栏内部约定一致）。
+
+### 3. z-order（渲染与交互）
+
+约定自上而下（**数值更大者更靠前**）：
+
+| 层级（概念） | 相对深度 | 说明 |
+|-------------|---------|------|
+| 棋盘 / 玩法世界 | 基准（如 0–200） | 主游玩内容 |
+| 顶栏 / 底栏 HUD | 高于棋盘（如 500） | 始终可操作、不被棋盘遮挡 |
+| 指引层 | 高于 HUD | 见 `playable_guidance_layer.aicomponent` |
+| 全屏结算 | 最高 | 见 `playable_end_screen_layout.aicomponent` |
+
+具体 depth 数值可由项目统一常量表定义，但 **相对顺序不得颠倒**。
+
+### 4. Agent 义务
+
+1. 棋盘可用高度必须使用 **\(H_{\text{mid}}\)** 或等价推导，与 `grid_board_layout` / 输入层的扣减一致。
+2. 若仅实现顶栏而未装底栏组件，**仍须**在布局算式中保留 `h_bottom,dp`，除非项目显式改为 0。
+3. 所有 `h_* ,dp` 常量须在单一配置或导出处维护，禁止魔法数分散在多个文件且互不引用。
+
+---
+
+## 与实现 skill 的对应关系
+
+| 合同项 | Phaser 参考实现 |
+|--------|----------------|
+| 顶区 + `h_top,dp` | `top_ui_bar.aicomponent` → `GAME_TOP_UI_BAR_HEIGHT` |
+| 底区 + `h_bottom,dp` | `bottom_ui_bar.aicomponent` → `GAME_BOTTOM_UI_BAR_HEIGHT`（与 `GameConfig` 对齐） |
+| 中间区几何 | `grid_board_layout.aicomponent` |
+
+---
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **框架无关规范** | 顶/中/底三层分区模型在 Phaser 和 Three.js 中都适用；若写入 phaser 相关 skill，Three.js 项目无法引用同一 HUD 约定 |
+| **高度常量单点配置** | 顶/底栏高度（dp 值）必须在一处定义，棋盘布局和 UI 条同时引用；多处写死魔法数字是最常见的布局 bug 来源 |
+| **z-order 约束明确** | 棋盘/HUD/指引/结算四层的相对顺序不得颠倒；显式文档约束比代码注释更易被 Agent 发现和遵从 |
+
+## Adapter
+
+- **Role**: `playableHudLayout` — 可玩 HUD 三层屏幕分区规范（顶/中/底 + z-order），无代码产出
+- **Provides**: 纵向三层模型规范、高度常量命名约定（`GAME_TOP_UI_BAR_HEIGHT`、`GAME_BOTTOM_UI_BAR_HEIGHT`）、z-order 约束文档
+- **Requires**: `responsive_2d_layout.aicomponent`（uiScale / vScale / W_r / H_r 定义）
+- **Consumed by**: `top_ui_bar.aicomponent`、`bottom_ui_bar.aicomponent`（实现约定中的顶/底区）、`grid_board_layout.aicomponent`（棋盘高度扣减参考）、`playable_guidance_layer.aicomponent`（层级关系参考）
+- **Integration point**: 无代码集成点；Agent 加载后按规范约束实现各 HUD 组件
+
+## Imports
+
+- `responsive_2d_layout.aicomponent`（**硬依赖**：uiScale / vScale / \(W_r,H_r\) 定义）
+
+## Scaffold
+
+本 skill **无** scaffold 文件；仅规范文档。落地代码见上表。
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - layout: HUD / play-area vertical contract from SKILL.md sections above
+outputs:
+  - hudBandHeights: design-dp constants and formulas using vScale
+  - zOrderRules: relative ordering among board, HUD, guidance, end screen
+```

package/skills/playable_hud_layout.aicomponent/manifest.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "atomId": "playable_hud_layout.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "layout",
+  "mode": "fixed",
+  "label": { "zh": "可玩 HUD 屏幕分区规范", "en": "Playable HUD screen regions" },
+  "tags": ["layout", "hud", "top-bar", "bottom-bar", "safe-area", "play-area", "framework-agnostic"],
+  "bindingRoles": ["playableHudLayout"],
+  "imports": [
+    { "slot": "layout", "pinAtomId": "responsive_2d_layout.aicomponent", "edgeKind": "requires", "bindAs": "layoutCanon" }
+  ],
+  "neutralDescriptor": {
+    "geometry": "framework-agnostic vertical bands: top HUD, play area, bottom band; heights from dp * vScale; z-order above board",
+    "layers": ["screen-partition", "hud", "layout-contract"],
+    "replaceable": ["h_top,dp", "h_bottom,dp", "depth constants"]
+  },
+  "usageHints": [
+    "先读 responsive_2d_layout 第一节，再套用顶/中/底三层高度扣减",
+    "棋盘可用高度 = Hr - h_top,dp*vScale - h_bottom,dp*vScale（或使用已 inset 后的 Hr）",
+    "HUD depth 须高于棋盘；指引与结算层顺序见 playable_guidance_layer / playable_end_screen_layout"
+  ],
+  "files": { "skill": "SKILL.md" }
+}

package/skills/playable_scripts_build.aicomponent/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: playable_scripts_build.aicomponent
+description: 试玩广告多渠道构建管线（@tencent/playable-scripts）。提供 builds.config.js 批量构建配置，支持按主题变体 × 渠道自动生成构建产物，自动扫描 src/theme/ 目录发现主题。
+triggers: 需要配置试玩广告的构建脚本、多渠道打包或主题批量构建时触发。
+---
+
+# 试玩广告构建管线（Playable Scripts Build Pipeline）
+
+## 说明
+
+使用 `@tencent/playable-scripts` 打包 Phaser 试玩广告，支持：
+
+- **单渠道构建**（`pnpm build`）：构建默认渠道产物
+- **批量构建**（`pnpm builds`）：所有主题变体 × 所有渠道，自动命名文件
+- **主题自动发现**：扫描 `src/theme/` 目录，排除 blacklist 后构建所有主题
+
+## Scaffold
+
+| 目标路径 | 来源 | 说明 |
+|---------|-----|-----|
+| `builds.config.js` | `ref/builds.config.js` | 批量构建配置（主题/渠道/命名规则） |
+
+`package.json` 新增：
+- `devDependencies: "@tencent/playable-scripts": "*"`
+- `scripts: dev / build / builds`
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **@tencent/playable-scripts 封装** | 试玩广告需要针对不同投放渠道（腾讯广告、Google、Facebook 等）分别打包；`playable-scripts` 已内置多渠道构建模板，避免手写各渠道差异配置 |
+| **主题自动发现** | `src/theme/` 目录下的主题由 AI Agent 按 Remix 需求生成；构建脚本自动扫描而非手写主题列表，避免新增主题时忘记更新构建配置 |
+| **与 webpack_build 并存** | `webpack_build.aicomponent` 适用于无腾讯平台依赖的通用项目；本 skill 适用于接入腾讯投放体系的正式产品；两者职责不同，均保留 |
+
+## Adapter
+
+- **Role**: `buildPipeline` — 试玩广告多渠道批量构建管线（腾讯 playable-scripts）
+- **Provides**: `builds.config.js` 批量构建配置、`pnpm dev`/`pnpm build`/`pnpm builds` npm 命令
+- **Requires**: `phaser.aicomponent`（基础引擎骨架）
+- **Consumed by**: `theme_switcher_build.aicomponent`（builds.config.js 在构建时替换主题 import）；`theme_variant.aiconfig` 主题变体通过本管线打包
+- **Integration point**: 根目录 `builds.config.js` + `package.json` scripts —— CI 构建时执行 `pnpm builds` 产出所有变体产物
+
+## Imports
+
+- `phaser.aicomponent`（硬依赖：基础引擎）
+
+## Skill Definition
+
+```yaml
+tools:
+  - read_file
+  - write_file
+inputs:
+  - source: builds.config.js
+outputs:
+  - buildConfig: builds.config.js
+  - buildScripts: dev / build / builds npm scripts
+  - buildDep: "@tencent/playable-scripts" devDependency
+```
+
+## 使用方式
+
+```bash
+pnpm dev                          # 开发模式
+pnpm build                        # 构建单渠道
+pnpm builds                       # 批量构建所有主题 × 渠道
+pnpm builds -- -t "某主题名"      # 构建指定主题
+pnpm builds -- -c google,facebook # 构建指定渠道
+```

package/skills/playable_scripts_build.aicomponent/manifest.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": 1,
+  "atomId": "playable_scripts_build.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "build",
+  "mode": "fixed",
+  "deprecated": true,
+  "replacedBy": "webpack_build.aicomponent",
+  "deprecationNote": "依赖 @tencent/playable-scripts 私有包，脱离腾讯内部环境无法使用。请使用 webpack_build.aicomponent 作为通用替代方案。",
+  "label": { "zh": "试玩广告构建管线（已废弃）", "en": "Playable ads build pipeline (deprecated)" },
+  "tags": ["build", "playable-scripts", "webpack", "bundle", "multi-channel", "playable-ads"],
+  "bindingRoles": ["buildPipeline"],
+  "scaffold": {
+    "files": {
+      "builds.config.js": {
+        "source": "ref/builds.config.js",
+        "mode": "full",
+        "weight": 10
+      }
+    },
+    "packageJson": {
+      "devDependencies": {
+        "@tencent/playable-scripts": { "version": "*", "weight": 10 }
+      },
+      "scripts": {
+        "dev":   { "command": "playable-scripts dev", "weight": 10 },
+        "build": { "command": "playable-scripts build", "weight": 10 },
+        "builds":{ "command": "playable-scripts builds", "weight": 10 }
+      }
+    }
+  },
+  "imports": [
+    { "slot": "engine", "pinAtomId": "phaser.aicomponent", "edgeKind": "requires", "bindAs": "engine" }
+  ],
+  "exports": [
+    { "name": "builds.config.js", "kind": "config-file", "location": "builds.config.js" }
+  ],
+  "neutralDescriptor": {
+    "geometry": "multi-channel playable ad build system with per-theme variant generation and automated file naming",
+    "layers": ["build-toolchain", "multi-channel", "bundler"],
+    "replaceable": ["channel list", "naming convention", "theme blacklist"]
+  },
+  "usageHints": [
+    "`pnpm build` 构建单渠道默认产物",
+    "`pnpm builds` 批量构建所有主题 × 所有渠道的组合",
+    "builds.config.js 通过扫描 src/theme/ 目录自动发现主题变体",
+    "THEME_BLACKLIST 中排除 dev、current.ts 等非正式主题"
+  ],
+  "files": {
+    "skill": "SKILL.md",
+    "buildsConfig": "ref/builds.config.js"
+  }
+}