MiniGrove

MiniGrove Kit · 开始使用

一条命令，种下游戏
让 Agent 负责生长

create-minigrove 会搭好一个 Claude Code / Codex 一进门就熟悉的项目—— MiniGrove Kit 的技能、工作流与护栏，在你写下第一行代码之前就已就位。

准备工作

你需要什么

  • Node.js 22+运行脚手架与 grove CLI
  • GitKit 的每个工作流都以版本控制为前提
  • Claude Code 或 Codex任选一个安装并登录：Claude Code · Codex
先检查一下
node --version需要 v22 或更高版本npm --version安装 Node.js 时会一起安装git --version版本控制已就绪

还没有 Node.js？请从Node.js 官方下载页安装最新版 LTS。npm 会随 Node.js 一起安装，不需要单独下载。安装后重新打开终端，再运行前两条命令确认版本。

只需安装并登录你准备使用的那个 Agent；运行 claude --version 或 codex --version 确认它已就绪。

要做 Unity 游戏？准备 Unity 6000.x。美术工具还需要 Python 3.10+ 和可用的图像后端。 已登录的 Codex 可以直接使用内置图像工具，不必另配 Key；其他提供方可能需要。 搭好以后运行 /mg-minigrove-doctor（Codex：$mg-minigrove-doctor）， 缺什么、怎么补，一目了然。

  1. 抢先体验

    获取 Kit

    Kit 正处于抢先体验阶段，还没有上架 npm——我们直接把它发给你。想试试？ 打个招呼，最新构建就会送到你的收件箱。

    写信给 [email protected]
    收到之后
    npm install -g ~/Downloads/create-minigrove-0.3.1.tgz把 create-minigrove 与 grove 加进 PATH

    文件名对应你收到的版本。之后收到新构建时，在项目里运行 /mg-kit-update（Codex：$mg-kit-update）并给出新文件路径， 即可原地升级。

  2. 在终端里

    创建你的项目

    选择你熟悉的 Agent，一条命令搭好项目。先别关掉终端：如果这台机器还没有登录 MiniGrove，账号引导会在命令结束前出现。

    Claude Code 项目
    create-minigrove my-game
    Codex 项目
    create-minigrove --codex my-game

    脚手架会先写好 .gitignore，再执行 git init 并替你完成第一次提交（--no-git 可跳过）。在桌面浏览器里，点击任意命令即可整行选中。

  3. MiniGrove 账号 · 可跳过

    搭建项目时，顺手创建账号

    在交互式终端里，create-minigrove 会询问 Register this project on MiniGrove now?。直接按 Enter 接受默认的 Yes，浏览器会自动打开，让你创建或登录 MiniGrove 账号。

    第一次使用 MiniGrove？ 在浏览器里点 Sign up 创建账号，再在同一台电脑上打开验证邮件。 请在五分钟内走完浏览器步骤并点 Approve 授权 Grove CLI；等待中的脚手架会返回并创建共享项目。 如果终端先超时，继续完成验证即可——项目会留在本地，终端也会打印恢复步骤。
    已经有账号？ 登录后授权 Grove CLI。若这台机器已经登录，脚手架会跳过询问，直接自动创建共享项目。

    只想保存在本地？回答 No 或使用 --no-grove，不会发送任何数据。 登录之前，先在《隐私政策》与《服务条款》里看清哪些数据会离开你的机器。

  4. 打开 Agent

    让 /mg-setup 接管

    等脚手架和 MiniGrove 登录都完成后，再用 Claude Code 或 Codex 打开新目录。 Agent 会先向你问好，然后带着你走完开发者档案和项目设置。

    Claude Code 桌面 App

    在 App 里打开 my-game，然后输入：

    /mg-setup
    Codex App

    在 App 里打开 my-game，然后输入：

    $mg-setup

    更喜欢终端？从新项目目录启动 Agent：

    命令行 · Claude Code
    cd my-gameclaude

    然后，在会话里输入：

    /mg-setup
    命令行 · Codex
    cd my-gamecodex

    然后，在会话里输入：

    $mg-setup
    全新概念？ Positioning Office Hours 先把想法磨利、推荐好引擎，然后才会搭建具体的引擎工程。
    已有 Unity 项目？ setup 先读懂你的 Unity 版本、测试和构建目标，再生成任何配置。

项目已经开工？

把 Kit 加进已有的 Unity 项目

在项目根目录运行脚手架——它把 Kit 加在现有内容旁边，不碰你的 git 历史； 除非显式传入 --force，也绝不覆盖 Kit 托管的文件。

Claude Code 桌面 App
create-minigrove --into .

然后在 App 里打开这个项目，在对话框输入：

/mg-setup
Codex App
create-minigrove --codex --into .

然后在 App 里打开这个项目，在对话框输入：

$mg-setup

留在终端的话：脚手架命令之后，在项目根目录运行 claude 或 codex，再输入 /mg-setup / $mg-setup。

三个常用命令

最重要的一个：mg-checkpoint

平时直接用自己的话告诉 Agent 想做什么即可，不必背命令。下面三个入口分别用在收尾、同步和排查环境时。

最重要 · 每次工作结束前 Claude Code：/mg-checkpoint · Codex：$mg-checkpoint。 它会整理本轮改动、值得保留的决策与经验，检查工作结果，并留下清楚的交接和下一步。
重新开始工作前 Claude Code：/mg-sync · Codex：$mg-sync。 它会把当前分支同步到最新 main，并说明队友或上游带来了哪些变化。
环境或能力没有准备好时 Claude Code：/mg-minigrove-doctor · Codex：$mg-minigrove-doctor。 它会检查工具和凭证，但不会显示密钥内容，然后告诉你准确的修复办法。

可以开始第一个任务了

接下来，让它值得围坐。

用 Agent 打开项目，让 mg-setup 完成介绍，然后直接说出第一件值得做的事。 或者先退一步，看看这个项目刚刚加入的完整工作流。

开始第一个任务 查看工作流

有问题？写信到 [email protected]