@mison/ag-kit-cn 2.0.1

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

@@ -0,0 +1,108 @@
+---
+name: mobile-games
+description: 移动游戏开发原则。触摸输入、电池、性能、应用商店要求。
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# 移动游戏开发
+
+> 平台限制与优化原则。
+
+---
+
+## 1. 平台考量
+
+### 关键限制
+
+| 限制 | 策略 |
+| --- | --- |
+| **触摸输入（Touch input）** | 大点击区域、手势 |
+| **电池（Battery）** | 限制 CPU/GPU 使用 |
+| **热量（Thermal）** | 发热时节流 |
+| **屏幕尺寸（Screen size）** | 响应式 UI |
+| **中断（Interruptions）** | 进入后台暂停 |
+
+---
+
+## 2. 触摸输入原则
+
+### 触摸 vs 控制器
+
+| 触摸 | 桌面/主机 |
+| --- | --- |
+| 不精确 | 精确 |
+| 遮挡屏幕 | 无遮挡 |
+| 按钮有限 | 许多按钮 |
+| 可用手势 | 按钮/摇杆 |
+
+### 最佳实践
+
+- 最小触摸目标：44x44 点
+- 触摸时提供视觉反馈
+- 避免精确的时间要求
+- 支持纵向与横向
+
+---
+
+## 3. 性能目标
+
+### 热管理
+
+| 动作 | 触发条件 |
+| --- | --- |
+| 降低质量 | 设备温热 |
+| 限制 FPS | 设备发热 |
+| 暂停特效 | 临界温度 |
+
+### 电池优化
+
+- 30 FPS 通常足够
+- 暂停时休眠
+- 最小化 GPS/网络
+- 深色模式节省 OLED 电量
+
+---
+
+## 4. 应用商店要求
+
+### iOS（App Store）
+
+| 要求 | 备注 |
+| --- | --- |
+| 隐私标签 | 必需 |
+| 账户删除 | 若存在账户创建 |
+| 截图 | 覆盖所有设备尺寸 |
+
+### Android（Google Play）
+
+| 要求 | 备注 |
+| --- | --- |
+| 目标 API | 当年的 SDK |
+| 64 位 | 必需 |
+| App bundles | 推荐 |
+
+---
+
+## 5. 变现模型
+
+| 模型 | 最适合 |
+| --- | --- |
+| **Premium（付费）** | 优质游戏、忠实受众 |
+| **Free + IAP（免费+内购）** | 休闲、基于进度 |
+| **Ads（广告）** | 超休闲、高量级 |
+| **Subscription（订阅）** | 内容更新、多人游戏 |
+
+---
+
+## 6. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 在移动端使用桌面控制 | 为触摸设计 |
+| 忽略电池消耗 | 监控热量 |
+| 强制横屏 | 支持玩家偏好 |
+| 始终联网 | 缓存并同步 |
+
+---
+
+> **记住：** 移动端是最受限的平台。尊重电池与注意力。

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

@@ -0,0 +1,132 @@
+---
+name: multiplayer
+description: 多人游戏开发原则。架构、网络、同步。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# 多人游戏开发
+
+> 网络架构与同步原则。
+
+---
+
+## 1. 架构选择
+
+### 决策树
+
+```
+什么类型的多人游戏？
+│
+├── 竞技 / 实时
+│   └── Dedicated Server（专用服务器，权威）
+│
+├── 合作 / 休闲
+│   └── Host-based（基于主机，一个玩家作为服务器）
+│
+├── 回合制
+│   └── Client-server（客户端-服务器，简单）
+│
+└── 大型（MMO）
+    └── 分布式服务器
+```
+
+### 比较
+
+| 架构 | 延迟 | 成本 | 安全性 |
+| --- | --- | --- | --- |
+| **Dedicated（专用）** | 低 | 高 | 强 |
+| **P2P** | 可变 | 低 | 弱 |
+| **Host-based（主机）** | 中 | 低 | 中 |
+
+---
+
+## 2. 同步原则
+
+### 状态 vs 输入
+
+| 方法 | 同步什么 | 最适合 |
+| --- | --- | --- |
+| **State Sync（状态同步）** | 游戏状态 | 简单、对象少 |
+| **Input Sync（输入同步）** | 玩家输入 | 动作游戏 |
+| **Hybrid（混合）** | 两者 | 大多数游戏 |
+
+### 延迟补偿
+
+| 技术 | 目的 |
+| --- | --- |
+| **Prediction（预测）** | 客户端预测服务器 |
+| **Interpolation（插值）** | 平滑远程玩家 |
+| **Reconciliation（和解）** | 修正错误预测 |
+| **Lag compensation（延迟补偿）** | 回滚以进行命中检测 |
+
+---
+
+## 3. 网络优化
+
+### 带宽减少
+
+| 技术 | 节省 |
+| --- | --- |
+| **Delta compression（增量压缩）** | 仅发送变化 |
+| **Quantization（量化）** | 降低精度 |
+| **Priority（优先级）** | 重要数据优先 |
+| **Area of interest（兴趣区域）** | 仅附近实体 |
+
+### 更新率
+
+| 类型 | 速率 |
+| --- | --- |
+| 位置 | 20-60 Hz |
+| 生命值 | 变化时 |
+| 库存 | 变化时 |
+| 聊天 | 发送时 |
+
+---
+
+## 4. 安全原则
+
+### 服务器权威
+
+```
+客户端: "我击中了敌人"
+服务器: 验证 → 抛射物真的击中了吗？
+         → 玩家处于有效状态吗？
+         → 时间上可能吗？
+```
+
+### 反作弊
+
+| 作弊 | 预防 |
+| --- | --- |
+| Speed hack（速度挂） | 服务器验证移动 |
+| Aimbot（自瞄） | 服务器验证视线 |
+| Item dupe（复制物品） | 服务器拥有库存 |
+| Wall hack（透视） | 不发送隐藏数据 |
+
+---
+
+## 5. 匹配
+
+### 考量因素
+
+| 因素 | 影响 |
+| --- | --- |
+| **Skill（技能）** | 公平比赛 |
+| **Latency（延迟）** | 可玩的连接 |
+| **Wait time（等待时间）** | 玩家耐心 |
+| **Party size（队伍大小）** | 组队游玩 |
+
+---
+
+## 6. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 信任客户端 | 服务器是权威 |
+| 发送一切 | 仅发送必要的 |
+| 忽略延迟 | 为 100-200ms 设计 |
+| 同步精确位置 | 插值/预测 |
+
+---
+
+> **记住：** 永远不要信任客户端。服务器是真理之源。

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

@@ -0,0 +1,144 @@
+---
+name: pc-games
+description: PC 与主机游戏开发原则。引擎选择、平台特性、优化策略。
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# PC/主机游戏开发
+
+> 引擎选择与平台特定原则。
+
+---
+
+## 1. 引擎选择
+
+### 决策树
+
+```
+你在构建什么？
+│
+├── 2D 游戏
+│   ├── 开源很重要？ → Godot
+│   └── 大型团队/资产？ → Unity
+│
+├── 3D 游戏
+│   ├── AAA 视觉质量？ → Unreal
+│   ├── 跨平台优先？ → Unity
+│   └── 独立/开源？ → Godot 4
+│
+└── 特定需求
+    ├── DOTS 性能？ → Unity
+    ├── Nanite/Lumen？ → Unreal
+    └── 轻量级？ → Godot
+```
+
+### 比较
+
+| 因素 | Unity 6 | Godot 4 | Unreal 5 |
+| --- | --- | --- | --- |
+| 2D | 好 | 极好 | 有限 |
+| 3D | 好 | 好 | 极好 |
+| 学习 | 中等 | 容易 | 难 |
+| 成本 | 收入分成 | 免费 | 100 万美元后 5% |
+| 团队 | 任何 | 个人-中型 | 中型-大型 |
+
+---
+
+## 2. 平台特性
+
+### Steam 集成
+
+| 特性 | 目的 |
+| --- | --- |
+| Achievements（成就） | 玩家目标 |
+| Cloud Saves（云存档） | 跨设备进度 |
+| Leaderboards（排行榜） | 竞争 |
+| Workshop（创意工坊） | 用户模组 |
+| Rich Presence（富呈现） | 显示游戏内状态 |
+
+### 主机要求
+
+| 平台 | 认证 |
+| --- | --- |
+| PlayStation | TRC 合规 |
+| Xbox | XR 合规 |
+| Nintendo | Lotcheck |
+
+---
+
+## 3. 控制器支持
+
+### 输入抽象
+
+```
+映射 ACTIONS，而不是按钮：
+- "confirm" → A（Xbox）、Cross（PS）、B（Nintendo）
+- "cancel" → B（Xbox）、Circle（PS）、A（Nintendo）
+```
+
+### 触觉反馈
+
+| 强度 | 用途 |
+| --- | --- |
+| 轻 | UI 反馈 |
+| 中 | 撞击 |
+| 重 | 重大事件 |
+
+---
+
+## 4. 性能优化
+
+### 性能分析优先
+
+| 引擎 | 工具 |
+| --- | --- |
+| Unity | Profiler Window |
+| Godot | Debugger → Profiler |
+| Unreal | Unreal Insights |
+
+### 常见瓶颈
+
+| 瓶颈 | 解决方案 |
+| --- | --- |
+| Draw calls（绘制调用） | Batching（合批）、atlases（图集） |
+| GC spikes（GC 峰值） | Object pooling（对象池） |
+| Physics（物理） | 更简单的碰撞体 |
+| Shaders（着色器） | LOD 着色器 |
+
+---
+
+## 5. 引擎特定原则
+
+### Unity 6
+
+- DOTS 用于性能关键系统
+- Burst compiler 用于热路径
+- Addressables 用于资产流式传输
+
+### Godot 4
+
+- GDScript 用于快速迭代
+- C# 用于复杂逻辑
+- Signals 用于解耦
+
+### Unreal 5
+
+- Blueprint（蓝图）给设计师
+- C++ 追求性能
+- Nanite 用于高多边形环境
+- Lumen 用于动态光照
+
+---
+
+## 6. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 凭炒作选择引擎 | 按项目需求选择 |
+| 忽略平台指南 | 研究认证要求 |
+| 硬编码输入按钮 | 抽象为动作 |
+| 跳过性能分析 | 尽早并经常分析 |
+
+---
+
+> **记住：** 引擎只是工具。掌握原则，然后适应任何引擎。

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

@@ -0,0 +1,123 @@
+---
+name: vr-ar
+description: VR/AR 开发原则。舒适度、交互、性能要求。
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# VR/AR 开发
+
+> 沉浸式体验原则。
+
+---
+
+## 1. 平台选择
+
+### VR 平台
+
+| 平台 | 用途 |
+| --- | --- |
+| **Quest** | 独立、无线 |
+| **PCVR** | 高保真 |
+| **PSVR** | 主机市场 |
+| **WebXR** | 浏览器端 |
+
+### AR 平台
+
+| 平台 | 用途 |
+| --- | --- |
+| **ARKit** | iOS 设备 |
+| **ARCore** | Android 设备 |
+| **WebXR** | 浏览器 AR |
+| **HoloLens** | 企业级 |
+
+---
+
+## 2. 舒适度原则
+
+### 晕动症预防
+
+| 原因 | 解决方案 |
+| --- | --- |
+| **Locomotion（移动）** | 传送、瞬转 |
+| **Low FPS（低帧率）** | 维持 90 FPS |
+| **Camera shake（相机抖动）** | 避免或最小化 |
+| **Rapid acceleration（快速加速）** | 渐进移动 |
+
+### 舒适设置
+
+- 移动时的晕影（Vignette）
+- 瞬转与平滑转向
+- 坐姿与站姿模式
+- 高度校准
+
+---
+
+## 3. 性能要求
+
+### 目标指标
+
+| 平台 | FPS（帧率） | 分辨率 |
+| --- | --- | --- |
+| Quest 2 | 72-90 | 1832x1920 |
+| Quest 3 | 90-120 | 2064x2208 |
+| PCVR | 90 | 2160x2160+ |
+| PSVR2 | 90-120 | 2000x2040 |
+
+### 帧预算
+
+- VR 需要一致的帧时间
+- 掉一帧 = 可见的抖动
+- 90 FPS = 11.11ms 预算
+
+---
+
+## 4. 交互原则
+
+### 控制器交互
+
+| 类型 | 用途 |
+| --- | --- |
+| **Point + click** | UI、远处物体 |
+| **Grab** | 操作 |
+| **Gesture** | 魔法、特殊动作 |
+| **Physical** | 投掷、挥舞 |
+
+### 手部追踪
+
+- 更沉浸但精度较低
+- 适合：社交、休闲
+- 挑战：动作、精度
+
+---
+
+## 5. 空间设计
+
+### 世界比例
+
+- 1 单位 = 1 米（关键）
+- 物体必须感觉大小合适
+- 用真实测量进行测试
+
+### 深度线索
+
+| 线索 | 重要性 |
+| --- | --- |
+| Stereo（立体） | 主要深度 |
+| Motion parallax（运动视差） | 次要 |
+| Shadows（阴影） | 接地感 |
+| Occlusion（遮挡） | 分层 |
+
+---
+
+## 6. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 移动相机而不移动玩家 | 玩家控制相机 |
+| 低于 90 FPS | 维持帧率 |
+| 使用微小的 UI 文本 | 大而易读的文本 |
+| 忽略手臂长度 | 依据玩家触及范围缩放 |
+
+---
+
+> **记住：** 舒适度不是可选项。生病的玩家不会玩游戏。

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

@@ -0,0 +1,150 @@
+---
+name: web-games
+description: Web 浏览器游戏开发原则。框架选择、WebGPU、优化、PWA。
+allowed-tools: Read, Write, Edit, Glob, Grep
+---
+
+# Web 浏览器游戏开发
+
+> 框架选择与浏览器特定原则。
+
+---
+
+## 1. 框架选择
+
+### 决策树
+
+```
+什么类型的游戏？
+│
+├── 2D 游戏
+│   ├── 完整的游戏引擎功能？ → Phaser
+│   └── 原始渲染能力？ → PixiJS
+│
+├── 3D 游戏
+│   ├── 完整引擎（物理、XR）？ → Babylon.js
+│   └── 渲染聚焦？ → Three.js
+│
+└── 混合 / Canvas
+    └── 自定义 → Raw Canvas/WebGL
+```
+
+### 对比（2025）
+
+| 框架 | 类型 | 最适合 |
+| --- | --- | --- |
+| **Phaser 4** | 2D | 完整游戏功能 |
+| **PixiJS 8** | 2D | 渲染、UI |
+| **Three.js** | 3D | 可视化、轻量级 |
+| **Babylon.js 7** | 3D | 完整引擎、XR |
+
+---
+
+## 2. WebGPU 采用
+
+### 浏览器支持（2025）
+
+| 浏览器 | 支持 |
+| --- | --- |
+| Chrome | ✅ 自 v113 起 |
+| Edge | ✅ 自 v113 起 |
+| Firefox | ✅ 自 v131 起 |
+| Safari | ✅ 自 18.0 起 |
+| **总计** | **~73%** 全球 |
+
+### 决策
+
+- **新项目**：使用 WebGPU，并提供 WebGL 回退
+- **遗留支持**：从 WebGL 开始
+- **特性检测**：检查 `navigator.gpu`
+
+---
+
+## 3. 性能原则
+
+### 浏览器限制
+
+| 限制 | 策略 |
+| --- | --- |
+| 无本地文件访问 | 资产打包、CDN |
+| 标签页节流 | 隐藏时暂停 |
+| 移动数据限制 | 压缩资产 |
+| 音频自动播放 | 需要用户交互 |
+
+### 优化优先级
+
+1. **资产压缩** - KTX2、Draco、WebP
+2. **懒加载** - 按需加载
+3. **对象池** - 避免 GC
+4. **绘制调用合批** - 减少状态变更
+5. **Web Workers** - 卸载繁重计算
+
+---
+
+## 4. 资产策略
+
+### 压缩格式
+
+| 类型 | 格式 |
+| --- | --- |
+| 纹理 | KTX2 + Basis Universal |
+| 音频 | WebM/Opus（回退：MP3） |
+| 3D 模型 | glTF + Draco/Meshopt |
+
+### 加载策略
+
+| 阶段 | 加载 |
+| --- | --- |
+| 启动 | 核心资产，<2MB |
+| 游戏过程 | 按需流式传输 |
+| 后台 | 预取下一关 |
+
+---
+
+## 5. 游戏的 PWA
+
+### 优势
+
+- 离线游玩
+- 安装到主屏幕
+- 全屏模式
+- 推送通知
+
+### 要求
+
+- Service worker 用于缓存
+- Web app manifest
+- HTTPS
+
+---
+
+## 6. 音频处理
+
+### 浏览器要求
+
+- 音频上下文需要用户交互
+- 在首次点击/轻触时创建 AudioContext
+- 如果挂起则恢复上下文
+
+### 最佳实践
+
+- 使用 Web Audio API
+- 池化音频源
+- 预加载常用声音
+- 使用 WebM/Opus 压缩
+
+---
+
+## 7. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 一次性加载所有资产 | 渐进式加载 |
+| 忽略标签页可见性 | 隐藏时暂停 |
+| 阻塞在音频加载上 | 懒加载音频 |
+| 跳过压缩 | 压缩一切 |
+| 假设快速连接 | 处理慢速网络 |
+
+---
+
+> **记住：** 浏览器是最易访问的平台。尊重它的限制。