Agent Skills › aresbit/MateBot › harmonyos-game-generator

harmonyos-game-generator

GitHub

HarmonyOS游戏生成器，根据主题自动创建MVVM架构的鸿蒙元服务游戏项目，涵盖代码生成、编译部署及Git初始化。

skills/harmonyos-skills/skills/harmonyos-game-generator/SKILL.md aresbit/MateBot

Trigger Scenarios

用户想要创建新的鸿蒙游戏元服务用户提到游戏主题如贪吃蛇、俄罗斯方块等用户说帮我创建一个XX游戏用户想要基于MVVM架构开发鸿蒙游戏

Install

npx skills add aresbit/MateBot --skill harmonyos-game-generator -g -y

More Options

Non-standard path

npx skills add https://github.com/aresbit/MateBot/tree/master/skills/harmonyos-skills/skills/harmonyos-game-generator -g -y

Use without installing

npx skills use aresbit/MateBot@harmonyos-game-generator

指定 Agent (Claude Code)

npx skills add aresbit/MateBot --skill harmonyos-game-generator -a claude-code -g -y

安装 repo 全部 skill

npx skills add aresbit/MateBot --all -g -y

预览 repo 内 skill

npx skills add aresbit/MateBot --list

SKILL.md

Frontmatter

{
    "name": "harmonyos-game-generator",
    "description": "HarmonyOS 鸿蒙元服务游戏生成器。根据指定游戏主题，自动创建 MVVM 架构的鸿蒙游戏项目。\n\n使用场景:\n- 用户想要创建新的鸿蒙游戏元服务\n- 用户提到游戏主题如 \"贪吃蛇\"、\"俄罗斯方块\"、\"打砖块\" 等\n- 用户说 \"帮我创建一个XX游戏\"\n- 用户想要基于 MVVM 架构开发鸿蒙游戏\n\n触发词: 创建游戏、鸿蒙游戏、元服务游戏、HarmonyOS 游戏、MVVM 游戏"
}

HarmonyOS 游戏生成器

自动生成 MVVM 架构的鸿蒙元服务游戏，支持任意游戏主题。

工作流程

用户输入游戏主题
    ↓
1. 创建 MVVM 目录结构
    ↓
2. 生成基础代码框架 (5次迭代)
    ↓
3. 根据主题定制游戏逻辑
    ↓
4. 编译验证
    ↓
5. 部署到模拟器
    ↓
6. 初始化 Git 并推送到 GitHub

快速开始

# 用户请求示例
"帮我创建一个贪吃蛇鸿蒙游戏"
"创建一个俄罗斯方块元服务"

执行步骤:

1. 生成游戏框架

python3 $SKILL_DIR/scripts/generate_game.py <项目路径> --theme <游戏主题>

参数说明:

项目路径: HarmonyOS 元服务工程根目录
--theme/-t: 游戏主题 (snake, tetris, breakout, flappy, runner, shooter 或任意主题)
--name/-n: 游戏名称 (可选)

2. 完善游戏逻辑

根据游戏主题，完善以下内容:

游戏实体 (Model层)
游戏引擎逻辑 (ViewModel层)
渲染器绘制 (View层)

参考 references/game-patterns.md 了解不同游戏类型的核心机制。

3. 编译部署

python3 $SKILL_DIR/scripts/build_and_deploy.py <项目路径>

4. Git 和 GitHub

python3 $SKILL_DIR/scripts/git_setup.py <项目路径> --name <游戏名称>

MVVM 架构

详细架构说明见 references/mvvm-architecture.md

entry/src/main/ets/
├── common/
│   ├── constants/GameConstants.ets    # 游戏常量
│   └── utils/MathUtils.ets            # 工具函数
├── model/
│   ├── entities/                       # 游戏实体
│   └── repository/ScoreRepository.ets  # 分数持久化
├── viewmodel/
│   ├── GameEngine.ets                  # 游戏引擎
│   └── GameViewModel.ets               # 状态管理
├── view/
│   ├── pages/                          # 页面
│   └── components/GameRenderer.ets     # 渲染器
└── pages/Index.ets                     # 入口页