evomeme-dev 0.1.7

package/skills/game-asset-image-generator/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: game-asset-image-generator
+description: 指导 Agent 正确使用 MCP 提供的各类游戏素材生成与编辑工具。凡涉及生成或编辑游戏概念图和游戏素材（包括图片、模型、视频等），都必须先调用本技能，并确保最终产物按规范保存到当前工作区的 assets/ 目录。
+---
+
+# 游戏素材生成
+
+## 工作区素材准则
+
+必须遵守以下规则：
+
+1. 所有 AI 生成的图片和视频都必须保存到当前工作区根目录的 `assets/` 文件夹。不得只保留远程 URL；即使运行时不直接读取本地文件，`assets/` 中仍必须存在对应素材文件。
+2. evomeme平台游戏使用的所有素材都必须把 TOS URL 写入项目配置（通常为 `public/config.json`）。游戏代码必须通过配置项读取素材 URL，禁止从 `assets/` 导入、读取或拼接素材路径。
+
+调用素材工具时，始终把当前工作区根目录的绝对路径传给 `workspace_dir`，确保工具把返回文件保存到正确的 `assets/` 文件夹。
+
+## 素材工具
+
+当前提供两个素材工具：
+
+- `evomeme_generate_game_image`：根据文本提示生成图片。
+- `evomeme_cutout_game_image`：对已有图片做透明背景抠图。
+
+两个工具都会提交异步任务并自行轮询，直到任务成功或失败。成功后，工具会下载最终 TOS 图片到 `<workspace_dir>/assets/`，同时返回文本元数据和 MCP `image` 多模态内容块。
+
+## 并行调用
+
+生成多项素材时，尽可能通过异步 MCP 调用并行发起互不依赖的任务，不要逐项等待一个任务完成后才调用下一个。并行前为每项素材固定提示词、参数和标识；每个调用都显式传入相同的正确 `workspace_dir`，结果返回后依据任务与素材的对应关系分别记录 `job_id`、TOS URL 和本地文件。
+
+存在输出依赖的步骤必须保持顺序，例如抠图必须等待待处理图片生成完成，后一张图片必须引用前一张结果时也要先取得有效 URL。并行只用于依赖关系允许同时执行的任务；单个 MCP 工具内部的轮询等待不应阻塞其他独立素材任务的发起。
+
+## `evomeme_generate_game_image`
+
+根据提示词生成游戏图片。
+
+生成小石头、独立云朵、固定姿态敌人等无需动画或动态特效的单个静态游戏元素时，使用 `image_type=asset`，并且必须先读取并遵循 [静态游戏元素提示词指南](references/static-game-assets.md)。如果存在游戏概念图或当前元素的设定概念图，必须按该指南将概念图作为 `reference_image_url` 使用。该指南不适用于背景、视差层、tileset、动画、特效、视频或模型。
+
+生成铺满游戏画面的完整单层背景时，使用 `image_type=background`，并且必须先读取并遵循 [游戏背景提示词指南](references/background.md)。如果存在游戏概念图或当前场景的设定概念图，必须按该指南将概念图作为 `reference_image_url` 使用。
+
+### 入参
+
+| 参数 | 必填 | 类型/可选值 | 说明 |
+| --- | --- | --- | --- |
+| `prompt` | 是 | `string` | 生图提示词。 |
+| `image_type` | 否 | `asset`、`background`、`parallax background`、`tileset` | 图片类型，默认 `background`。`asset`、`parallax background`、`tileset` 会自动抠图。 |
+| `size` | 否 | `2048x2048`、`1728x2304`、`2304x1728`、`2560x1440`、`1440x2560`、`1664x2496`、`2496x1664`、`3024x1296` | 输出尺寸，默认 `2048x2048`。 |
+| `reference_image_url` | 否 | `string` | 参考图片的可访问 URL。 |
+| `image_model` | 否 | `asset-lite`、`asset-pro` | 生图模型，默认 `asset-lite`。 |
+| `workspace_dir` | 否 | `string` | Agent 当前工作区根目录的绝对路径。为满足素材准则，调用时必须显式传入。 |
+
+### 出参
+
+成功结果的 `content` 包含：
+
+1. `content[0]`：文本元数据，包括：
+   - `job_id`：异步任务 ID。
+   - `tos_url`：最终图片的 TOS URL。
+   - `asset_url`：与 `tos_url` 相同，便于兼容已有配置逻辑。
+   - `status`：终态，成功时为 `SUCCEEDED`。
+   - `attempts`：已执行次数与最大尝试次数。
+   - `size`：服务端确认的图片尺寸。
+   - `image_type`：服务端确认的图片类型。
+   - `has_transparent_background`：是否具有透明背景。
+   - `local_path`：下载到当前工作区 `assets/` 的本地绝对路径。
+   - `multimodal_base64`：Base64 所在内容块及字符数说明。
+   - `mime_type`：图片 MIME 类型。
+2. `content[1]`：MCP 多模态图片内容块：
+   - `type: "image"`
+   - `data`：不带 Data URL 前缀的 Base64 图片数据。
+   - `mimeType`：图片 MIME 类型。
+
+本地文件名取最终 TOS URL 路径的最后一段，并清理操作系统不允许的字符。失败时结果带 `isError: true`，文本内容为失败或超时信息。
+
+## `evomeme_cutout_game_image`
+
+把已有图片处理为透明背景图片。
+
+### 入参
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `image_url` | 是 | `string` | 待抠图原图的可访问 URL。 |
+| `workspace_dir` | 否 | `string` | Agent 当前工作区根目录的绝对路径。为满足素材准则，调用时必须显式传入。 |
+
+### 出参
+
+成功结果的 `content` 包含：
+
+1. `content[0]`：文本元数据，包括：
+   - `job_id`：异步任务 ID。
+   - `tos_url`：最终抠图结果的 TOS URL。
+   - `asset_url`：与 `tos_url` 相同，便于兼容已有配置逻辑。
+   - `status`：终态，成功时为 `SUCCEEDED`。
+   - `attempts`：已执行次数与最大尝试次数。
+   - `has_transparent_background`：透明背景标记，成功结果通常为 `true`。
+   - `local_path`：下载到当前工作区 `assets/` 的本地绝对路径。
+   - `multimodal_base64`：Base64 所在内容块及字符数说明。
+   - `mime_type`：图片 MIME 类型。
+2. `content[1]`：MCP 多模态图片内容块：
+   - `type: "image"`
+   - `data`：不带 Data URL 前缀的 Base64 图片数据。
+   - `mimeType`：图片 MIME 类型。
+
+本地文件名取最终 TOS URL 路径的最后一段，并清理操作系统不允许的字符。失败时结果带 `isError: true`，文本内容为失败或超时信息。

package/skills/game-asset-image-generator/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Game Asset Image Generator"
+  short_description: "生成并处理游戏图片素材，将结果保存到工作区并接入项目配置"
+  default_prompt: "请使用 $game-asset-image-generator 为我的游戏生成或处理所需图片素材，并将文件与素材链接正确接入项目。"
+
+policy:
+  allow_implicit_invocation: true

package/skills/game-asset-image-generator/references/background.md

@@ -0,0 +1,32 @@
+# 游戏背景提示词指南
+
+游戏背景是铺满游戏画面的完整单层场景图片，例如森林、城市街道、太空区域、地下洞穴或室内空间。每张背景只生成一次，并作为单独的 `background` 图片使用。
+
+## 使用概念图作为引用
+
+如果存在游戏概念图或当前场景的设定概念图，必须将概念图的可访问 URL 作为 `reference_image_url`：
+
+- 优先使用当前场景的设定概念图；没有时再使用整体游戏概念图。
+- 在提示词中明确需要继承的特征，例如世界观、场景结构、配色、材质、光照和画风。
+- 不要复制概念图中的排版、文字、标注、角色展示或其他无关内容。
+
+## 提示词
+
+编写时遵守：
+
+- 写清背景在游戏中的用途、场景地点、时代或主题。
+- 写清横屏或竖屏构图、摄像机视角、地平线位置和主要空间方向。
+- 写清时间、天气、光照、主色调和主要材质，并与已有游戏美术规范保持一致。
+- 根据玩法说明需要保持清晰、低干扰的区域，例如中央移动区、道路、平台区域或角色活动区。
+- 将高细节和视觉重心放在不会遮挡玩法信息的位置，避免整张图细节密度一致。
+- 保持空间层次、透视、光向和尺度统一，使背景能够直接铺满游戏画面。
+- 要求 `full-frame composition, edge-to-edge scene, no border`，不要生成白底、透明底、画框或展示样机。
+- 结尾包含 `no characters, no enemies, no pickups, no UI, no text, no watermark, no logo`。
+
+## 禁止写法
+
+- 把角色、敌人、道具、拾取物、攻击特效或可交互对象画进背景。
+- 把 HUD、按钮、标题、分数、教程文字、Logo 或水印画进背景。
+- 只描述氛围而不说明具体场景、视角、构图方向和玩法留白。
+- 要求独立元素、透明底、纯白底、素材合集、设定表或多视图。
+- 使用与游戏概念图或既有美术规范冲突的画风、配色、材质和光照。

package/skills/game-asset-image-generator/references/static-game-assets.md

@@ -0,0 +1,38 @@
+# 静态游戏元素提示词指南
+
+静态游戏元素是可由一张独立图片直接表现、无需动画帧或动态特效的单个游戏元素，例如小石头、独立云朵、灌木、路牌，以及只使用固定姿态的敌人。每个静态元素只生成一次，并作为单独的 `asset` 图片使用。
+
+本指南不适用于：
+
+- 完整场景背景、视差背景层或 tileset。
+- 需要行走、攻击、受击等动画帧的角色或敌人。
+- 火焰、爆炸、拖尾等动态特效。
+- 游戏概念图、角色设定图、UI、视频或 3D 模型。
+
+## 使用概念图作为引用
+
+如果存在游戏概念图或当前元素的设定概念图，必须将概念图的可访问 URL 作为 `reference_image_url`：
+
+- 优先使用当前元素的设定概念图；没有时再使用整体游戏概念图。
+- 在提示词中明确需要继承的特征，例如元素造型、轮廓、配色、材质和画风。
+- 不要复制概念图中的排版、文字、标注、多视图或其他无关元素。
+
+## 提示词
+
+编写时遵守：
+
+- 一张图只描述一个静态元素，不得要求合集、多个变体或多视图。
+- 写清元素在游戏中的作用，例如障碍物、固定敌人或环境装饰。
+- 有方向性的元素必须指定唯一朝向；无方向性的元素指定正视图、侧视图或俯视图。
+- 固定敌人只描述一个可直接使用的姿态。
+- 只保留一至三个关键识别特征，确保缩小后仍有清晰轮廓。
+- 要求主体居中、完整显示、四周留白、边缘不裁切。
+- 使用 `pure white background, no ground, no cast shadow, clean edges`，便于自动抠图。
+- 结尾包含 `no text, no watermark, no logo, no UI, no extra objects`。
+
+## 禁止写法
+
+- `background scene`、`parallax layer`、`tileset`。
+- `character sheet`、`multiple views`、`sprite sheet`、`animation frames`、`turnaround sheet`。
+- 多个元素、多个姿态、多个方向或多个皮肤同时出现在一张图中。
+- 场景叙事、地面、天空、环境光效或其他会妨碍独立抠图的内容。

package/skills/game-audio/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: game-audio
+description: 将已托管的 BGM / SFX 接入 Phaser / Three.js 运行时配置。在游戏需要可用的 CDN 音频 URL、配置绑定或加载器接入，且不在本地生成音频时使用。
+---
+
+# 游戏音频
+
+## 概述
+
+将此技能用于已托管在 CDN 或对象存储中的游戏音频。按参考文档中的约定将对象键拼成可加载的 HTTPS URL，并写入 `public/config.json` 或运行时加载器。
+
+**不生成新音频**。如果所需音频对象在 CDN 中不存在且用户未提供 URL，停止并请用户确认对象键或更新参考清单，不得编造路径。
+
+## 何时使用此技能
+
+- 设计文档、配置文件或用户指定了某首 BGM 或 SFX 的文件名/键，需要给出可加载 URL
+- 填写 `bgm_main`、`audio_bgm_gameplay`、`audio_sfx_click`、`backgroundMusic`、`src`、`url` 等音频字段
+- 用户明确说音频来自公司 CDN、对象存储或固定托管 URL
+- 接入点击音、拾取音、碰撞音、射击音、爆炸音、成功/失败音等游戏反馈音效
+
+---
+
+## 阅读顺序
+
+1. 读完本节后，根据任务类型选择并**打开对应参考文档**，不得在未读参考的情况下拼接 URL
+2. **BGM（循环背景音乐）**：`references/bgm-cdn.md`
+3. **SFX（短促触发音效）**：`references/sfx-cdn.md`
+4. 同时涉及 BGM 和 SFX 时，读取两个参考
+
+---
+
+## BGM 路由
+
+- 加载 BGM 参考文档，从中提取 CDN 根、路径前缀和曲目清单
+- 用于循环背景音乐，对应配置键如 `bgm_main`、`audio_bgm_gameplay`、`audio_bgm_menu`、`backgroundMusic`
+- 曲目不在清单中时，不得编造路径；请用户确认对象键后再配置
+
+推荐技能：`game-audio`；BGM 参考 `references/bgm-cdn.md`。
+
+## SFX 路由
+
+- 加载 `references/sfx-cdn.md`，提取 CDN 根和文件名规则
+- 用于短促触发音效，对应配置键如 `audio_sfx_click`、`audio_sfx_pickup`、`audio_sfx_impact`、`audio_sfx_shoot`、`audio_sfx_explosion`、`audio_sfx_success`、`audio_sfx_fail`
+- 高频触发音效（脚步、拖动、持续碰撞）作为节流或循环播放处理，不逐帧重触发
+
+推荐技能：`game-audio`；SFX 参考 `references/sfx-cdn.md`。
+
+---
+
+## 工作流
+
+1. 确认任务类型：BGM、SFX 或两者
+2. 读取对应参考文档，提取 CDN 根、必需前缀和文件名规则
+3. 从用户、策划案、配置表或参考清单中找到确切的对象键
+4. 拼出完整 HTTPS URL（使用参考中的 CDN 根和前缀，不额外编码整个 URL）
+5. 将 URL 写入对应配置键、清单或运行时加载代码，保留项目现有音频架构
+6. 验证控制标志：BGM 遵守 `audio_music_enabled`，SFX 遵守 `audio_sfx_enabled`；游戏内循环不泄漏到菜单或结算页
+
+### 写入 2D 项目配置（`public/config.json`）
+
+```json
+"bgm_main":   { "value": "https://...", "type": "audio", "label": "背景音乐" },
+"sfx_jump":   { "value": "https://...", "type": "audio", "label": "跳跃音效" }
+```
+
+### 写入 3D 项目配置
+
+按项目现有配置结构写入，config 键名遵循 `audio_bgm_*` / `audio_sfx_*` 命名规范。
+
+---
+
+## 护栏
+
+- 不编造文件名、CDN 域名、目录前缀或百分比编码片段
+- 不静默替换 BGM 和 SFX 的根路径
+- 不以生成音频为由加载已移除的本地音频生成技能
+- 对象键缺失或用户未提供完整 URL 时，停止并要求用户提供或更新参考，不猜测
+
+## References
+
+- BGM CDN 清单：`references/bgm-cdn.md`
+- SFX CDN 清单：`references/sfx-cdn.md`

package/skills/game-audio/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Game Audio"
+  short_description: "从已托管资源中选择背景音乐和音效，并接入游戏配置与播放流程"
+  default_prompt: "请使用 $game-audio 为我的游戏选择合适的已托管背景音乐和音效，并接入现有配置与播放流程。"

package/skills/game-audio/references/bgm-cdn.md

@@ -0,0 +1,127 @@
+# BGM CDN And URL Catalog
+
+This file is the authoritative source for hosted background-music routing. Read `../SKILL.md` first, then use this reference to compose final HTTPS URLs for tracks stored under the BGM bucket path.
+
+## CDN Roots
+
+Primary public CDN root:
+
+```text
+https://vibe-writing-dev-public.tos-cn-beijing.volces.com/
+```
+
+Secondary root that may be used only when the user explicitly provides a full URL or confirms that a track lives there:
+
+```text
+https://ppy-test.tos-cn-beijing.volces.com/
+```
+
+## Required Prefix
+
+All hosted background music objects live under:
+
+```text
+bgm/
+```
+
+## Final URL Shape
+
+```text
+{CDN root}bgm/{encoded filename}
+```
+
+- Keep the CDN root exactly as listed.
+- Keep the `bgm/` prefix exactly as listed.
+- The filename segment includes the extension such as `.mp3` or `.m4a`.
+- Encode the filename segment with UTF-8 percent-encoding when it contains non-ASCII or reserved characters.
+
+## Encoding Rule
+
+- Use the full stored filename, including extension, as the source string for `encodeURIComponent`.
+- Encode only the filename segment, not the entire URL.
+- Keep spaces encoded as `%20`.
+- Common examples:
+  - `–` -> `%E2%80%93`
+  - `（` -> `%EF%BC%88`
+  - `）` -> `%EF%BC%89`
+
+## Track Catalog
+
+Final URL = `https://vibe-writing-dev-public.tos-cn-beijing.volces.com/bgm/` + filename fragment below unless the user explicitly confirms the secondary CDN root.
+
+| Object key | Filename fragment |
+| --- | --- |
+| `2048.mp3` | `2048.mp3` |
+| `Arrows – Puzzle Escape（箭头逃脱）.mp3` | `Arrows%20%E2%80%93%20Puzzle%20Escape%EF%BC%88%E7%AE%AD%E5%A4%B4%E9%80%83%E8%84%B1%EF%BC%89.mp3` |
+| `Ballz 打砖块.mp3` | `Ballz%20%E6%89%93%E7%A0%96%E5%9D%97.mp3` |
+| `Block Blast! 方块消除1.mp3` | `Block%20Blast%21%20%E6%96%B9%E5%9D%97%E6%B6%88%E9%99%A41.mp3` |
+| `Block Blast! 方块消除2.mp3` | `Block%20Blast%21%20%E6%96%B9%E5%9D%97%E6%B6%88%E9%99%A42.mp3` |
+| `DOODLE JUMP2.mp3` | `DOODLE%20JUMP2.mp3` |
+| `Doodle Jump.mp3` | `Doodle%20Jump.mp3` |
+| `Flappy Bird1.mp3` | `Flappy%20Bird1.mp3` |
+| `Flappy Bird2.mp3` | `Flappy%20Bird2.mp3` |
+| `Vita Mahjong 麻将配对1.mp3` | `Vita%20Mahjong%20%E9%BA%BB%E5%B0%86%E9%85%8D%E5%AF%B91.mp3` |
+| `Vita Mahjong 麻将配对2.mp3` | `Vita%20Mahjong%20%E9%BA%BB%E5%B0%86%E9%85%8D%E5%AF%B92.mp3` |
+| `_疯狂的鸽子1.mp3` | `_%E7%96%AF%E7%8B%82%E7%9A%84%E9%B8%BD%E5%AD%901.mp3` |
+| `_疯狂的鸽子2.mp3` | `_%E7%96%AF%E7%8B%82%E7%9A%84%E9%B8%BD%E5%AD%902.mp3` |
+| `三消 _ 二合1.mp3` | `%E4%B8%89%E6%B6%88%20_%20%E4%BA%8C%E5%90%881.mp3` |
+| `三消 _ 二合2.mp3` | `%E4%B8%89%E6%B6%88%20_%20%E4%BA%8C%E5%90%882.mp3` |
+| `人格测试.mp3` | `%E4%BA%BA%E6%A0%BC%E6%B5%8B%E8%AF%95.mp3` |
+| `休闲小镇.mp3` | `%E4%BC%91%E9%97%B2%E5%B0%8F%E9%95%87.mp3` |
+| `休闲轻快.mp3` | `%E4%BC%91%E9%97%B2%E8%BD%BB%E5%BF%AB.mp3` |
+| `休闲拼图1.mp3` | `%E4%BC%91%E9%97%B2%E6%8B%BC%E5%9B%BE1.mp3` |
+| `休闲拼图2.mp3` | `%E4%BC%91%E9%97%B2%E6%8B%BC%E5%9B%BE2.mp3` |
+| `冰壶游戏.mp3` | `%E5%86%B0%E5%A3%B6%E6%B8%B8%E6%88%8F.mp3` |
+| `割绳子（Cut the Rope）1.mp3` | `%E5%89%B2%E7%BB%B3%E5%AD%90%EF%BC%88Cut%20the%20Rope%EF%BC%891.mp3` |
+| `割绳子（Cut the Rope）2.mp3` | `%E5%89%B2%E7%BB%B3%E5%AD%90%EF%BC%88Cut%20the%20Rope%EF%BC%892.mp3` |
+| `割草游戏1.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F1.mp3` |
+| `割草游戏2.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F2.mp3` |
+| `割草游戏3.mp3` | `%E5%89%B2%E8%8D%89%E6%B8%B8%E6%88%8F3.mp3` |
+| `华容道 _ 拼图1.mp3` | `%E5%8D%8E%E5%AE%B9%E9%81%93%20_%20%E6%8B%BC%E5%9B%BE1.mp3` |
+| `华容道 _ 拼图_2.mp3` | `%E5%8D%8E%E5%AE%B9%E9%81%93%20_%20%E6%8B%BC%E5%9B%BE_2.mp3` |
+| `发泄暴打.mp3` | `%E5%8F%91%E6%B3%84%E6%9A%B4%E6%89%93.mp3` |
+| `叠房子.mp3` | `%E5%8F%A0%E6%88%BF%E5%AD%90.mp3` |
+| `吃分避障.mp3` | `%E5%90%83%E5%88%86%E9%81%BF%E9%9A%9C.mp3` |
+| `合成大西瓜1.mp3` | `%E5%90%88%E6%88%90%E5%A4%A7%E8%A5%BF%E7%93%9C1.mp3` |
+| `合成大西瓜2.mp3` | `%E5%90%88%E6%88%90%E5%A4%A7%E8%A5%BF%E7%93%9C2.mp3` |
+| `哈吉米南北绿豆.mp3` | `%E5%93%88%E5%9F%BA%E7%B1%B3%E5%8D%97%E5%8C%97%E7%BB%BF%E8%B1%86.mp3` |
+| `场景模拟对话1.mp3` | `%E5%9C%BA%E6%99%AF%E6%A8%A1%E6%8B%9F%E5%AF%B9%E8%AF%9D1.mp3` |
+| `场景模拟对话2.mp3` | `%E5%9C%BA%E6%99%AF%E6%A8%A1%E6%8B%9F%E5%AF%B9%E8%AF%9D2.mp3` |
+| `塔防.mp3` | `%E5%A1%94%E9%98%B2.mp3` |
+| `对抗类.mp3` | `%E5%AF%B9%E6%8A%97%E7%B1%BB.mp3` |
+| `奇幻冒险.m4a` | `%E5%A5%87%E5%B9%BB%E5%86%92%E9%99%A9.m4a` |
+| `愤怒的小鸟.mp3` | `%E6%84%A4%E6%80%92%E7%9A%84%E5%B0%8F%E9%B8%9F.mp3` |
+| `战斗.mp3` | `%E6%88%98%E6%96%97.mp3` |
+| `打地鼠.mp3` | `%E6%89%93%E5%9C%B0%E9%BC%A0.mp3` |
+| `搞笑.mp3` | `%E6%90%9E%E7%AC%91.mp3` |
+| `拧螺丝1.mp3` | `%E6%8B%A7%E8%9E%BA%E4%B8%9D1.mp3` |
+| `拧螺丝2.mp3` | `%E6%8B%A7%E8%9E%BA%E4%B8%9D2.mp3` |
+| `数值生存.mp3` | `%E6%95%B0%E5%80%BC%E7%94%9F%E5%AD%98.mp3` |
+| `数字门跑酷1.mp3` | `%E6%95%B0%E5%AD%97%E9%97%A8%E8%B7%91%E9%85%B71.mp3` |
+| `数字门跑酷2.mp3` | `%E6%95%B0%E5%AD%97%E9%97%A8%E8%B7%91%E9%85%B72.mp3` |
+| `是男人就下 100 层.mp3` | `%E6%98%AF%E7%94%B7%E4%BA%BA%E5%B0%B1%E4%B8%8B%20100%20%E5%B1%82.mp3` |
+| `是男人就下100层2.mp3` | `%E6%98%AF%E7%94%B7%E4%BA%BA%E5%B0%B1%E4%B8%8B100%E5%B1%822.mp3` |
+| `校准类.mp3` | `%E6%A0%A1%E5%87%86%E7%B1%BB.mp3` |
+| `横板过关.mp3` | `%E6%A8%AA%E6%9D%BF%E8%BF%87%E5%85%B3.mp3` |
+| `沙盒模拟类1.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB1.mp3` |
+| `沙盒模拟类2.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB2.mp3` |
+| `沙盒模拟类3.mp3` | `%E6%B2%99%E7%9B%92%E6%A8%A1%E6%8B%9F%E7%B1%BB3.mp3` |
+| `祖玛1.mp3` | `%E7%A5%96%E7%8E%9B1.mp3` |
+| `祖玛2.mp3` | `%E7%A5%96%E7%8E%9B2.mp3` |
+| `经营养成.mp3` | `%E7%BB%8F%E8%90%A5%E5%85%BB%E6%88%90.mp3` |
+| `经营养成2.mp3` | `%E7%BB%8F%E8%90%A5%E5%85%BB%E6%88%902.mp3` |
+| `背包堆叠（Stack_Backpack）.mp3` | `%E8%83%8C%E5%8C%85%E5%A0%86%E5%8F%A0%EF%BC%88Stack_Backpack%EF%BC%89.mp3` |
+| `节奏类（音游点击）.mp3` | `%E8%8A%82%E5%A5%8F%E7%B1%BB%EF%BC%88%E9%9F%B3%E6%B8%B8%E7%82%B9%E5%87%BB%EF%BC%89.mp3` |
+| `解绳游戏（Tangled Rope）1.mp3` | `%E8%A7%A3%E7%BB%B3%E6%B8%B8%E6%88%8F%EF%BC%88Tangled%20Rope%EF%BC%891.mp3` |
+| `解绳游戏（Tangled Rope）2.mp3` | `%E8%A7%A3%E7%BB%B3%E6%B8%B8%E6%88%8F%EF%BC%88Tangled%20Rope%EF%BC%892.mp3` |
+| `贪吃蛇.mp3` | `%E8%B4%AA%E5%90%83%E8%9B%87.mp3` |
+| `贪吃蛇2.mp3` | `%E8%B4%AA%E5%90%83%E8%9B%872.mp3` |
+| `跑酷避障.mp3` | `%E8%B7%91%E9%85%B7%E9%81%BF%E9%9A%9C.mp3` |
+| `跳一跳.mp3` | `%E8%B7%B3%E4%B8%80%E8%B7%B3.mp3` |
+| `跳一跳2.mp3` | `%E8%B7%B3%E4%B8%80%E8%B7%B32.mp3` |
+| `连击挑战1.mp3` | `%E8%BF%9E%E5%87%BB%E6%8C%91%E6%88%981.mp3` |
+| `连击挑战2.mp3` | `%E8%BF%9E%E5%87%BB%E6%8C%91%E6%88%982.mp3` |
+| `鉴别伪人.mp3` | `%E9%89%B4%E5%88%AB%E4%BC%AA%E4%BA%BA.mp3` |
+| `雷霆战机.mp3` | `%E9%9B%B7%E9%9C%86%E6%88%98%E6%9C%BA.mp3` |
+| `鬼抓人.mp3` | `%E9%AC%BC%E6%8A%93%E4%BA%BA.mp3` |
+| `黑洞（Tiles In Hole_ Black Hole）.mp3` | `%E9%BB%91%E6%B4%9E%EF%BC%88Tiles%20In%20Hole_%20Black%20Hole%EF%BC%89.mp3` |

package/skills/game-audio/references/sfx-cdn.md

@@ -0,0 +1,77 @@
+# SFX CDN And URL Catalog
+
+This file is the authoritative source for hosted sound-effect routing. Read `../SKILL.md` first, then use this reference to compose final HTTPS URLs for short feedback audio stored under the SFX bucket path.
+
+This catalog is for audio feedback only. Do not use it for canvas particles, trails, sparks, or other visual VFX implementations.
+
+## CDN Root
+
+Public CDN root:
+
+```text
+https://ppy-test.tos-cn-beijing.volces.com/
+```
+
+## Required Prefix
+
+All hosted gameplay and UI sound effects live under:
+
+```text
+sfx/
+```
+
+## Final URL Shape
+
+```text
+{CDN root}sfx/{encoded filename}
+```
+
+- Keep the CDN root exactly as listed.
+- Keep the `sfx/` prefix exactly as listed.
+- The filename segment includes the extension such as `.mp3`, `.m4a`, `.ogg`, or `.mp4`.
+- Encode the filename segment with UTF-8 percent-encoding when required.
+
+## Encoding Rule
+
+- Use the full stored filename, including extension, as the source string for `encodeURIComponent`.
+- Encode only the filename segment, not the full URL.
+- Keep spaces encoded as `%20`.
+
+## Sound Catalog
+
+Final URL = `https://ppy-test.tos-cn-beijing.volces.com/sfx/` + filename fragment below.
+
+| Object key | Filename fragment |
+| --- | --- |
+| `RUA.mp3` | `RUA.mp3` |
+| `人物冲刺.mp3` | `%E4%BA%BA%E7%89%A9%E5%86%B2%E5%88%BA.mp3` |
+| `人物叫声.mp3` | `%E4%BA%BA%E7%89%A9%E5%8F%AB%E5%A3%B0.mp3` |
+| `人物碰撞.m4a` | `%E4%BA%BA%E7%89%A9%E7%A2%B0%E6%92%9E.m4a` |
+| `人物脚步声.mp3` | `%E4%BA%BA%E7%89%A9%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `僵尸叫声.ogg` | `%E5%83%B5%E5%B0%B8%E5%8F%AB%E5%A3%B0.ogg` |
+| `僵尸死亡.mp3` | `%E5%83%B5%E5%B0%B8%E6%AD%BB%E4%BA%A1.mp3` |
+| `动物脚步声.mp3` | `%E5%8A%A8%E7%89%A9%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `吃金币.mp3` | `%E5%90%83%E9%87%91%E5%B8%81.mp3` |
+| `呼噜.mp3` | `%E5%91%BC%E5%99%9C.mp3` |
+| `壮汉死亡倒地.mp3` | `%E5%A3%AE%E6%B1%89%E6%AD%BB%E4%BA%A1%E5%80%92%E5%9C%B0.mp3` |
+| `失误.mp3` | `%E5%A4%B1%E8%AF%AF.mp3` |
+| `射击-轻.mp3` | `%E5%B0%84%E5%87%BB-%E8%BD%BB.mp3` |
+| `射击-重.mp3` | `%E5%B0%84%E5%87%BB-%E9%87%8D.mp3` |
+| `成功.mp3` | `%E6%88%90%E5%8A%9F.mp3` |
+| `我想上班.mp3` | `%E6%88%91%E6%83%B3%E4%B8%8A%E7%8F%AD.mp3` |
+| `拖拽.mp3` | `%E6%8B%96%E6%8B%BD.mp3` |
+| `拾取.mp3` | `%E6%8B%BE%E5%8F%96.mp3` |
+| `放置.mp3` | `%E6%94%BE%E7%BD%AE.mp3` |
+| `旋转.mp4` | `%E6%97%8B%E8%BD%AC.mp4` |
+| `汽车行驶.mp3` | `%E6%B1%BD%E8%BD%A6%E8%A1%8C%E9%A9%B6.mp3` |
+| `游戏失败.mp3` | `%E6%B8%B8%E6%88%8F%E5%A4%B1%E8%B4%A5.mp3` |
+| `点击.mp3` | `%E7%82%B9%E5%87%BB.mp3` |
+| `爆炸.mp3` | `%E7%88%86%E7%82%B8.mp3` |
+| `爽.mp3` | `%E7%88%BD.mp3` |
+| `猫叫.mp3` | `%E7%8C%AB%E5%8F%AB.mp3` |
+| `碰撞.mp3` | `%E7%A2%B0%E6%92%9E.mp3` |
+| `苏卡不列.mp3` | `%E8%8B%8F%E5%8D%A1%E4%B8%8D%E5%88%97.mp3` |
+| `苏卡不列那惠.mp3` | `%E8%8B%8F%E5%8D%A1%E4%B8%8D%E5%88%97%E9%82%A3%E6%83%A0.mp3` |
+| `谢谢啊.mp3` | `%E8%B0%A2%E8%B0%A2%E5%95%8A.mp3` |
+| `雪地上的脚步声.mp3` | `%E9%9B%AA%E5%9C%B0%E4%B8%8A%E7%9A%84%E8%84%9A%E6%AD%A5%E5%A3%B0.mp3` |
+| `飞行.mp3` | `%E9%A3%9E%E8%A1%8C.mp3` |

package/skills/game-demo/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: game-demo
+description: 在明确游戏引擎和技术栈后读取游戏策划案，以代码安全和首次交付成功为优先，搭建最简可运行 Demo 的文件框架、代码框架和核心系统。代码与图片生成同步推进，所有游戏图片素材必须使用生成图片，禁止 SVG、线条绘制或大面积纯色素材。当需要从零创建游戏 Demo、把策划案落实为首个可玩版本，或为后续开发建立基础工程时使用。
+---
+
+# Game Demo
+
+## Goal
+
+读取策划案，将核心玩法实现为可以启动、游玩、结束和重新开始的最简游戏 Demo，并为后续开发建立清晰的工程基础。
+
+本 Skill 独立完成工程搭建，主要产物是实际项目文件和一个可持续完善的可运行 Demo。所有游戏图片素材通过图片生成取得，并由统一的资源配置或加载层接入；首批生成素材允许在后续开发中逐渐替换为更高质量版本。
+
+## 开始前
+
+首先明确当前项目使用的游戏引擎和技术栈。
+
+对于已有工程，读取包清单、锁文件、构建配置、入口文件和主要依赖进行确认。对于新工程，由开发者确认技术选择。
+
+至少确认：
+
+- 游戏引擎及版本；
+- 编程语言；
+- 渲染与 UI 方案；
+- 构建工具和包管理器；
+- 目标平台、画幅和输入方式。
+
+随后读取项目根目录的 `/project.md` 或开发者指定的策划案文件，理解核心玩法、Demo 范围、游戏对象、操作方式、胜负条件和一局游戏的完整流程。
+
+## 首次交付原则
+
+Demo 的首次交付必须以成功启动和完整跑通核心循环为目标。只实现玩法成立所必需的最少对象、系统、状态和界面，让每个新增部分都直接服务于核心体验。
+
+代码安全性具有最高优先级。架构完整度、扩展能力、视觉表现、功能数量和技术复杂度都服从于首次交付的稳定性。采用当前技术栈中成熟、直接且容易排查的实现路径，保持依赖精简、模块职责清楚、状态流转明确，并为加载失败和运行时异常提供安全边界。
+
+## Demo 制作
+
+Demo 作为一个完整任务制作。开始开发后优先发起所需图片素材的生成，并同步搭建文件框架、代码框架和核心游戏系统。能够异步调用生图工具时，提交生成任务后继续代码工作，让两者并行推进。
+
+### 图片素材硬性要求
+
+- Demo 中禁止出现任何 SVG 素材，包括 SVG 文件、内联 SVG 和 `data:image/svg+xml`。
+- 禁止使用 Canvas/Phaser/CSS 的线条、几何轮廓或程序绘图冒充角色、场景、道具、图标、特效等游戏图片素材。
+- 禁止将大面积纯色块或纯色背景作为正式游戏素材或视觉占位。
+- 背景、角色、敌人、道具、地块、装饰、图标和视觉特效等所有需要的游戏图片素材，都必须通过图片生成获得并实际接入 Demo。
+- 代码开发与图片生成可以并行，但首次可视交付前必须接入所需的生成图片。素材未完成时继续生成或缩小 Demo 素材范围，不得以 SVG、线条绘制或大面积纯色占位替代。
+- 生成素材是可迭代的首版资产，后续可以在保持资源接口稳定的前提下逐渐替换，不需要等待最终美术品质才开始开发。
+
+Demo 跑通以下最简完整流程：
+
+```text
+启动 → 加载 → 开始 → 游玩 → 成功或失败 → 结算 → 重新开始
+```
+
+代码构建完成、核心循环可以运行且本轮所需生成图片已经接入后，启动静态服务并在环境中的浏览器打开 Demo 页面，由开发者直接操作和验收。首次展示不得包含 SVG、线条绘制或大面积纯色游戏素材。
+
+## Demo 构造
+
+### 文件框架
+
+根据游戏引擎和技术栈建立项目入口、源码、配置、游戏系统、实体、场景、输入、资源、UI 和构建产物等目录。让每个目录和关键文件具有明确职责。
+
+### 代码框架
+
+建立游戏启动、配置加载、资源加载、状态流转、输入映射、游戏循环、渲染同步、UI 通信、重新开始和资源释放等基础代码。
+
+将玩法状态、渲染表现、输入和 UI 分为清晰模块，并通过明确的数据、事件或接口连接。
+
+### 游戏系统
+
+根据策划案搭建核心循环实际需要的系统，例如玩家控制、敌人或障碍、生成、碰撞、伤害、计分、进度、时间、胜负、结算和暂停。
+
+只选择当前核心循环必需的系统，通过参数化内容和统一资源接口连接它们。所有图片资源均使用生成图片，并允许后续通过相同接口逐渐替换。
+
+## 验收
+
+Demo 采用开发者浏览器验收。Agent 不执行自动化玩法测试、端到端测试、视觉回归测试或其他 Agent 端自动化测试。代码完成构建并能够运行后，Agent 负责立即启动静态服务、打开浏览器并将操作权交给开发者；剩余图片在展示后继续生成和接入。
+
+交付开发者前确认：
+
+- 工程使用已确认的游戏引擎和技术栈；
+- 首次交付保持最简，并能够成功构建和启动；
+- 文件职责和模块边界清晰；
+- 核心游戏循环能够完整运行；
+- 输入、游戏状态、渲染和 UI 正确连接；
+- 成功、失败、结算和重新开始可以重复执行；
+- 新一局能够恢复正确的初始状态；
+- Demo 不包含 SVG、线条绘制或大面积纯色游戏素材及视觉占位；
+- 当前 Demo 所需的所有游戏图片素材均已通过图片生成获得、集中管理并实际接入；
+- 静态服务已经启动，Demo 页面已经在浏览器中打开。
+
+## Output
+
+实际项目文件和可运行构建是主要交付物。完成后简要说明：
+
+- 使用的游戏引擎与技术栈；
+- 建立的主要目录和代码模块；
+- 已搭建的游戏系统；
+- 生成图片素材的集中配置、接入位置与后续替换方式；
+- 图片素材的生成与接入状态；
+- 已跑通的核心游戏循环；
+- 执行的构建与静态服务命令；
+- 浏览器中的开发者验收地址。

package/skills/game-demo/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Game Demo"
+  short_description: "搭建安全、精简且可运行的游戏演示，并行完成代码与图片素材"
+  default_prompt: "请使用 $game-demo 根据策划案搭建一个可运行的游戏演示，同步推进生图与代码构建，为所有图片提供矢量替代图，并在代码可运行后立即打开网页供我验收。"
+
+policy:
+  allow_implicit_invocation: true