npm - @hupan56/wlkj - Versions diffs - 3.1.20 → 3.1.22 - Mend

@hupan56/wlkj 3.1.20 → 3.1.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.1.20",
+  "version": "3.1.22",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

package/templates/qoder/skills/design-import/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Design Import Skill（设计师专用）
@@ -29,14 +30,14 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 本 skill 用到的知识图谱 MCP 工具（`MCP 工具 (` / `MCP 工具 (`）**自动路由（有 MCP 走 MCP，无 MCP 走 CLI）**。
 - **QoderWork**：直接调 MCP 工具（更快更准）；Step 3 存储到知识图谱也走 MCP。
-- **Qoder IDE/Quest/CLI（无 MCP）**：用 `python "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级查样式；存储到知识图谱步骤跳过（spec.json 照常生成，本地可用）。
+- **Qoder IDE/Quest/CLI（无 MCP）**：用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级查样式；存储到知识图谱步骤跳过（spec.json 照常生成，本地可用）。
 ## ⚙️ 自取上下文（QoderWork 无 hook 注入，必须自读）
-- **当前身份**：当前设计师名（产出归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前设计师名（产出归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：若存在，spec 命名带上任务关键词。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：若存在，spec 命名带上任务关键词。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 平台必须明确（Web/APP/Both）；如未指定，先问
 **已录入清单**（设计师问"我录过哪些"时）：
@@ -106,7 +107,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 > 蓝湖 MCP 是 STDIO 模式：开 QoderWork 自动起、关自动停，**无需手动 start**。
 > cookie 按角色隔离在 `workspace/members/{当前用户}/.secrets/lanhu.env`（不进 git）——
 > wrapper（lanhu_stdio_wrapper.py）读当前 `.developer` 角色的 cookie 拉起服务，UI 角色有改稿权限、PM/开发只读。
-> 没配的话跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" setup-lanhu`；换角色改 `.developer` + 配新角色 cookie 后重启 QoderWork。
+> 没配的话跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" setup-lanhu`；换角色改 `.developer` + 配新角色 cookie 后重启 QoderWork。
 **方式 B：截图 + 口述**
 设计师发一张 Figma/Axure 截图，口述关键设计决策：
@@ -187,7 +188,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 spec.json 落盘后埋点，供 /wl-status 统计设计录入活跃度：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" learn record design_import "{\"requirement\": \"<需求名>\", \"platform\": \"<web|app>\", \"source\": \"<蓝湖|截图|导出>\"}"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record design_import "{\"requirement\": \"<需求名>\", \"platform\": \"<web|app>\", \"source\": \"<蓝湖|截图|导出>\"}"
 ```
 > 失败静默忽略。

package/templates/qoder/skills/design-review/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Design Review Skill（设计师 + PM 都可用）
@@ -23,12 +24,12 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 本 skill 用到的知识图谱 MCP 工具（`MCP 工具 (` / `MCP 工具 (`）**自动路由（有 MCP 走 MCP，无 MCP 走 CLI）**。
 - **QoderWork**：直接调 MCP 工具（更快更准）。
-- **Qoder IDE/Quest/CLI（无 MCP）**：用 `python "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级（`--style table|form|modal` / `--field <名>` / `--components`）；仅 MCP 有的能力（如 feature_overview/get_workflow）跳过或人工评估。
+- **Qoder IDE/Quest/CLI（无 MCP）**：用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级（`--style table|form|modal` / `--field <名>` / `--components`）；仅 MCP 有的能力（如 feature_overview/get_workflow）跳过或人工评估。
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-- **当前身份**：当前评审人。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前评审人。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - 设计文件路径由用户指定，或扫 `workspace/members/{dev}/drafts/prototype-*.html`
 - 若 `data/style/{需求名}-design-spec.json` 存在，作为评审基准（优先级最高）
@@ -84,7 +85,7 @@ PM 说"评审设计稿"，AI 检查设计师的 spec.json 或原型：
 评审输出报告后，**立即调用 learning 引擎记录本次评审**（让团队学习哪些设计问题最常见）：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"target\":\"{被评审的原型或spec}\",\"result\":\"PASS或问题数\",\"issues\":[\"严重问题1\",\"建议1\"]}"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"target\":\"{被评审的原型或spec}\",\"result\":\"PASS或问题数\",\"issues\":[\"严重问题1\",\"建议1\"]}"
 ```
 > 埋点失败不阻塞评审。数据进个人 journal，管理员聚合到 kg.duckdb 后，可统计"最常出现的设计问题"，反哺 design-import 防再犯。

package/templates/qoder/skills/prd-generator/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # PRD Generator Skill
@@ -39,20 +40,20 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`（输出任务路径；空=无活动任务）。
 - `data/index/.index-meta.json` — 知识图谱新鲜度
 ### 写 PRD 前：一次取全（prefetch 预测 + 批量预取）
 **写 PRD 第一件事：调 1 次 `prefetch`**（它会预测业务词 + 批量取多词上下文，合并去重）：
 ```bash
-ROLE=$(python "$R/.qoder/scripts/orchestration/wlkj.py" role 2>/dev/null || echo pm)
-python "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述>" --platform <p>
+ROLE=$($PY "$R/.qoder/scripts/orchestration/wlkj.py" role 2>/dev/null || echo pm)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述>" --platform <p>
 ```
-或直接：`python "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>`
+或直接：`$PY "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>`
 prefetch 一次返回 8 段（含历史PRD/数据库表/真实字段/API/Wiki），等于把多个业务词的查询合并。**prefetch 之后严禁再串行 search/find/grep**（这是轮次爆炸的根因——查一个词不命中就换词再查 6+ 次）。
@@ -142,10 +143,10 @@ prefetch 一次返回 8 段（含历史PRD/数据库表/真实字段/API/Wiki）
 ```bash
 # 门 1+2: 角色边界(当前角色能否产 prd?) + 契约校验(@contract 头是否合规?)
 # 软提示不阻塞, 越权/无契约头会提示但仍可发布
-python "$R/.qoder/scripts/foundation/identity/check_publish.py" prd <draft-prd.md>
+$PY "$R/.qoder/scripts/foundation/identity/check_publish.py" prd <draft-prd.md>
 # 门 3: 质量分 (eval_prd 内部也会跑契约校验, 这里是质量评分)
-python "$R/.qoder/scripts/orchestration/wlkj.py" eval <draft-prd.md> <prototype.html>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <draft-prd.md> <prototype.html>
 ```
 - check_publish 越权提示 → 软提示(如 dev 产 prd 会提示"建议产品经理"),不阻塞
 - eval_prd < 80% 不准发布，按报告修到 PASS
@@ -187,7 +188,7 @@ context_pack 字段段返回"无直接相关字段"时，**字段锁不报错，
 ## 取上下文 — 一次取全（不要逐个搜）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" context <关键词> --platform <web|app>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" context <关键词> --platform <web|app>
 ```
 返回 7 章节（代码+页面+字段+PRD+API+样式+Wiki）。**只读最相关 1-2 个 Vue 文件**。
@@ -210,7 +211,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" context <关键词> --platform
 ## 原型规则
 - 从模板开始（`.qoder/templates/prototype-{web|app}.html`），模板已有正确颜色与 mixed-nav 多级菜单骨架
-- 先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>` 拿 80% 草稿;
+- 先跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>` 拿 80% 草稿;
   它会按目标项目的 `layout_fingerprint` 自动填示例菜单骨架和真实字段,你只微调 20%
 - 颜色/布局指纹见 fill_prototype 输出的"设计 Token"段(布局模式/主色/侧边栏宽度)
 - **菜单层级**: 若需求描述了侧边栏/菜单结构(如"一级→二级,右侧三四级"),
@@ -225,7 +226,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" context <关键词> --platform
 PRD 写入 drafts 后，**顺手归档一份**到当前成员的按时间文件夹，方便人翻查"我那天做了啥"：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" archive-prd <刚生成的PRD文件路径>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" archive-prd <刚生成的PRD文件路径>
 ```
 > 归档产物：`workspace/members/{你的名字}/archive/{YYYY-MM-DD}/REQ-{编号}-{中文标题}.md`

package/templates/qoder/skills/prd-review/SKILL.md CHANGED Viewed

@@ -9,16 +9,17 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # PRD Review Skill
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-- **当前身份**：当前评审人。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前评审人。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - `data/index/.index-meta.json` — 图谱新鲜度（影响"现实锚定"能否校验）
 - 评审的 PRD 文件路径由用户指定；若用户没给路径，扫 `data/docs/prd/` 和
@@ -42,7 +43,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 跑一次 EVA 门禁给出客观分数：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD路径> [原型HTML路径]
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD路径> [原型HTML路径]
 ```
 分数 ≥80% 才能发布。低于 80% 把 EVA 报告的问题合并进上面的清单。
@@ -50,6 +51,6 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD路径> [原型HTML路
 评审出结论（无论 PASS/打回）后埋点，供 /wl-status 统计评审活跃度：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<PRD文件名>\", \"verdict\": \"<PASS|打回>\", \"score\": <EVA分数或空>}"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<PRD文件名>\", \"verdict\": \"<PASS|打回>\", \"score\": <EVA分数或空>}"
 ```
 > 失败静默忽略。

package/templates/qoder/skills/prototype-generator/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Prototype Generator
@@ -22,12 +23,12 @@ Generate production-ready HTML prototypes that match the project's actual UI sty
 本 skill 用到的知识图谱 MCP 工具（`MCP 工具 (` / `MCP 工具 (`）**自动路由（有 MCP 走 MCP，无 MCP 走 CLI）**。
 - **QoderWork**：直接调 MCP 工具（更快更准）。
-- **Qoder IDE/Quest/CLI（无 MCP）**：用 `python "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级（`--style` / `--field <名>` / `--vben` / `--components`）；仅 MCP 有的能力（如 fill_prototype/context_pack）跳过或人工补。
+- **Qoder IDE/Quest/CLI（无 MCP）**：用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" search` 降级（`--style` / `--field <名>` / `--vben` / `--components`）；仅 MCP 有的能力（如 fill_prototype/context_pack）跳过或人工补。
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-- **当前身份**：决定产出存到 `workspace/members/{dev}/drafts/`。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：决定产出存到 `workspace/members/{dev}/drafts/`。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - 若 `.qoder/.current-task` 存在，原型命名带上任务关键词
 - 平台（Web/APP/Both）必须明确；如未指定，先问用户（见 prd-generator Step 0）
@@ -94,7 +95,7 @@ cap.mcp.call("get_design_system", {"platform": "web"})
 ```
 **FALLBACK: Read file directly:**
-Read `data/design/DESIGN.md`. If missing, run `python "$R/.qoder/scripts/orchestration/wlkj.py" design-doc`.
+Read `data/design/DESIGN.md`. If missing, run `$PY "$R/.qoder/scripts/orchestration/wlkj.py" design-doc`.
 Returns: layout fingerprint (sidebar 160px, mixed-nav), token set (primary HSL),
 page type patterns, form behavior modes, icon rules, component stats.
@@ -119,7 +120,7 @@ cap.mcp.call("fill_prototype", {"keyword": "营业外合同", "platform": "web"}
 **FALLBACK: Run script:**
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>
 ```
 Returns: 80% complete HTML draft (real columns/fields/layout injected) + data manifest.
@@ -173,9 +174,9 @@ cap.mcp.call("search_wiki", {"keyword": "资产"})
 **FALLBACK: Python scripts:**
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" search --style <table|form|detail|modal|dashboard> --platform <web|app>
-python "$R/.qoder/scripts/orchestration/wlkj.py" search <keyword> --platform <web|app>
-python "$R/.qoder/scripts/orchestration/wlkj.py" search --field <field_name>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --style <table|form|detail|modal|dashboard> --platform <web|app>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" search <keyword> --platform <web|app>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --field <field_name>
 ```
 Then read the TOP 2-3 most similar existing Vue files to extract:

package/templates/qoder/skills/spec-coder/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Spec Coder
@@ -25,10 +26,10 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：当前任务（含任务相关的 Spec 路径）。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：当前任务（含任务相关的 Spec 路径）。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - Spec 文件位置：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
 - 目标代码库：`data/code/`（fywl-ics 后端 / fywl-ui 前端 / Carmg-H5 移动端）

package/templates/qoder/skills/spec-generator/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Spec Generator
@@ -23,13 +24,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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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 金额）写在本 skill 的 Step 3
 ## Step 1: 定位 PRD

package/templates/qoder/skills/test-generator/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`。
 # Test Generator
@@ -25,14 +26,14 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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`（输出任务路径；空=无活动任务）。
 - Spec 文件：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
 - 已实现代码：用 search_index.py 定位
   ```bash
-  python "$R/.qoder/scripts/orchestration/wlkj.py" search <类名或模块关键词>
+  $PY "$R/.qoder/scripts/orchestration/wlkj.py" search <类名或模块关键词>
   ```
 ## Step 1: 定位待测代码
@@ -50,7 +51,7 @@ ls data/code/                     # 已实现代码库
 2. **Spec 文件**（推荐）：测试用例映射来源
 3. **现有测试代码**（推荐）：用 search_index.py 找同类 Test 类，照着写
    ```bash
-   python "$R/.qoder/scripts/orchestration/wlkj.py" search Test
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" search Test
    ```
 ## Step 3: 生成测试

package/templates/qoder/skills/wl-code/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-code — 按 Spec 实现代码（/wl-code 命令入口）
@@ -22,10 +23,10 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：当前活动任务（找对应的 spec）。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：当前活动任务（找对应的 spec）。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 活动任务的 spec：`workspace/specs/` 或 `workspace/tasks/{id}/spec.md`
 ### ⚡ 取全一次到位（spec 里的模块名 → 1 次 context_pack 拿全）
@@ -41,7 +42,7 @@ cap.mcp.call("context_pack", {"keyword": "..."}) <模块关键词> --platform <w
 ### 改表/改 Entity 前必查（用知识图谱 MCP，防改崩）
 > ⚠️ 本段依赖知识图谱 MCP（`cap.mcp.call("search_code", ...)` / `cap.mcp.call("query_schema", ...)`），自动路由。
-> Qoder IDE/Quest/CLI 无 MCP 时：table_impact 无脚本等价，需人工评估改动波及面；真实字段可用 `python "$R/.qoder/scripts/orchestration/wlkj.py" search --field <表名>` 查代码侧字段（不含 DB 真实列类型）。
+> Qoder IDE/Quest/CLI 无 MCP 时：table_impact 无脚本等价，需人工评估改动波及面；真实字段可用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --field <表名>` 查代码侧字段（不含 DB 真实列类型）。
 1. **改表影响分析**：涉及改数据库表/Entity 时，先 `cap.mcp.call("table_impact", {"table": "表名"})`
    - 查这张表关联哪些 Entity + 影响哪些 Controller/接口。

package/templates/qoder/skills/wl-commit/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-commit — 代码提交 + 质量门禁 + 同步
@@ -21,11 +22,11 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - 当前工作目录的 `git status` 和 `git diff --stat` 看改了什么
-- **活动任务**：若有活动任务，提交信息关联任务 ID。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：若有活动任务，提交信息关联任务 ID。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 ## 执行流程
@@ -83,7 +84,7 @@ git push
 提交成功后埋点（写当前开发者的 journal，供 /wl-status 健康度统计）：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" learn record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
 ```
 > 失败静默忽略，绝不阻塞提交流程。

package/templates/qoder/skills/wl-design/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-design — 设计工序入口（/wl-design 命令入口）
@@ -36,10 +37,10 @@ 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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
-- **活动任务**：若存在，spec/原型命名带上任务关键词。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
+- **活动任务**：若存在，spec/原型命名带上任务关键词。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 平台必须明确（Web/APP/Both）；如未指定，先问
 - 风格真源：`data/style/*-design-spec.json`（优先）→ `data/code/` 源码 → `data/index/vben-style-reference.json`（Web）/ Vant（APP）

package/templates/qoder/skills/wl-init/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-init — 开发者身份 + 环境体检
@@ -28,14 +29,14 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ### 无参数（仅体检）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" doctor
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor
 ```
 输出 8 段体检报告，每行 `[OK]/[WARN]/[FIX]/[MISS]` 标注。
 ### 带名字（注册 + 自愈）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix <名字> [角色]
-# 例：python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 pm
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix <名字> [角色]
+# 例：$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 pm
 ```
 做 3 件事：
 1. 写 `.qoder/.developer`（key=value 格式）
@@ -44,7 +45,7 @@ python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix <名字> [角色]
 ### 仅自愈（不换人）
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix
 ```
 ## 体检覆盖的 8 段

package/templates/qoder/skills/wl-insight/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-insight — 需求探索（7 站之前的「探索站」· 产品工位）
@@ -54,12 +55,12 @@ insight（探索/调研/规划）→ [用户确认转PRD] → prd（落地）→
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-- **当前身份**：当前探索者（报告归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
-  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+- **当前身份**：当前探索者（报告归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - **现状锚点（必跑，只跑这一次）**：用 prefetch 一次取全，不要串行换词搜：
   ```bash
-  python "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述原句>"
+  $PY "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述原句>"
   ```
   > **不传 `--platform` = 默认双平台一次返回**（platform: all）。探索阶段需求常未定平台，
   > 直接默认双平台拿全，**绝不 web 跑一次、app 再跑一次**（这是 insight 慢的 #2 元凶）。
@@ -76,7 +77,7 @@ insight（探索/调研/规划）→ [用户确认转PRD] → prd（落地）→
 ## 🔒 三道前置检查（任何动作前先做）
-1. **身份检查**：跑 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`
+1. **身份检查**：跑 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`
 2. **现状锚点**：任何探索前先跑 **1 次** `kg.py prefetch "<需求句>"`（见上方自取上下文段）。**不锚定现状的探索 = 凭空臆想，禁止。禁止串行换词搜。**
 3. **报告归属**：报告必须写到 `workspace/members/{dev}/drafts/`，用 `.developer` 归属。

package/templates/qoder/skills/wl-prd-full/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-prd-full — 完整档 PRD + 原型（/wl-prd-full 命令入口）
@@ -89,10 +90,10 @@ Read 指定 insight 报告 → 把现状锚定 + 选中的机会/Gap 作为 PRD
 ## 完整流程（详细见 command 文件）
-1. **并行取全上下文**：先读当前角色（`python "$R/.qoder/scripts/orchestration/wlkj.py" role` 输出 pm/design/dev/test/admin 之一），用 prefetch 一次取全（完整档需求含多业务实体，prefetch 多词预测比单词 context 更准）：
+1. **并行取全上下文**：先读当前角色（`$PY "$R/.qoder/scripts/orchestration/wlkj.py" role` 输出 pm/design/dev/test/admin 之一），用 prefetch 一次取全（完整档需求含多业务实体，prefetch 多词预测比单词 context 更准）：
    ```bash
-   ROLE=$(python "$R/.qoder/scripts/orchestration/wlkj.py" role 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述原句>" --platform <p>
+   ROLE=$($PY "$R/.qoder/scripts/orchestration/wlkj.py" role 2>/dev/null || echo pm)
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述原句>" --platform <p>
    ```
    > prefetch 把需求句拆成多个业务词批量搜、一次合并（例"考勤导入校验"→考勤/导入两词全搜）。
    > 拿到后**按 $ROLE 视角看重点**：dev 看代码段、design 看页面+风格段、pm 看字段+历史PRD段。prefetch 之后不要再串行 search。
@@ -103,7 +104,7 @@ Read 指定 insight 报告 → 把现状锚定 + 选中的机会/Gap 作为 PRD
    - **原型按 Step 0.5 决策**：用户选"画"→ 走 prototype-generator（必须先 fill_prototype）；
      用户选"不画"→ 跳过，PRD 第 11 章写 `无` + contract 头标 `prototype: none`
    - 3 道质量锁：背景锁/字段锁/闭环锁 → eval_prd（**不要加 `2>/dev/null`，stderr 阻断原因要看**）→ 不过自动修
-   - eval 命令：`python "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]`
+   - eval 命令：`$PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]`
      （wlkj.py eval 内部映射 validation/metrics/eval_prd.py，路径不会漂移）
 4. **发布 + 归档 + 同步**（3 合 1）：collect_prds → team_sync push → archive_prd

package/templates/qoder/skills/wl-prd-quick/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-prd-quick — 小改动极速出 Mini-PRD（/wl-prd-quick 命令入口）
@@ -40,7 +41,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 1. **先 prefetch（预测 + 批量预取，禁止串行 search）**：
    ```bash
-   python "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>
    ```
    prefetch 一次返回代码/字段/API/Wiki/历史PRD 的合并结果。**之后不要再用 search/find/grep 逐个查词**——那会变成 6+ 次串行往返，是轮次爆炸的根因。prefetch 不够时才补调一次。
 2. 一次 Write：Mini-PRD（prd-quick-template.md，6 章）+ 微型原型（只画 diff）

package/templates/qoder/skills/wl-prd-review/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-prd-review — 评审 PRD 质量（/wl-prd-review 命令入口）
@@ -24,7 +25,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 拿到一份 PRD，检查它够不够格发布/交付下游：
 1. **7 项 checklist**：用户故事清晰 / 验收可测 / 优先级已标 / 模块已识别 / 非功能已列 / 边界已考虑 / 依赖已识别
-2. **EVA 客观评分**：`python "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD> [原型]`，≥80% 才 PASS
+2. **EVA 客观评分**：`$PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD> [原型]`，≥80% 才 PASS
 3. **合并报告**：PASS → 可发布；不 PASS → 修复清单
 ## 定位要评审的 PRD
@@ -39,7 +40,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 这是「可用性指标 F2 转化漏斗」评审级数据的唯一来源，不埋则该级永远为 0：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<被评审PRD文件名>\", \"verdict\": \"PASS\"}"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<被评审PRD文件名>\", \"verdict\": \"PASS\"}"
 ```
 - `verdict`：评审结论，`PASS` 或 `FAIL`
 - 埋点失败不阻塞评审（包在 try 里无所谓），但能埋一定要埋。

package/templates/qoder/skills/wl-report/SKILL.md CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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-report — 日报 / 周报（按开发者隔离）
@@ -22,9 +23,9 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls/git log）
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R"           # 日报
-python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R" --days 7  # 周报
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R"           # 日报
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R" --days 7  # 周报
 ```
 这一个命令**一次返回全部所需数据**（JSON，全部已按当前开发者过滤）：
@@ -120,8 +121,8 @@ cap.mcp.call("sync", {"direction": "push"})
 ### 方式 B: webhook（任何环境，脚本化）
 如果没有连接器，用引擎自带的 webhook 推送：
 ```bash
-python "$R/.qoder/scripts/orchestration/wlkj.py" report daily --push-feishu
-python "$R/.qoder/scripts/orchestration/wlkj.py" report weekly --push-feishu
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" report daily --push-feishu
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" report weekly --push-feishu
 ```
 这会通过 config.yaml 里配的飞书 bot webhook 发卡片通知。
 两种方式不冲突，连接器更富交互，webhook 更可靠无依赖。

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

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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 CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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 CHANGED Viewed

@@ -9,9 +9,10 @@ trigger: "user invokes /wl-* command explicitly"
 **后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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 CHANGED Viewed

@@ -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=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.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 增强：浏览器自动执行（可选 · 无连接器则自动回退）