add

.trae/skills/traeclawinstall/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: TraeClawInstall
+description: 统一执行 Traeclaw 仓库的 OpenClaw 安装、启动、验收与排障流程；当用户希望在本仓库一站式完成部署或检查时调用。
+---
+
+# OpenClaw 仓库一体化技能
+
+## 技能目标
+
+将本仓库视为一个整体，统一完成 OpenClaw 的平台识别、安装、启动、验收与排障，不再拆分多个独立技能。
+
+## 适用场景（何时调用）
+
+- 用户要求“在本地部署openclaw”
+- 用户要求“按这个仓库整体流程执行”
+- 用户希望在 Trae IDE 内一站式完成部署和验证
+- 用户未明确平台细节，但希望直接得到可执行路径
+- 用户出现安装/启动异常，需要按仓库标准流程排障
+
+## 输入前提
+
+- 当前工作目录为仓库根目录
+- 可使用终端执行命令
+- 可访问仓库文档与脚本
+
+## 决策路由
+
+1. 识别平台：
+   - Windows：优先 WSL2，走 `scripts/windows/wsl/*.sh`
+   - macOS：走 `scripts/macos/*.sh`
+   - Linux：走 `scripts/linux/*.sh`
+2. 校验基线：
+   - `node --version` 主版本需 `>=22`
+   - `npm --version` 可用
+   - `openclaw --version` 若不存在则由 setup 安装
+3. 执行标准三步：
+   - `setup -> start -> check`
+4. 执行最小验收：
+   - `openclaw doctor`
+   - `openclaw status`
+   - `openclaw dashboard`
+5. 任一步失败则进入统一排障流程
+
+## 标准执行步骤（SOP）
+
+### Step 0：读取关键入口
+
+- `README.md`
+- `docs/common/trae-ide-guide.md`
+- `docs/common/acceptance.md`
+- `docs/common/troubleshooting.md`
+- `docs/common/install-config-checklist.md`
+- 对应平台 `docs/platforms/<platform>/README.md`
+
+### Step 1：按平台脚本执行
+
+- Windows（WSL2）：
+  - `bash scripts/windows/wsl/setup.sh`
+  - `bash scripts/windows/wsl/start.sh`
+  - `bash scripts/windows/wsl/check.sh`
+- macOS：
+  - `bash scripts/macos/setup.sh`
+  - `bash scripts/macos/start.sh`
+  - `bash scripts/macos/check.sh`
+- Linux：
+  - `bash scripts/linux/setup.sh`
+  - `bash scripts/linux/start.sh`
+  - `bash scripts/linux/check.sh`
+
+如需 dashboard，可在 check 步骤追加 `--dashboard`。
+
+### Step 2：验收判定
+
+- 必须完成 `doctor/status/dashboard` 三项检查
+- 结论分为：通过 / 失败待修复
+
+### Step 3：失败分诊
+
+1. 保存首次报错行
+2. 重跑：
+   - `openclaw doctor`
+   - `openclaw status`
+3. 核对：
+   - `which node || true`
+   - `which openclaw || true`
+   - `node --version || true`
+   - `openclaw --version || true`
+4. 按 `docs/common/troubleshooting.md` 对应章节修复
+5. 每次只改一个变量并复验
+
+## 输出约定
+
+- 成功：给出平台、执行步骤、验收结果与可访问状态
+- 失败：给出首个错误、已验证动作、下一步修复建议
+
+## 约束
+
+- 优先复用仓库现有文档和脚本，不创建平行流程
+- 不写入真实密钥，仅使用示例配置
+- Windows 场景优先在 WSL2 Linux 文件系统执行