wandering1
3c7ad9c75c
fix(skill): 修正 @build 退出码口径不符（环境错误 1→2、用法 2→3）
`AGENTS.md` 与 `keil-build` / `new-machine-setup` 的 SKILL.md 一直写着
"2=UV4 未找到/无效（环境错误）、3=用法"，但实现是反的：
- 环境错误走 `raise SystemExit("...")` → **实际退出码 1**（与"构建失败"
撞号，调用方分不清"编译不过"和"UV4 没配好"）；
- 用法错误由 argparse 抛 `SystemExit(2)` → 恰好占用了文档里"环境错误"
的位置，于是 `new-machine-setup` 里"报 exit 2 先分清真没设还是没继承"
这条排障指引**从未生效**。
改法（让实现服从既有文档口径，而非改文档）：
- 新增 `BuildEnvError`；`find_uv4` / `find_project` / `load_config` 失败
一律抛它，由 `main()` 捕获 → 打印 + 退出码 **2**；
- 覆盖 argparse 的 `error()`（默认 `SystemExit(2)`）→ 用法错误退出码 **3**；
- `run_build` 的档案解析失败原为 `return 3`（用法），实属环境错误 → 并入 2。
调用方安全性：`test/run_all_suites.py` 与 `task-worktree` 的 `run_script`
都只判 `rc == 0` / `rc != 0`，不区分具体码，故本次改动不影响它们。
验证（全部实测，用假 UV4 避免与在途构建争 UV4 与 build 锁）：
| 场景 | 期望 | 实测 |
|---|---|---|
| `--help` | 0 | 0 |
| 成功构建（假 UV4 写 0E0W） | 0 | 0（BUILD_OK） |
| 构建失败（假 UV4 写 `error:`） | 1 | 1（BUILD_FAIL） |
| `--project` 不存在 | 2 | 2 |
| 档案 `uvprojx` 不存在 | 2 | 2 |
| 档案 JSON 解析失败 | 2 | 2 |
| 未知参数 `--bogus` | 3 | 3 |
| 参数缺值 `--timeout` | 3 | 3 |
| build 锁被占用 | 4 | 4（B9 在构建时实测） |
同步更新 `AGENTS.md` 的退出码行（补 2 的完整含义与 4）与 `keil-build`
SKILL.md（记录本次修正的来龙去脉）。pre-commit 全绿。