@playcraft/skills 0.0.2

package/skills/2048_core.aigameplay/ref/reducer.template.ts

@@ -0,0 +1,189 @@
+/**
+ * 2048_core.aigameplay — reducer 接口模板
+ *
+ * Agent 生成实际 reducer 时，必须导出以下函数。
+ * 此文件是接口约束模板，不是可执行代码。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * ⚠️ 重要：渲染层（GameScene）不应直接调用 dispatch()
+ *
+ * dispatch() 是一体化接口，内部完成滑动 + 合并 + 生成后只返回最终状态，
+ * 中间过程（哪些方块移动了多远、哪些方块合并了、新方块在哪里生成）全部丢失。
+ *
+ * 渲染层需要分步动画（方块平移 → 合并弹跳 → 新方块弹出），
+ * 因此必须使用下方的「分步函数」逐步驱动，每步之间插入 Tween 动画。
+ *
+ * dispatch() 的用途：无头测试、AI 模拟、快速跳过动画等场景。
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+// ─── 配置类型 ─────────────────────────────────────────────────────────────────
+
+export type SlideDirection = 'up' | 'down' | 'left' | 'right';
+
+export type Game2048Config = {
+  /** 棋盘尺寸，默认 4（4×4） */
+  gridSize: number;
+  /** 胜利目标值，默认 2048 */
+  winValue: number;
+  /** 生成方块的可选值，默认 [2, 4] */
+  spawnValues: number[];
+  /** 对应权重（0-1），默认 [0.9, 0.1] */
+  spawnWeights: number[];
+  /** 初始生成方块数量，默认 2 */
+  initialTileCount: number;
+  /** 胜利后是否继续，默认 false */
+  continueAfterWin: boolean;
+};
+
+// ─── 动作类型 ─────────────────────────────────────────────────────────────────
+
+export type Game2048Action =
+  | { type: 'slide'; direction: SlideDirection }
+  | { type: 'reset' };
+
+// ─── 状态类型 ─────────────────────────────────────────────────────────────────
+
+/**
+ * 棋盘格子，null 表示空格
+ * board[row][col]，row 0 为顶行，col 0 为左列
+ */
+export type TileCell = {
+  value: number;
+  /** 本次滑动中是否已参与合并（防止二次合并） */
+  merged: boolean;
+} | null;
+
+export type Game2048State = {
+  /** 4×4 棋盘，board[row][col] */
+  board: TileCell[][];
+  /** 当前得分 */
+  score: number;
+  /** 历史最高分 */
+  bestScore: number;
+  /** 游戏是否结束 */
+  gameOver: boolean;
+  /** 是否达到胜利值 */
+  win: boolean;
+  /** 上次滑动是否有效（棋盘发生变化） */
+  lastSlideEffective: boolean;
+};
+
+// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
+
+/** 方块移动信息（用于驱动平移动画） */
+export type TileMove = {
+  /** 来源位置 */
+  from: { row: number; col: number };
+  /** 目标位置 */
+  to: { row: number; col: number };
+  /** 方块值 */
+  value: number;
+};
+
+/** 合并信息（用于驱动合并动画） */
+export type MergeResult = {
+  /** 合并发生在目标位置 */
+  position: { row: number; col: number };
+  /** 合并前两个方块的值 */
+  fromValue: number;
+  /** 合并后的新值 */
+  toValue: number;
+  /** 本次合并的得分 */
+  scoreGained: number;
+};
+
+/** 新生成方块信息 */
+export type SpawnedTile = {
+  row: number;
+  col: number;
+  value: number;
+};
+
+/** slideBoard 的完整返回 */
+export type SlideResult = {
+  /** 更新后的棋盘（已完成移动和合并，但尚未重置 merged 标志） */
+  board: TileCell[][];
+  /** 所有方块的移动信息 */
+  moves: TileMove[];
+  /** 所有合并信息 */
+  merges: MergeResult[];
+  /** 本次滑动是否有效（棋盘发生变化） */
+  effective: boolean;
+  /** 本次滑动新增得分 */
+  scoreGained: number;
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 必须导出的函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+
+/**
+ * init：根据配置初始化游戏状态，随机放置 initialTileCount 个方块
+ */
+export declare function init(config: Game2048Config): Game2048State;
+
+// ─── 一体化接口（测试/AI 模拟用） ───────────────────────────────────────────
+
+/**
+ * dispatch：接收动作，返回新状态（纯函数，不得修改原 state）
+ * - slide：滑动棋盘，合并方块，生成新方块，检测胜败（一步到位）
+ * - reset：重置到初始状态
+ *
+ * ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
+ */
+export declare function dispatch(state: Game2048State, action: Game2048Action): Game2048State;
+
+/**
+ * getState：返回当前状态快照
+ */
+export declare function getState(state: Game2048State): Game2048State;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 分步函数（渲染层/场景层必须使用这些函数驱动动画）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * slideBoard：执行一次滑动操作（移动 + 合并）
+ * 返回包含移动信息、合并信息和更新后棋盘的完整结果
+ *
+ * 场景层调用顺序：
+ * 1. slideBoard → 获取 moves / merges / board
+ * 2. playTileMoveAnimation(moves) 并行平移动画
+ * 3. playTileMergeAnimation(merges) 合并弹跳动画
+ * 4. 若 effective，调用 spawnTile(board)
+ *
+ * 关键约束：合并后的方块其 merged = true，本次滑动不再参与二次合并
+ */
+export declare function slideBoard(board: TileCell[][], direction: SlideDirection): SlideResult;
+
+/**
+ * mergeTiles：仅执行合并逻辑（不含位移），用于需要独立控制合并步骤的场景
+ * 通常直接使用 slideBoard 即可，此函数供高级定制使用
+ */
+export declare function mergeTiles(board: TileCell[][], direction: SlideDirection): MergeResult[];
+
+/**
+ * spawnTile：在棋盘随机空格生成新方块
+ * 返回生成的方块信息（直接修改传入的 board 引用）
+ *
+ * 场景层根据 SpawnedTile 在对应位置创建精灵并播放 scale 0→1 弹出动画
+ * 若无空格则返回 null（理论上 slideBoard effective 后必有空格）
+ */
+export declare function spawnTile(board: TileCell[][]): SpawnedTile | null;
+
+/**
+ * hasValidMoves：检查棋盘是否还有可用的合法滑动
+ * - 有空格：true
+ * - 无空格但有相邻同值方块：true
+ * - 无空格且无相邻同值方块：false（游戏结束）
+ */
+export declare function hasValidMoves(board: TileCell[][]): boolean;
+
+/**
+ * calculateScore：计算一轮合并的总得分
+ * 每次合并得分 = 合并后新方块的值
+ */
+export declare function calculateScore(merges: MergeResult[]): number;

package/skills/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: sound-effects
+description: 通过 playcraft CLI 生成音效（SFX）；--prompt 仅支持英文。含时长、循环等 CLI 参数与英文提示词写法，与 playcraft-audio-generation 配合。
+license: MIT
+source: https://github.com/elevenlabs/skills/tree/main/sound-effects
+compatibility: agent,opencode
+---
+
+# 音效生成（SFX）— CLI 与提示词
+
+用**英文文字描述**生成短音效（平台后端走 ElevenLabs Sound Effects，**不是**语音 TTS）。你在沙箱里**只使用 `playcraft tools generate-sfx`**；云端认证与厂商侧配置由平台处理，**无需也不应**在技能文档或命令中涉及密钥、环境变量或自行调用厂商 HTTP/SDK。
+
+## 语言（必须遵守）
+
+**`--prompt` 只支持英文。** 不要用中文或其他语言写 SFX 描述：模型对非英文支持差，易出现杂音、语义跑偏或听感像念白。若用户给中文需求，先在心里翻译成简洁英文短语再写入 `--prompt`。
+
+## CLI
+
+```bash
+playcraft tools generate-sfx \
+  --prompt "<English only, see Prompt Tips below>" \
+  [--duration <秒>] \
+  [--loop] \
+  --output <路径>
+```
+
+| CLI 选项 | 说明 |
+|----------|------|
+| `--prompt` | 必填，**仅英文**音效描述 |
+| `--duration` | 可选，约 0.5–30 秒 |
+| `--loop` | 可选，可循环音效 |
+| `--output` | 必填，保存路径（如 `./assets/audio/click.mp3`） |
+
+生成 BGM 用 `playcraft tools generate-bgm`（见 `playcraft-audio-generation`）。
+
+## Prompt Tips（英文 `--prompt`，优先遵守）
+
+- 具体化："Heavy rain on a tin roof" 优于 "Rain"
+- 组合层次："Footsteps on gravel with distant traffic"
+- 标明风格："Cinematic braam, horror" 或 "8-bit retro jump sound"
+- 情绪与场景："Eerie wind howling through an abandoned building"
+- 使用**非对白、偏拟声/材质/场景**的短语；长句口语容易听起来像念稿（虽非 TTS API）
+
+## 失败时
+
+根据 CLI 报错判断：参数问题则改 `--prompt` / `--duration`；若提示权限、额度或上游不可用，向用户说明需**在平台侧**检查配置或配额——**不要**尝试自行配置密钥或直连厂商 API。

package/skills/ad_compliance_rules.aiconfig/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: ad_compliance_rules.aiconfig
+description: 广告合规规则配置 - 定义 Facebook、Google、TikTok、Unity Ads 的试玩广告技术合规要求
+triggers: 合规,compliance,审核,review,平台规则,platform rules,广告政策,ad policy,facebook规则,google规则
+---
+
+# ad_compliance_rules.aiconfig
+
+广告合规规则配置。定义各广告平台（Facebook、Google、TikTok、Unity Ads）的试玩广告技术合规要求，作为构建和审核的检查清单。
+
+### 通用规则
+
+| 规则 | 要求 | 说明 |
+|------|------|------|
+| 文件大小 | ≤ 5MB | 所有平台的硬性限制 |
+| 外部请求 | 禁止 | 不允许 fetch/XHR/动态加载 |
+| 自动播放音频 | 禁止 | 必须用户交互后才能播放 |
+| CTA 按钮 | 必须有 | 必须包含明确的下载/安装按钮 |
+| Viewport | 固定 | `width=device-width, initial-scale=1, user-scalable=no` |
+
+### 平台特定规则
+
+| 平台 | 格式 | 特殊要求 |
+|------|------|---------|
+| Facebook | HTML 或 ZIP | 不使用 MRAID |
+| Google | HTML 或 ZIP | 必须使用 `ExitApi` |
+| TikTok | ZIP | 必须集成 TikTok SDK |
+| Unity Ads | 单 HTML | 必须使用 MRAID |
+
+## Recipe
+
+- **配置方式**：固定（fixed）
+- **核心参数**：
+  - `rules.universal`: 所有平台共用的合规规则
+  - `rules.facebook`: Facebook Playable Ads 特定规则
+  - `rules.google`: Google Interactive Ads 特定规则
+  - `rules.tiktok`: TikTok Playable Ads 特定规则
+  - `rules.unity`: Unity Ads Playable 特定规则
+- **使用场景**：
+  - 构建前：检查项目设置是否符合目标平台要求
+  - 构建后：验证产物是否满足合规清单
+  - 审核时：Reviewer Agent 按此清单逐项检查
+
+**配置步骤：**
+1. 读取项目的 `game/config.json`
+2. 写入 `compliance` 配置块，包含通用规则和各平台特定规则
+3. 此配置为固定值，通常不需要用户修改
+
+## Result
+
+- **产物**：修改 `game/config.json` 的合规规则配置块
+- **格式**：JSON patch
+- **目标键**：`compliance`
+- **包含子键**：`rules.universal`, `rules.facebook`, `rules.google`, `rules.tiktok`, `rules.unity`
+
+## Binding
+
+- **Binding Role**：`gameConfig`
+- **挂载目标**：`game/config.json`
+- **引用类型**：`config-key-value`
+- **与其他 Skill 的关系**：
+  - 与 `cta_platform_config.aiconfig` 联动：CTA 实现必须符合对应平台的合规要求
+  - 与 `playtest_report.aivalidator` 联动：试玩报告中包含合规检查项
+
+## Skill Definition
+
+tools:
+  - read
+  - write
+prompt_extension: |
+  You are configuring ad compliance rules for a playable ad (试玩广告).
+  These rules define the technical requirements that each ad platform enforces.
+  CRITICAL rules that MUST be followed for ALL platforms:
+  - File size ≤ 5MB (compressed)
+  - No external HTTP requests (no fetch, XHR, dynamic script loading)
+  - No auto-play audio (audio only after user interaction)
+  - Must include a CTA (Call-to-Action) button
+  - Viewport meta tag must be set correctly
+  Platform-specific requirements:
+  - Facebook: No MRAID. Use FbPlayableAd SDK.
+  - Google: Must use ExitApi for CTA. No MRAID.
+  - TikTok: Must include TikTok Playable SDK. ZIP format required.
+  - Unity Ads: Must use MRAID. Single HTML file format.
+  Read game/config.json and write the compliance rules config block.
+  This config is used by the Reviewer agent to validate builds.

package/skills/ad_compliance_rules.aiconfig/manifest.json

@@ -0,0 +1,60 @@
+{
+  "schemaVersion": 1,
+  "atomId": "ad_compliance_rules.aiconfig",
+  "bundleType": "aiconfig",
+  "category": "config",
+  "mode": "fixed",
+  "label": {
+    "zh": "广告合规规则配置",
+    "en": "Ad compliance rules config"
+  },
+  "tags": ["config", "compliance", "rules", "platform", "facebook", "google", "tiktok", "policy", "playable-ads"],
+  "bindingRoles": ["gameConfig"],
+  "generation": {
+    "kind": "config-patch",
+    "params": {
+      "rules": {
+        "universal": {
+          "maxFileSize": "5MB",
+          "noExternalRequests": true,
+          "noAutoPlayAudio": true,
+          "mustHaveCta": true,
+          "mustBeSingleFile": false,
+          "viewportMeta": "width=device-width, initial-scale=1, user-scalable=no"
+        },
+        "facebook": {
+          "maxFileSize": "5MB",
+          "format": "single-html-or-zip",
+          "mraid": false
+        },
+        "google": {
+          "maxFileSize": "5MB",
+          "format": "single-html-or-zip",
+          "exitApi": true
+        },
+        "tiktok": {
+          "maxFileSize": "5MB",
+          "format": "zip",
+          "sdkRequired": true
+        },
+        "unity": {
+          "maxFileSize": "5MB",
+          "format": "single-html",
+          "mraid": true
+        }
+      }
+    }
+  },
+  "result": {
+    "configKey": "compliance",
+    "format": "json-patch"
+  },
+  "binding": {
+    "role": "gameConfig",
+    "target": "game/config.json",
+    "type": "config-key-value"
+  },
+  "files": {
+    "skill": "SKILL.md"
+  }
+}

package/skills/agent_remix_orchestrator.aicomponent/SKILL.md

@@ -0,0 +1,257 @@
+# agent_remix_orchestrator — Remix 编排器指南
+
+**定位**：L0 Manager 的操作手册。本 Skill 不生成任何文件，只提供从用户意图到完整 Remix 产出的完整 7 步工作流指南。
+
+## Recipe
+
+| 决策 | 原因 |
+|------|------|
+| **7 步线性工作流** | 将 DAG 操作链路分解为可执行的离散步骤，Agent 可逐步确认状态，避免因顺序错误导致管线断裂 |
+| **三信号融合权重** | 单信号（LLM 直觉 / 历史 CTR / 用户偏好）各有盲区；三信号加权合成在冷启动和成熟期均可用 |
+| **分歧度驱动 HITL** | Agent 自主执行高一致决策，只在真正有分歧时才打扰用户，降低交互成本 |
+| **非代码 Skill** | 编排逻辑是 Agent 的认知框架，不产出项目文件；作为 SKILL.md 存在使其能被 `search_skills` 发现并加载 |
+
+## Adapter
+
+- **Role**: `remixOrchestrator` — L0 Manager 从意图到 Remix 的完整 7 步工作流 SOP
+- **Provides**: 工作流步骤文档、API 调用示例、bindingRole 速查表、错误处理原则
+- **Requires**: 所有 Atom Skill（在工作流 Step 6 中按 DAG 拓扑序逐一加载）
+- **Consumed by**: Agent L0 Manager 在接收用户意图时首先加载本 Skill 作为决策手册
+- **Integration point**: 无代码集成点；Agent 读取 SKILL.md 内容后按工作流步骤执行
+
+**前置阅读**：
+- `docs/recommend/design-framework.md` — 核心概念：Remix = DAG(Atom[])
+- `docs/recommend/agent-decision-mechanism.md` — 三信号融合与权重计算
+- `docs/recommend/atom-to-remix-design.md` — Binding 机制与 Recipe 封包格式
+
+---
+
+## 总体工作流
+
+```
+用户意图
+  ↓ Step 1: parse_intent
+IntentTags（在乎维度 / 不在乎维度）
+  ↓ Step 2: search_skills
+候选 Atom 列表
+  ↓ Step 3: DAG 拓扑排序
+生成顺序
+  ↓ Step 4: 计算三信号权重
+每个 Atom 的 final_score 排序
+  ↓ Step 5: 分歧度判断
+自主执行 / 问人确认
+  ↓ Step 6: 按拓扑序执行各 Atom Skill
+封包写入沙箱分支
+  ↓ Step 7: 触发构建
+可交付 Playable
+```
+
+---
+
+## Step 1：解析意图
+
+**调用**：`POST /api/agent/tools/parse-intent`
+
+```json
+// Request
+{ "prompt": "热带休闲 match-3，参考 R2 风格，保留我的难度曲线" }
+
+// Response
+{
+  "intentTags": {
+    "画风": ["热带", "自然"],
+    "节奏": ["休闲"],
+    "核心玩法": ["消除"],
+    "关卡难度": null,
+    "音乐风格": null
+  },
+  "caredDimensions": ["画风", "节奏", "核心玩法"],
+  "uncaredDimensions": ["关卡难度", "音乐风格"]
+}
+```
+
+**规则**：
+- `caredDimensions`（non-null）= 用户在乎，后续 α=0.8
+- `uncaredDimensions`（null）= 用户不在乎，后续 β=0.8
+- 用户显式锁定的维度（"保留我的难度曲线"）单独记录为 `C_locked`，不参与策略搜索
+
+**Phase 3 MVP 说明**：当前 `parse_intent` 为 mock 实现，所有维度返回 null，退化为双信号（历史权重 + LLM 判断）。`caredDimensions` 始终为空。
+
+---
+
+## Step 2：查询 Atom 候选空间
+
+**调用**：`POST /api/agent/tools/search-skills`
+
+按 bindingRole / category / bundleType 查询可用 Skill 候选列表。
+
+```json
+// 查询所有背景音乐候选
+{
+  "matchBindingRoles": ["bgMusic"],
+  "allowedBundleTypes": ["aiaudio"]
+}
+
+// 查询所有玩法候选（已确认 phaser 引擎在上游）
+{
+  "allowedCategories": ["gameplay"],
+  "contextAtomIds": ["phaser.aicomponent"]
+}
+```
+
+**Response**：每个候选包含 `atomId`、`label`、`tags`、`bindingRoles`、`imports`（依赖声明）。
+
+**速查表：各维度对应的 bindingRole**
+
+| 维度 | matchBindingRoles | 典型 bundleType |
+|------|-------------------|----------------|
+| 引擎 | `gameEngine` | `aicomponent` |
+| 背景音乐 | `bgMusic` | `aiaudio` |
+| 点击音效 | `sfxClick` | `aiaudio` |
+| 玩法规则 | `gameplayRule` | `aigameplay` |
+| 关卡数据格式 | `levelDataFormat` | `aicomponent` |
+| 棋盘布局 | `gridBoardLayout` | `aicomponent` |
+| 响应式布局 | `responsiveLayout` | `aicomponent` |
+| HUD 屏幕分区（规范） | `playableHudLayout` | `aicomponent` |
+| 结算屏布局（规范） | `playableEndScreenLayout` | `aicomponent` |
+| 指引层布局（规范） | `playableGuidanceLayout` | `aicomponent` |
+| 顶部 HUD 条 | `topUiBar` | `aicomponent` |
+| 底部 HUD 条 | `bottomUiBar` | `aicomponent` |
+| 游戏主场景 | `gameMainScene` | `aicomponent` |
+| 预加载场景 | `preloaderScene` | `aicomponent` |
+| 胜负面板 | `gameOverDialog` | `aicomponent` |
+| 下载按钮 | `downloadCta` | `aicomponent` |
+| App Logo | `appLogo` | `aiimage` |
+| 胜利面板图 | `successFeedbackPanel` | `aiimage` |
+| 关卡数据集 | `levelDataPack` | `aiconfig` |
+| App 文案 | `appMetadata` | `aiconfig` |
+
+---
+
+## Step 3：DAG 拓扑排序
+
+从 `basicAtomSkillGraph`（位于 `packages/common/src/recommend/atom-graph/basic-atom-skill-graph.ts`）读取图结构，按 `requires` 边做拓扑排序，确定生成顺序：**入度为 0 的节点优先生成**。
+
+**典型路径消除游戏的拓扑顺序**：
+
+```
+1. phaser.aicomponent              (引擎，入度=0)
+2. playable_scripts_build.aicomponent (构建管线，入度=0)
+3. responsive_2d_layout.aicomponent   (布局数学 Canon，入度=0)
+3b. playable_hud_layout / playable_end_screen_layout / playable_guidance_layer（屏幕分区规范，可与 3 并行阅读，无代码）
+4. phaser_scene_lifecycle.aicomponent (场景架构，depends: phaser)
+5. grid_board_layout.aicomponent      (棋盘布局，depends: phaser)
+6. path_elimination_rules.aigameplay  (玩法，depends: phaser)
+7. arrow_path_data_format.aicomponent (数据格式，depends: gameplay)
+8. game_scene.aicomponent             (主场景，depends: 上游多个)
+9. preloader_scene.aicomponent        (预加载，depends: phaser)
+10. [UI 组件层，互相独立，并行生成]
+11. [资源层 aiimage/aiaudio，弱依赖容器，并行生成]
+12. [配置层 aiconfig，独立]
+```
+
+**规则**：
+- `requires` 边是硬约束，必须按序
+- `compatibleWith`、`semanticallyRelatedTo`、`alternativeTo` 边不影响顺序，只影响候选选择
+
+---
+
+## Step 4：计算三信号权重
+
+对每个 Atom 候选，计算 `final_score`，确定最终选哪个：
+
+```
+final_score = α × relevance_score + β × prior_score
+```
+
+### 4.1 查先验分
+
+**调用**：`GET /api/agent/tools/prior-weight?atomId=bg_music.aiaudio`
+
+```json
+// Response
+{ "atomId": "bg_music.aiaudio", "priorScore": 0.6, "isMock": true }
+```
+
+`isMock: true` 时，prior_score 来自 mock JSON，不是真实 CTR 数据。
+
+### 4.2 计算相关分（LLM 判断）
+
+对每个候选 Atom，用 LLM 判断其与 IntentTags 的语义关联（0~1）：
+
+```
+示例：用户意图画风=[热带, 自然]
+  bg_music.aiaudio   → LLM："热带轻松风格" → 相关分 0.65
+  calm_piano.aiaudio → LLM："钢琴冥想" → 相关分 0.3
+  energetic_electronic.aiaudio → LLM："电子" → 相关分 0.2
+```
+
+### 4.3 合成
+
+```
+在乎维度（画风、节奏、玩法）: α=0.8, β=0.2
+不在乎维度（音乐、难度）:     α=0.2, β=0.8
+锁定维度:                    直接取用户指定值，跳过合成
+
+示例（背景音乐，不在乎维度，α=0.2, β=0.8）:
+  bg_music.aiaudio:         0.2×0.65 + 0.8×0.6 = 0.61 ← 最高
+  calm_piano.aiaudio:       0.2×0.3  + 0.8×0.5 = 0.46
+  energetic_electronic:     0.2×0.2  + 0.8×0.5 = 0.44
+```
+
+**Phase 3 MVP 说明**：由于 `parse_intent` 返回空 IntentTags，`caredDimensions` 为空，所有维度均为"不在乎"，α=0.2, β=0.8，先验权重主导选择。
+
+---
+
+## Step 5：分歧度判断
+
+| 状态 | 条件 | Agent 行为 |
+|------|------|-----------|
+| **高一致** | 三信号 Top-1 一致，或不一致的来自"不在乎"维度 | 自主执行，不打扰用户 |
+| **中分歧** | 最终分与相关分一致但与先验分不一致，且用户在乎该维度 | 呈报冲突："数据说 X 好，但你倾向 Y，按哪个走？" |
+| **高分歧** | 三信号各异，或在乎维度上信号互相矛盾 | 主动补问，列出 2-3 个方向让用户选 |
+
+用户每次选择 = 最干净的信用分配信号，记录为偏好。
+
+---
+
+## Step 6：按拓扑序执行各 Atom Skill
+
+对 Step 3 排好序的每个 Atom，读取其 `SKILL.md` 并执行：
+
+1. 对 **aicomponent** Skill：根据 `scaffold.files` 把 `ref/` 下的文件写入 Remix 沙箱项目目录。
+2. 对 **aiimage** Skill：按 `generation.prompt` 调用 AI 图像生成管线，产出图片并写入 `assets/`。
+3. 对 **aiaudio** Skill：若目录下有 `ref/*.mp3`，直接复制；否则调用 AI 音频生成。
+4. 对 **aiconfig** Skill：按 `generation.params` 写入配置 JSON。
+5. 对 **aigameplay** Skill：直写 PGS JSON，运行 testCases 验证，迭代直到通过。
+
+**写入路径**：所有文件相对于 Remix 沙箱的 `/project` 根目录。写完后调用 `SandboxNotifyService.notifyChange(...)` 触发前端刷新。
+
+---
+
+## Step 7：触发构建
+
+所有封包写入分支后，调用现有构建 API 触发 `@playcraft/build`，产出可交付的 Playable（HTML+JS 单文件）。
+
+---
+
+## 快速参考：当前 MVP 能力边界
+
+| 功能 | 状态 | 说明 |
+|------|------|------|
+| `search_skills` | ✅ 可用 | 读文件系统，过滤 Skill 候选 |
+| `prior_weight` | ✅ 可用（mock） | mock JSON，isMock=true，先验分仅供参考 |
+| `parse_intent` | ⚠️ Mock | 全部返回 null，退化为双信号，`TODO(P3.intent)` |
+| 分歧度判断 | ✅ 可用 | 规则计算，不依赖服务 |
+| AtomInstance 持久化 | ❌ 未做 | Phase 5 |
+| Skill Inspector（一致性） | ❌ 未做 | Phase 4 |
+| 自动构建触发 | ❌ 未做 | Phase 4 |
+
+---
+
+## 错误处理原则
+
+- **Atom 生成失败**：回退到 Phase 2（使用现有封包），不中断整个流程
+- **`search_skills` 返回空**：扩大过滤条件重试，或向用户报告无候选
+- **预算耗尽**：触发 HITL，由用户决定追加还是终止（见 `docs/agent/agent-human-in-the-loop-design.md`）
+- **`parse_intent` 返回空 IntentTags**（mock 状态）：降级为双信号，记录 warning

package/skills/agent_remix_orchestrator.aicomponent/manifest.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "atomId": "agent_remix_orchestrator.aicomponent",
+  "bundleType": "aicomponent",
+  "category": "util",
+  "mode": "fixed",
+  "label": { "zh": "Remix 编排器指南", "en": "Remix Orchestrator Guide" },
+  "tags": ["orchestrator", "l0-manager", "agent-workflow", "remix-assembly", "decision-making"],
+  "files": {
+    "skill": "SKILL.md"
+  }
+}