安装环境准备 Skill
Skill 是一份说明书：交给 Agent 一次，它就知道怎么做好一件事，而不是自己瞎猜。
这个 Skill 教会 Agent 安装并检查这个项目需要的所有程序——Node.js、pnpm、git、mars CLI、
Docker、JDK/Maven、Rust 以及 Tauri 的系统 依赖库——并且知道哪个版本真的能用；没有它，
Agent 很可能装个太老的版本然后报告成功。它不需要项目代码，一台全新的机器上就能装。
1. 下载压缩包
或者用命令行下载：
- macOS / Linux
- Windows (PowerShell)
curl -LO https://marsquakes.cc/skills/marsquakes-setup.zip
Invoke-WebRequest -Uri https://marsquakes.cc/skills/marsquakes-setup.zip -OutFile marsquakes-setup.zip
你应该看到： 下载完成后，marsquakes-setup.zip 出现在下载目录里。压缩包里是一个
文件夹，装着五个小文本文件——Agent 要读的说明书，以及必备版本和误导性报错的笔记。
文件夹名已在压缩包里，直接解压到目标位置即可，不用先建文件夹。
2. 解压到 Agent 能读到的地方
选你系统的那段复制运行：
- macOS / Linux
- Windows (PowerShell)
mkdir -p ~/.agents/skills
unzip -o ~/Downloads/marsquakes-setup.zip -d ~/.agents/skills
$dest = "$HOME\.agents\skills"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Expand-Archive -Path "$HOME\Downloads\marsquakes-setup.zip" -DestinationPath $dest -Force
这个位置在用户主目录里，装一次，这台电脑上的每个 项目都能用。
项目级的 Skill 一换到别的文件夹就消失，包括你接下来才要创建、目前还不存在的那个项目。
3. 确认 Agent 看见了它
先验证解压是否正确：
- macOS / Linux
- Windows (PowerShell)
head -4 ~/.agents/skills/marsquakes-setup/SKILL.md
Get-Content "$HOME\.agents\skills\marsquakes-setup\SKILL.md" -TotalCount 4
你应该看到： ~/.agents/skills/marsquakes-setup/ 下有五个小文件，第一行是 ---，
然后是 name:、description:。第一行不是 --- 的 Skill 会被静默忽略——没有报错，
就像它不存在一样。
然后启动 Agent，直接问：
你有没有用来准备 Marsquakes 环境的 skill？
你应该看到： Agent 报出 marsquakes-setup 这个名字，并说明它负责安装程序。
如果没出现，先彻底重启 dsh——它只在启动时扫描新 Skill（仅 SKILL.md 变化才刷新缓存）。重启后仍看不到，
就让它检查扫描路径是不是指向你解压的那个目录。
4. 使用它
用日常语言描述你要的环境。这个 Skill 靠描述触发，不需要点它的名字：
把这台电脑准备好，让我能在上面做 Marsquakes 的网页版管理系统。
先告诉我缺什么，别急着装。
你应该看到这样的执行顺序：
| 步骤 | 你应该看到 |
|---|---|
| 1 | 一份检测报告，每个工具标为 OK、OLD 或 MISS |
| 2 | 反问你要做哪个场景 |
| 3 | 给出方案，并在动手之前停下来等你确认 |
| 4 | 安装后重新检测，被修好的工具变成 OK |
安装程序退出码为 0 什么也证明不了——有些装完就是不往系统路径里放东西；只有工具从
MISS 变成 OK 才算数。Agent 跳到"全部完成"时就说："再检测一遍，把结果给我看。"
它检查什么，以及为什么是这些数字
这些不是偏好，而是低于它就真会出问题的版本——而且报错通常指向完全不相干的地方。
| 工具 | 必须不低于 | 什么时候装 | 为什么是这个数字 |
|---|---|---|---|
| Node.js | 22.12.0 | 一开始就装 | 22.0 到 22.11 直接被拒绝，所以光说"22 版本"不够 |
| pnpm | 9.0.0 | 一开始就装 | 由项目根目录 package.json 固定 |
| git | 2.20.0 | 一开始就装 | — |
| Docker | 20.10.0 | 一开始就装，前提是你要用 | — |
| Docker Compose | 2.0.0 | 跟着 Docker 一起来 | 版本 1 读不了这个项目用的文件格式 |
| JDK | 17 | 项目里有后端或安卓端的时候 | 21 也可以，11 不行 |
| Maven | 3.9.0 | 项目里有后端的时候 | — |
| Rust | 1.77.0 | 项目里有桌面端的时候 | 桌面应用需要的最低版本 |
"什么时候装"说的是时间，不是要不要。前三个是 Agent 自己要用的工具，必须先在； 后三个取决于你在做什么，项目建出来之前谁也不知道，所以初始化时才装。只做桌面端的机器永远不会有 JDK， 只做后端的机器永远不会有 Rust。
你就说："只装基础的那几个，剩下的等项目建好再说。"一次装完没有危害，就是慢：它会替你 下载一个可能永远用不上的 JDK 和一整套 Rust 工具链。
下一步
Vibe Coding 在这里的工作方式——让本指南其余部分奏效的习惯和提示词写法。
想全部手动装，环境准备用命令清单覆盖了同样的内容。