@mison/ag-kit-cn 2.0.1

package/.agent/skills/game-development/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: game-development
+description: 游戏开发编排器。根据项目需求路由到特定平台技能。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# 游戏开发
+
+> **编排类技能**：提供核心原则，并引导至专业子技能。
+
+---
+
+## 何时使用此技能
+
+当你在进行游戏开发项目时使用。本技能讲解游戏开发的**核心原则**，并根据上下文指引到合适的子技能。
+
+---
+
+## 子技能路由
+
+### 平台选择
+
+| 如果目标平台是... | 使用子技能 |
+| --- | --- |
+| Web 浏览器（HTML5, WebGL） | `game-development/web-games` |
+| 移动端（iOS, Android） | `game-development/mobile-games` |
+| PC（Steam, 桌面） | `game-development/pc-games` |
+| VR/AR 头显 | `game-development/vr-ar` |
+
+### 维度选择
+
+| 如果游戏是... | 使用子技能 |
+| --- | --- |
+| 2D（sprites, tilemaps） | `game-development/2d-games` |
+| 3D（meshes, shaders） | `game-development/3d-games` |
+
+### 专业领域
+
+| 如果你需要... | 使用子技能 |
+| --- | --- |
+| GDD、平衡性、玩家心理 | `game-development/game-design` |
+| 多人联机、网络同步 | `game-development/multiplayer` |
+| 视觉风格、素材管线、动画 | `game-development/game-art` |
+| 音效设计、音乐、自适应音频 | `game-development/game-audio` |
+
+---
+
+## 核心原则（全平台）
+
+### 1. 游戏循环
+
+不论平台，所有游戏都遵循这一模式：
+
+```
+INPUT  → 读取玩家操作
+UPDATE → 处理游戏逻辑（固定步长）
+RENDER → 绘制帧（插值）
+```
+
+**固定步长规则：**
+- 物理/逻辑：固定频率（例如 50Hz）
+- 渲染：尽可能快
+- 在不同状态间做插值以保证画面平滑
+
+---
+
+### 2. 模式选择矩阵
+
+| 模式 | 使用场景 | 示例 |
+| --- | --- | --- |
+| **状态机（State Machine）** | 3-5 个离散状态 | 玩家：Idle（待机）→Walk（行走）→Jump（跳跃） |
+| **对象池（Object Pooling）** | 频繁生成/销毁 | 子弹、粒子 |
+| **观察者/事件（Observer/Events）** | 跨系统通信 | 生命值→UI（界面）更新 |
+| **ECS（实体组件系统）** | 大量相似实体 | RTS（即时战略）单位、粒子 |
+| **命令（Command）** | 撤销、回放、联网同步 | 输入记录 |
+| **行为树（Behavior Tree）** | 复杂 AI（人工智能）决策 | 敌人 AI |
+
+**决策规则：** 先用状态机。只有在性能需要时再引入 ECS。
+
+---
+
+### 3. 输入抽象
+
+将输入抽象为动作（Actions），而不是原始按键：
+
+```
+"jump"  → Space、手柄 A、触摸点击
+"move"  → WASD、左摇杆、虚拟摇杆
+```
+
+**原因：** 便于多平台支持与可重绑控制。
+
+---
+
+### 4. 性能预算（60 FPS（帧率） = 16.67ms）
+
+| 系统 | 预算 |
+| --- | --- |
+| 输入 | 1ms |
+| 物理 | 3ms |
+| AI（人工智能） | 2ms |
+| 游戏逻辑 | 4ms |
+| 渲染 | 5ms |
+| 缓冲 | 1.67ms |
+
+**优化优先级：**
+1. 算法（O(n²) → O(n log n)）
+2. 批处理（减少 draw calls（绘制调用））
+3. 对象池（避免 GC（垃圾回收）峰值）
+4. LOD（细节层级，按距离调整细节）
+5. 裁剪（跳过不可见）
+
+---
+
+### 5. AI 复杂度选择
+
+| AI 类型 | 复杂度 | 使用场景 |
+| --- | --- | --- |
+| **FSM（有限状态机）** | 简单 | 3-5 状态，行为可预测 |
+| **行为树（Behavior Tree）** | 中等 | 模块化，策划友好 |
+| **GOAP（目标导向行动规划）** | 高 | 基于规划的涌现行为 |
+| **效用 AI（Utility AI）** | 高 | 基于评分决策 |
+
+---
+
+### 6. 碰撞策略
+
+| 类型 | 适用场景 |
+| --- | --- |
+| **AABB（轴对齐包围盒）** | 矩形，检测快 |
+| **Circle（圆形）** | 圆形物体，开销低 |
+| **Spatial Hash（空间哈希）** | 大量相似尺寸物体 |
+| **Quadtree（四叉树）** | 大型世界，尺寸差异大 |
+
+---
+
+## 反模式（通用）
+
+| 禁止 | 推荐 |
+| --- | --- |
+| 每帧更新所有内容 | 使用事件、脏标记 |
+| 在热点循环中创建对象 | 使用对象池 |
+| 不做缓存 | 缓存常用引用 |
+| 不做分析就优化 | 先做性能分析 |
+| 输入与逻辑混在一起 | 抽象输入层 |
+
+---
+
+## 路由示例
+
+### 示例 1：“我想做一个基于浏览器的 2D 平台游戏”
+→ 先用 `game-development/web-games` 选择框架  
+→ 再用 `game-development/2d-games` 学习精灵/瓦片地图模式  
+→ 参考 `game-development/game-design` 进行关卡设计
+
+### 示例 2：“适用于 iOS 和 Android 的移动端益智游戏”
+→ 先用 `game-development/mobile-games` 处理触控与商店发布  
+→ 使用 `game-development/game-design` 做谜题平衡
+
+### 示例 3：“多人 VR 射击游戏”
+→ `game-development/vr-ar` 处理舒适性与沉浸感  
+→ `game-development/3d-games` 处理渲染  
+→ `game-development/multiplayer` 处理联网同步
+
+---
+
+> **谨记：** 优秀的游戏来自迭代，而不是一步到位的完美。快速产出原型，再逐步打磨。

package/.agent/skills/game-development/game-art/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: game-art
+description: 游戏美术原则。视觉风格选择、资产管线、动画流程。
+allowed-tools: Read, Glob, Grep
+---
+
+# 游戏美术原则
+
+> 游戏视觉设计思维：风格选择、资产管线与美术指导。
+
+---
+
+## 1. 美术风格选择
+
+### 决策树
+
+```
+游戏应该唤起什么感觉？
+│
+├── 怀旧 / 复古
+│   ├── 有限调色板？ → Pixel Art（像素艺术）
+│   └── 手绘感？ → Vector / Flash style（矢量/Flash 风格）
+│
+├── 真实 / 沉浸
+│   ├── 高预算？ → PBR 3D
+│   └── 风格化真实？ → Hand-painted textures（手绘纹理）
+│
+├── 亲切 / 休闲
+│   ├── 干净的形状？ → Flat / Minimalist（扁平/极简）
+│   └── 柔和感？ → Gradient / Soft shadows（渐变/软阴影）
+│
+└── 独特 / 实验性
+    └── 定义自定义风格指南
+```
+
+### 风格比较矩阵
+
+| 风格 | 制作速度 | 技能门槛 | 可扩展性 | 最适合 |
+| --- | --- | --- | --- | --- |
+| **Pixel Art（像素艺术）** | 中 | 中 | 难招人 | 独立、复古 |
+| **Vector/Flat（矢量/扁平）** | 快 | 低 | 易 | 移动端、休闲 |
+| **Hand-painted（手绘）** | 慢 | 高 | 中 | 奇幻、风格化 |
+| **PBR 3D** | 慢 | 高 | AAA 管线 | 真实游戏 |
+| **Low-poly（低多边形）** | 快 | 中 | 易 | 独立 3D |
+| **Cel-shaded（卡通渲染）** | 中 | 中 | 中 | 动漫、卡通 |
+
+---
+
+## 2. 资产管线决策
+
+### 2D 管线
+
+| 阶段 | 工具选项 | 输出 |
+| --- | --- | --- |
+| **概念** | Paper、Procreate、Photoshop | 参考图 |
+| **创作** | Aseprite、Photoshop、Krita | 单个精灵 |
+| **图集** | TexturePacker、Aseprite | 精灵表 |
+| **动画** | Spine、DragonBones、逐帧 | 动画数据 |
+| **集成** | 引擎导入 | 游戏就绪资产 |
+
+### 3D 管线
+
+| 阶段 | 工具选项 | 输出 |
+| --- | --- | --- |
+| **概念** | 2D 美术、Blockout | 参考 |
+| **建模** | Blender、Maya、3ds Max | 高模 |
+| **拓扑** | Blender、ZBrush | 游戏就绪网格 |
+| **UV/纹理** | Substance Painter、Blender | 纹理贴图 |
+| **绑定** | Blender、Maya | 骨骼绑定 |
+| **动画** | Blender、Maya、Mixamo | 动画片段 |
+| **导出** | FBX、glTF | 引擎就绪 |
+
+---
+
+## 3. 色彩理论决策
+
+### 调色板选择
+
+| 目标 | 策略 | 示例 |
+| --- | --- | --- |
+| **和谐** | 互补或类比 | 自然类游戏 |
+| **对比** | 高饱和度差异 | 动作类游戏 |
+| **情绪** | 暖/冷色温 | 恐怖、舒适 |
+| **可读性** | 明度对比优于色相 | 玩法清晰度 |
+
+### 色彩原则
+
+- **层级：** 重要元素应突出
+- **一致性：** 相同对象 = 相同色系
+- **上下文：** 颜色在背景上读取不同
+- **无障碍：** 不要仅依赖颜色
+
+---
+
+## 4. 动画原则
+
+### 12 原则（应用于游戏）
+
+| 原则 | 游戏应用 |
+| --- | --- |
+| **Squash & Stretch（挤压与拉伸）** | 跳跃弧线、撞击 |
+| **Anticipation（预备动作）** | 攻击前的蓄力 |
+| **Staging（舞台设计）** | 清晰的剪影 |
+| **Follow-through（跟随动作）** | 移动后的头发、披风 |
+| **Slow in/out（慢进/慢出）** | 过渡的缓动 |
+| **Arcs（弧线）** | 自然移动路径 |
+| **Secondary Action（次要动作）** | 呼吸、眨眼 |
+| **Timing（时间控制）** | 帧数 = 重量/速度 |
+| **Exaggeration（夸张）** | 远距离可读 |
+| **Appeal（吸引力）** | 令人难忘的设计 |
+
+### 帧数指南
+
+| 动作类型 | 典型帧数 | 感觉 |
+| --- | --- | --- |
+| 待机呼吸 | 4-8 | 微妙 |
+| 行走循环 | 6-12 | 平滑 |
+| 跑步循环 | 4-8 | 充满活力 |
+| 攻击 | 3-6 | 爽快 |
+| 死亡 | 8-16 | 戏剧性 |
+
+---
+
+## 5. 分辨率与比例决策
+
+### 2D 分辨率（按平台）
+
+| 平台 | 基础分辨率 | 精灵比例 |
+| --- | --- | --- |
+| 移动端 | 1080p | 64-128px 角色 |
+| 桌面 | 1080p-4K | 128-256px 角色 |
+| 像素艺术 | 320x180 到 640x360 | 16-32px 角色 |
+
+### 一致性规则
+
+选择一个基准单位并坚持：
+- 像素艺术：在 1x 下工作，放大（从不缩小）
+- 高清美术：定义 DPI，保持比例
+- 3D：1 单位 = 1 米（行业标准）
+
+---
+
+## 6. 资产组织
+
+### 命名规范
+
+```
+[type]_[object]_[variant]_[state].[ext]
+
+示例:
+spr_player_idle_01.png
+tex_stone_wall_normal.png
+mesh_tree_oak_lod2.fbx
+```
+
+### 文件夹结构原则
+
+```
+assets/
+├── characters/
+│   ├── player/
+│   └── enemies/
+├── environment/
+│   ├── props/
+│   └── tiles/
+├── ui/
+├── effects/
+└── audio/
+```
+
+---
+
+## 7. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 随机混合美术风格 | 定义并遵循风格指南 |
+| 仅在最终分辨率下工作 | 在源分辨率下创建 |
+| 忽略剪影可读性 | 在游戏距离测试 |
+| 过度细化背景 | 将细节集中在玩家区域 |
+| 跳过颜色测试 | 在目标显示器上测试 |
+
+---
+
+> **记住：** 美术服务于玩法。如果不能帮助玩家，它就是装饰。

package/.agent/skills/game-development/game-audio/SKILL.md

@@ -0,0 +1,190 @@
+---
+name: game-audio
+description: 游戏音频原则。声音设计、音乐集成、自适应音频系统。
+allowed-tools: Read, Glob, Grep
+---
+
+# 游戏音频原则
+
+> 为沉浸式游戏体验提供声音设计与音乐集成。
+
+---
+
+## 1. 音频分类系统
+
+### 分类定义
+
+| 分类 | 行为 | 示例 |
+| --- | --- | --- |
+| **Music（音乐）** | 循环、交叉淡入淡出、ducking（闪避） | BGM、战斗音乐 |
+| **SFX（音效）** | 单次触发、3D 定位 | 脚步声、撞击声 |
+| **Ambient（环境）** | 循环、背景层 | 风、人群、森林 |
+| **UI（界面）** | 立即、非 3D | 按钮点击、通知 |
+| **Voice（语音）** | 优先级、触发闪避 | 对话、播音员 |
+
+### 优先级层级
+
+```
+当声音争夺通道时：
+
+1. Voice（最高，始终可听）
+2. Player SFX（玩家音效，反馈关键）
+3. Enemy SFX（敌人音效，玩法重要）
+4. Music（音乐，情绪但可闪避）
+5. Ambient（环境，最低，可丢弃）
+```
+
+---
+
+## 2. 声音设计决策
+
+### SFX 制作方法
+
+| 方法 | 何时使用 | 权衡 |
+| --- | --- | --- |
+| **Recording（录音）** | 真实需求 | 高质量、耗时 |
+| **Synthesis（合成）** | 科幻、复古、UI | 独特、需要技能 |
+| **Library samples（库采样）** | 快速制作 | 常见声音、许可 |
+| **Layering（分层）** | 复杂声音 | 最佳结果、更多工作 |
+
+### 分层结构
+
+| 层 | 目的 | 示例：枪声 |
+| --- | --- | --- |
+| **Attack（起音）** | 初始瞬态 | 咔哒声、啪声 |
+| **Body（主体）** | 主要特征 | 轰鸣、爆炸 |
+| **Tail（尾音）** | 衰减、空间 | 混响、回声 |
+| **Sweetener（润色）** | 特殊调料 | 弹壳声、机械声 |
+
+---
+
+## 3. 音乐集成
+
+### 音乐状态系统
+
+```
+游戏状态 → 音乐响应
+│
+├── 菜单 → 平静、可循环主题
+├── 探索 → 环境、大气
+├── 检测到战斗 → 过渡到紧张
+├── 战斗进行中 → 完整战斗音乐
+├── 胜利 → Stinger（短句）+ 平静过渡
+├── 失败 → 忧郁短句
+└── Boss → 独特、多阶段轨道
+```
+
+### 过渡技术
+
+| 技术 | 何时使用 | 感觉 |
+| --- | --- | --- |
+| **Crossfade（交叉淡入淡出）** | 平滑情绪转变 | 渐进 |
+| **Stinger（短句）** | 立即事件 | 戏剧性 |
+| **Stem mixing（分轨混合）** | 动态强度 | 无缝 |
+| **Beat-synced（节拍同步）** | 节奏玩法 | 音乐性 |
+| **Queue point（队列点）** | 下一个自然中断 | 干净 |
+
+---
+
+## 4. 自适应音频决策
+
+### 强度参数
+
+| 参数 | 影响 | 示例 |
+| --- | --- | --- |
+| **Threat level（威胁等级）** | 音乐强度 | 敌人数量 |
+| **Health（健康）** | 滤波器、混响 | 低血量 = 闷响 |
+| **Speed（速度）** | Tempo（速度）、能量 | 赛车速度 |
+| **Environment（环境）** | 混响、EQ | 洞穴与户外 |
+| **Time of day（一天中的时间）** | 情绪、音量 | 夜晚 = 更安静 |
+
+### 垂直与水平
+
+| 系统 | 变化内容 | 最适合 |
+| --- | --- | --- |
+| **垂直（层）** | 添加/移除乐器层 | 强度缩放 |
+| **水平（段）** | 不同的音乐段落 | 状态变化 |
+| **组合** | 两者都有 | AAA 自适应配乐 |
+
+---
+
+## 5. 3D 音频决策
+
+### 空间化
+
+| 元素 | 3D 定位？ | 原因 |
+| --- | --- | --- |
+| 玩家脚步声 | 否（或微妙） | 始终可听 |
+| 敌人脚步声 | 是 | 方向感知 |
+| 枪声 | 是 | 战斗感知 |
+| 音乐 | 否 | 情绪、非叙事性 |
+| 环境区域 | 是（区域） | 环境 |
+| UI 声音 | 否 | 界面反馈 |
+
+### 距离行为
+
+| 距离 | 声音行为 |
+| --- | --- |
+| **近** | 全音量、全频率 |
+| **中** | 音量衰减、高频滚降 |
+| **远** | 低音量、低通滤波器 |
+| **最大** | 寂静或环境提示 |
+
+---
+
+## 6. 平台考量
+
+### 格式选择
+
+| 平台 | 推荐格式 | 原因 |
+| --- | --- | --- |
+| PC | OGG Vorbis、WAV | 质量、无许可限制 |
+| 主机 | 平台特定 | 认证 |
+| 移动端 | MP3、AAC | 体积、兼容性 |
+| Web | WebM/Opus、MP3 回退 | 浏览器支持 |
+
+### 内存预算
+
+| 游戏类型 | 音频预算 | 策略 |
+| --- | --- | --- |
+| 移动休闲 | 10-50 MB | 压缩、变体较少 |
+| PC 独立 | 100-500 MB | 质量优先 |
+| AAA | 1+ GB | 全质量、许多变体 |
+
+---
+
+## 7. 混音层级
+
+### 音量平衡参考
+
+| 分类 | 相对电平 | 备注 |
+| --- | --- | --- |
+| **Voice（语音）** | 0 dB（参考） | 始终清晰 |
+| **Player SFX（玩家音效）** | -3 到 -6 dB | 突出但不刺耳 |
+| **Music（音乐）** | -6 到 -12 dB | 基础，为语音避让 |
+| **Enemy SFX（敌人音效）** | -6 到 -9 dB | 重要但不主导 |
+| **Ambient（环境）** | -12 到 -18 dB | 微妙背景 |
+
+### 闪避（Ducking）规则
+
+| 何时 | 闪避什么 | 量 |
+| --- | --- | --- |
+| 语音播放 | 音乐、环境 | -6 到 -9 dB |
+| 爆炸 | 除爆炸外的所有 | 短暂闪避 |
+| 菜单打开 | 游戏音频 | -3 到 -6 dB |
+
+---
+
+## 8. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 重复播放相同的声音 | 使用变体（每个声音 3-5 个） |
+| 所有内容最大音量 | 使用适当的混音层级 |
+| 忽略寂静 | 寂静创造对比 |
+| 一首音乐轨道永远循环 | 提供变化、过渡 |
+| 原型中跳过音频 | 占位音频很重要 |
+
+---
+
+> **记住：** 50% 的游戏体验是音频。静音的游戏失去了灵魂的一半。

package/.agent/skills/game-development/game-design/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: game-design
+description: 游戏设计原则。GDD 结构、平衡性、玩家心理、进度设计。
+allowed-tools: Read, Glob, Grep
+---
+
+# 游戏设计原则
+
+> 让游戏更有吸引力的设计思维。
+
+---
+
+## 1. 核心循环设计
+
+### 30 秒测试
+
+```
+每个游戏都需要一个有趣的 30 秒循环：
+1. ACTION → 玩家做某事
+2. FEEDBACK → 游戏响应
+3. REWARD → 玩家感觉良好
+4. REPEAT
+```
+
+### 循环示例
+
+| 类型 | 核心循环 |
+| --- | --- |
+| Platformer（平台） | 跑 → 跳 → 落地 → 收集 |
+| Shooter（射击） | 瞄准 → 射击 → 击杀 → 拾取 |
+| Puzzle（解谜） | 观察 → 思考 → 解开 → 前进 |
+| RPG（角色扮演） | 探索 → 战斗 → 升级 → 装备 |
+
+---
+
+## 2. 游戏设计文档（GDD）
+
+### 核心部分
+
+| 部分 | 内容 |
+| --- | --- |
+| **Pitch** | 一句话描述 |
+| **Core Loop** | 30 秒玩法 |
+| **Mechanics** | 系统如何工作 |
+| **Progression** | 玩家如何前进 |
+| **Art Style** | 视觉方向 |
+| **Audio** | 声音方向 |
+
+### 原则
+
+- 保持它是鲜活的（定期更新）
+- 视觉辅助交流
+- 少即是多（从小开始）
+
+---
+
+## 3. 玩家心理学
+
+### 动机类型
+
+| 类型 | 驱动力 |
+| --- | --- |
+| **Achiever（成就者）** | 目标、完成度 |
+| **Explorer（探索者）** | 发现、秘密 |
+| **Socializer（社交者）** | 互动、社区 |
+| **Killer（杀手）** | 竞争、支配 |
+
+### 奖励计划
+
+| 计划 | 效果 | 用途 |
+| --- | --- | --- |
+| **Fixed（固定）** | 可预测 | 里程碑奖励 |
+| **Variable（可变）** | 易上瘾 | 掉落战利品 |
+| **Ratio（比率）** | 基于努力 | 刷刷刷游戏 |
+
+---
+
+## 4. 难度平衡
+
+### 心流状态
+
+```
+太难 → 沮丧 → 退出
+太易 → 无聊 → 退出
+刚刚好 → 心流 → 投入
+```
+
+### 平衡策略
+
+| 策略 | 如何做 |
+| --- | --- |
+| **Dynamic（动态）** | 适应玩家技能 |
+| **Selection（选择）** | 让玩家选择 |
+| **Accessibility（无障碍）** | 为所有人提供选项 |
+
+---
+
+## 5. 进度设计
+
+### 进度类型
+
+| 类型 | 示例 |
+| --- | --- |
+| **Skill（技能）** | 玩家变得更好 |
+| **Power（力量）** | 角色变得更强 |
+| **Content（内容）** | 新区域解锁 |
+| **Story（故事）** | 叙事推进 |
+
+### 节奏原则
+
+- 早期胜利（快速钩住）
+- 逐渐增加挑战
+- 强度之间的休息节拍
+- 有意义的选择
+
+---
+
+## 6. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 孤立设计 | 持续进行游戏测试 |
+| 有趣之前先打磨 | 首先制作原型 |
+| 强制一种玩法 | 允许玩家表达 |
+| 过度惩罚 | 奖励进步 |
+
+---
+
+> **记住：** 乐趣是通过迭代发现的，而不是在纸上设计出来的。