uniner-cli 1.0.1 → 1.0.2

package/lib/SKILL.md.template

@@ -8,6 +8,29 @@ description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作
 > 由 UninerCLI Installer v{{VERSION}} 自动安装到 `%USERPROFILE%\.claude\skills\uniner-cli\`
 > 安装位置（绝对路径）：`{{INSTALL_PATH}}`
 
+## 🛑 任务结束硬性规则（最重要，先读这一节）
+
+**每次用 uniner-cli 完成一个任务后，在你要说"任务完成"或写汇总表之前，必须先执行下面这段：**
+
+如果这次任务**满足任一条件**：
+
+- 调用了 ≥ 3 个 uniner-cli 命令
+- 涉及 web / desktop / OCR 任何一个模块
+- 用户提到过"以后还会跑" / "每天都要" / "做成自动化"
+- 任务里踩过坑（XPath 不稳、参数名错、Vue 组件、超时调整等）
+
+→ **必须主动问用户**："这个流程涉及多步，要不要保存为可重放场景？以后 `uniner-cli skill run <name> --param ...` 就能 0 token 重放，可以放定时任务/RPA 平台里跑。要保存吗？"
+
+不要等用户开口，**主动**问。这是最有价值的一步——你刚刚花了上千 token 调通的流程，沉淀下来下次就能秒跑。
+
+如果用户说"好" / "可以" / "保存吧"：按下面"场景沉淀（4 步流程）"章节执行。
+
+如果用户说"不用"：直接结束，不再追问。
+
+**违反这条规则 = 任务未完成。** 不管你跑得多顺，没问就是没问完整。
+
+---
+
 ## 何时使用本 Skill
 
 用户提到以下任一关键词或任务，**优先调用 uniner-cli**：
@@ -179,20 +202,9 @@ uniner-cli excel data write-range --file "{{INSTALL_PATH}}\workdir\out.xlsx" --c
 uniner-cli web browser close
 ```
 
-## 场景沉淀（重要：完成任务后主动建议保存）
-
-每完成一个完整 RPA 流程后，**主动建议**用户把它沉淀为可重放的场景。
-之后用户用 `uniner-cli skill run <name>` 即可 **0 token 重放**——
-不再需要 Claude，直接命令行就能跑、能放进定时任务 / Airflow / RPA 平台。
-
-### 何时建议保存
+## 场景沉淀（4 步流程）
 
-下面任一情况都该建议：
-- 任务跑完且至少调用了 ≥3 个 uniner-cli 命令
-- 任务里踩过坑（XPath 不稳、参数名错、Element UI 组件等）
-- 用户表达过 "以后还会跑"
-
-### 怎么保存：3 个文件 + 4 步流程
+> 这是顶部"任务结束硬性规则"提到的"4 步流程"。用户同意保存场景后，按这里走。
 
 每个场景一个目录，三件套：`meta.json` + `steps.json` + `SKILL.md`，存到：
 
@@ -326,20 +338,21 @@ Open Claude Code, paste this:
 
 客户复制这段给你 → 你 Read steps.json 调试 → 改完 `Write` 回去 → 让客户重跑。
 
-### 给 Claude 的对话范式
-
-完成任务后说类似的话（**主动询问，不等用户开口**）：
+### 给 Claude 的对话范式（用户同意保存后）
 
-> "这个流程涉及 OCR、Vue 组件、XPath 等不稳定环节，我帮你保存为可重放场景吧？以后你直接 `uniner-cli skill run <name>` 就能 0 token 重放，还能放定时任务里跑。要保存吗？"
-
-得到确认后：
+按这个顺序，**不要跳步**：
 
 1. 想一个 kebab-case 名字（如 `tms-export-waybills` / `sap-monthly-report`）
-2. Bash 跑 `uniner-cli skill init <name>`
-3. Write 写 meta.json（含动态参数 schema）+ steps.json（完整步骤 + 已知坑的避坑配置）+ SKILL.md（经验文档）
-4. Bash 跑 `uniner-cli skill validate <name>`
+2. Bash 跑 `uniner-cli skill init <name>`（生成骨架）
+3. Write 写**真正的**：
+   - `meta.json`：含动态参数 schema（URL / USERNAME / PASSWORD / DATE_FROM 等）
+   - `steps.json`：把刚才跑过的命令序列**完整**写进去，含已知坑的避坑配置（retry / on_fail / always_run）
+   - `SKILL.md`：经验文档（已知坑、用法说明）
+4. Bash 跑 `uniner-cli skill validate <name>` 确认格式无误
 5. 让用户 `uniner-cli skill run <name> --param ...` 自己跑一次确认 0 token 重放可行
 
+**关键**：steps.json 不是命令清单的注释——是**真正可执行的工作流**。要把 `${URL}` `${USERNAME}` `${ocrResult.data.result}` 这种变量绑好，让 `skill run` 真能跑通。
+
 ### 已沉淀的场景库
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "uniner-cli",
-    "version":  "1.0.1",
+    "version":  "1.0.2",
     "description":  "uniner-cli — RPA automation CLI: browser automation (Playwright/CDP), Excel, OCR, desktop/SAP, crypto/HTTP/email tools. Auto-installs a Claude Code skill on install.",
     "keywords":  [
                      "rpa",