---
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 # 构建指定渠道
```