@hupan56/wlkj 3.1.19 → 3.1.21

package/templates/qoder/skills/wl-spec/SKILL.md

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-spec — 生成开发 Spec（/wl-spec 命令入口）
 
@@ -22,13 +23,13 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- **当前身份**：当前开发者。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前开发者。读法：先 `R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：当前任务（决定 spec 存哪个 task 目录）。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：当前任务（决定 spec 存哪个 task 目录）。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 扫描 PRD 来源：`data/docs/prd/`（已发布）+
   `workspace/members/{dev}/drafts/REQ-*.md`（草稿），找出还没 Spec 的 PRD
-- 字段命名约定：`python "$R/.qoder/scripts/orchestration/wlkj.py" search --field <字段名>`
+- 字段命名约定：`$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --field <字段名>`
 - 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）见
   `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
 

package/templates/qoder/skills/wl-status/SKILL.md

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-status — 项目状态总览
 
@@ -22,8 +23,8 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls）
 
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-python "$R/.qoder/scripts/orchestration/wlkj.py" status-snapshot "$R"
+R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" status-snapshot "$R"
 ```
 
 这一个命令**一次返回全部所需数据**（JSON）：开发者、图谱新鲜度、EVA 历史、
@@ -103,7 +104,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" status-snapshot "$R"
 健康度展示后，**追加一个可用性看板**（让"工作流用没用起来"可视化）：
 
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" usability --html
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" usability --html
 ```
 
 - **QoderWork**：脚本自动调 `qoder_show_widget` 把交互看板（仪表盘 + 绿黄红指标条）**嵌入对话流**。

package/templates/qoder/skills/wl-task/SKILL.md

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-task — 任务管理（7 站之「任务」站 · 产品工位）
 
@@ -118,16 +119,16 @@ AI: ✅ 需求#761 已关联 build#22(本周) + #16(未来)
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- **当前身份**：当前开发者（assignee 默认值）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前开发者（assignee 默认值）。读法：先 `R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：当前活动任务（"开始做""完成了"默认对它操作）。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：当前活动任务（"开始做""完成了"默认对它操作）。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 列出已有任务：`cap.mcp.call("list_tasks", {})`
 - 衔接 PRD：扫 `workspace/members/{dev}/drafts/REQ-*.md` + `data/docs/prd/REQ-*.md`
 
 ## 🔒 三道前置检查（任何动作前先做，保证健壮）
 
-1. **身份检查**：跑 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`（否则 create 会把 assignee 写空）。
+1. **身份检查**：跑 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`（否则 create 会把 assignee 写空）。
 2. **空数据兜底**：tasks 目录不存在/空 → 读操作友好提示"还没有任务"，不报错；create 直接建。
 3. **脚本退出码**：`task.py` 返回非 0 → 原样读 stderr 告诉用户。`4`=权限不足（零信任 ACL），`1`=任务不存在/JSON 缺失。**绝不绕过 ACL。**
 

package/templates/qoder/skills/wl-test/SKILL.md

@@ -46,9 +46,9 @@ trigger: "user invokes /wl-* command explicitly"
 **③ 用例 JSON 必须用 `--cases-file` 传文件，禁止内联 `--cases`。**
 ```bash
 # ✅ 对: 写文件再传路径(不截断)
-python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases-file <文件路径> --env test --platform web
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases-file <文件路径> --env test --platform web
 # ❌ 错: 内联(长JSON截断, 多条用例必丢)
-python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
 ```
 
 **④ 无锚点时必须先 snapshot 拿真实 anchor 再填，禁止预猜 CSS selector。**
@@ -67,9 +67,9 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"
 **⑥ recall 的 `--url` 必须用相对路径（无前导斜杠），避开 Git-bash/MSYS 路径转换坑。**
 ```bash
 # ✅ 对: 相对路径 (MSYS 不转换)
-python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
 # ❌ 错: 前导斜杠会被 Windows Git-bash 转成 /D:/.../Git/auth/login
-python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
 ```
 （脚本已加 normalize 兜底能修这个，但别依赖兜底——直接写相对路径最干净。）
 
@@ -95,11 +95,12 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
 >
 > **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 > ```bash
-> R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+> R=$($PY ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 > ```
 > `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。
-> **后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`，不要再搜！**
-> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
+> **后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`，不要再搜！**
+> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 - `<R>/.qoder/.developer` — 当前开发者
 - `<R>/.qoder/config.yaml` 的 `autotest:` 段 — 环境/域名
@@ -112,7 +113,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
 
 **唯一正确做法**——1 条命令查 MySQL sys_menu 真实路由：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
 # → 保险管理 -> /veh/vehicle/vehAffair/insurance
 ```
 - 数据来自 MySQL `sys_menu` 表（后台动态菜单，**唯一事实源**）
@@ -165,7 +166,7 @@ coverage_matrix()
 
 **Step 0：recall 查锚点**（用相对 URL，避开 MSYS 坑）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
 ```
 - **有锚点** → 生成用例时直接把 anchor 填进 step（确定性命中，快、零 LLM）
 - **无锚点（首次）** → **先 navigate + snapshot 拿真实锚点，再生成用例**（见 Step 0.6）
@@ -212,8 +213,8 @@ snapshot 返回形如：
 
 **🎯 知道页面名/URL 时，AI 先查按钮+接口画像（最精准，1 条命令拿到所有交互点）：**
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" test page --kw 保险        # 按业务名查
-python "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance  # 按URL查
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --kw 保险        # 按业务名查
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance  # 按URL查
 ```
 （这是 AI 在 `/wl-test` 流程内部自动调用的工具，**用户只用 `/wl-test`，不碰此命令**。）
 输出每个按钮的 handler + 调用接口 + HTTP 方法 + 置信度，**直接对应到用例的 click→assert 断言点**。开发 `finish` 任务时也会自动生成 `test-handoff.md`，内容同此画像——交接场景直接读那份即可，不必重查。
@@ -245,7 +246,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance
 # AI 先写文件:
 #   写 workspace/members/{dev}/drafts/_autotest-cases.json
 # 再调:
-python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
   --cases-file workspace/members/{dev}/drafts/_autotest-cases.json \
   --desc "<用户描述>" --platform <web|app>
 ```
@@ -326,7 +327,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
 
 **执行方式**：把测试结果 + 测试中 `browser_snapshot` 看到的页面元素一起回传：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
   --cases-file <之前的cases文件> \
   --record '{"Q-1":"pass","Q-2":"pass","Q-3":"pass"}' \
   --page-json '{"url":"/veh/vehicle/vehAffair/insurance","elements":[{"role":"textbox","name":"车牌号"},{"role":"button","name":"搜索"},{"role":"button","name":"新增"}]}'
@@ -348,10 +349,10 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
 
 ```bash
 cap.mcp.call("list_tasks", {})                     # 确认任务存在
-python "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架到 autotest-cases.jsonl
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架到 autotest-cases.jsonl
 # AI 读任务 PRD「验收标准」补全 steps/expected (真实数据用 {{ask:}}, 不搜源码)
-python "$R/.qoder/scripts/orchestration/wlkj.py" test run <task>           # 注入+出执行计划
-python "$R/.qoder/scripts/orchestration/wlkj.py" test run <task> --record '{"..":"pass"}'  # 回收结果
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task>           # 注入+出执行计划
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task> --record '{"..":"pass"}'  # 回收结果
 ```
 
 **回归测试增强（图谱 MCP）**：测接口改动时，用 `get_impact` 查影响范围，自动覆盖受影响页面：
@@ -388,10 +389,10 @@ JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
 
 ```bash
 # 从任务 PRD 的验收标准章节抿断言
-python "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen --task <任务名> --page 保险
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen --task <任务名> --page 保险
 
 # 临时用 GWT 文本兜底（PRD 没写验收标准时）
-python "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
   --gwt "Given 已登录保险页 When 点击延期提交 Then 接口 /api/insurance/delay 返回 code=200 且 状态列显示审批中" \
   --page 保险
 ```
@@ -416,9 +417,9 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
   域名才放 config（全团队一致）。账号密码每人不同 → 个人文档。
 - **个人文档**：`workspace/members/{你的名字}/autotest-data.yaml`（gitignored，永不 push）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" test init-data                          # 生成模板
-python "$R/.qoder/scripts/orchestration/wlkj.py" test set-data 登录账号 test --env test   # 填(按环境/平台分块)
-python "$R/.qoder/scripts/orchestration/wlkj.py" test list-data --env test                # 查看(密码脱敏)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test init-data                          # 生成模板
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test set-data 登录账号 test --env test   # 填(按环境/平台分块)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test list-data --env test                # 查看(密码脱敏)
 ```
 run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆盖。
 
@@ -428,7 +429,7 @@ run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆
 
 **Step A：查登录态**
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
 ```
 
 **Step B：按登录态决定行为**
@@ -449,8 +450,8 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
 
 ```bash
 # 手动操作（一般不用，AI 会自动）:
-python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state mark --env pre --platform web   # 标记已登录
-python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state clear --env pre                 # 清除(强制重登录)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state mark --env pre --platform web   # 标记已登录
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state clear --env pre                 # 清除(强制重登录)
 ```
 
 ## 🧩 QoderWork 增强：浏览器自动执行（可选 · 无连接器则自动回退）