@hupan56/wlkj 3.0.0 → 3.1.2

package/templates/qoder/scripts/{test → validation/test}/page_probe.py

@@ -1,7 +1,12 @@
 # -*- coding: utf-8 -*-
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
 
@@ -41,11 +46,11 @@ if sys.platform == 'win32':
 _THIS_DIR = os.path.dirname(os.path.abspath(__file__))
 if _THIS_DIR not in sys.path:
     sys.path.insert(0, _THIS_DIR)
-_COMMON = os.path.join(_THIS_DIR, 'common')
+_COMMON = os.path.join(_THIS_DIR, 'foundation')
 if _COMMON not in sys.path:
     sys.path.insert(0, _COMMON)
 
-from common.paths import get_repo_root  # noqa: E402
+from foundation.core.paths import get_repo_root  # noqa: E402
 
 
 # ============================================================

package/templates/qoder/scripts/validation/test/smoke_all_commands.py

@@ -0,0 +1,170 @@
+from foundation.core.paths import get_repo_root
+#!/usr/bin/env python3
+"""
+smoke_all_commands.py — 全角色 × 全命令底层脚本健康度实测
+
+目的: 验证本轮"思考链短/调用少/不降性能"优化后, 每个 /wl-* 命令依赖的底层脚本
+仍然健康可用 + 记录耗时/调用次数, 供优化前后对比。
+
+为什么测"底层脚本"而非"完整 AI 命令链":
+  完整命令链要真实 AI 多轮交互, 无法脚本化。但每个命令的健康度 = 它调用的底层
+  脚本(context_pack/prefetch/report_snapshot/status_snapshot/task/grep-text)能否
+  跑通。这些跑通 = 命令链能执行的前提。耗时也直接反映"不降性能"。
+
+按角色分组 (AGENTS.md 的 5 角色), 每角色跑其核心命令的底层脚本。
+输出: 每命令 [PASS/FAIL] + 耗时 + 调用次数, 汇总成表。
+
+用法:
+  python smoke_all_commands.py            # 跑全部
+  python smoke_all_commands.py --quick    # 只跑快命令(跳过慢的 git 扫描)
+"""
+import os
+import subprocess
+import sys
+import time
+from datetime import datetime
+
+REPO = get_repo_root()
+
+
+def _run(label, script_args, timeout=90):
+    """跑一个底层脚本, 返回 (pass, ms, calls, note)。calls 固定=1(本脚本设计为单次聚合)。"""
+    t0 = time.time()
+    try:
+        r = subprocess.run(
+            [sys.executable] + script_args, cwd=REPO, capture_output=True,
+            text=True, timeout=timeout, encoding="utf-8", errors="replace")
+        ms = int((time.time() - t0) * 1000)
+        ok = r.returncode == 0 and bool(r.stdout.strip())
+        note = "" if ok else (r.stderr.strip()[:120] or f"exit={r.returncode},empty out")
+        return (label, ok, ms, 1, note)
+    except subprocess.TimeoutExpired:
+        return (label, False, int((time.time() - t0) * 1000), 1, "TIMEOUT")
+    except Exception as e:
+        return (label, False, int((time.time() - t0) * 1000), 1, str(e)[:120])
+
+
+def _kg(subcmd_args):
+    return _run_args(".qoder/scripts/domain/kg/kg.py", subcmd_args)
+
+
+def _run_args(script_rel, subcmd_args):
+    return [os.path.join(REPO, script_rel)] + subcmd_args
+
+
+# ── 每角色的命令 → 底层脚本映射 ──
+# (角色, 命令, 描述, 脚本调用列表)
+CHECKS = [
+    # PM 角色 (/wl-prd 合并了原 full/quick/review 三档, 这里覆盖两档路由)
+    ("pm", "wl-prd", "prefetch 多词取全(完整档)",
+     lambda: _run("prefetch", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["prefetch", "考勤导入校验", "--platform", "web"]))),
+    ("pm", "wl-prd", "prefetch 取全(快速档)",
+     lambda: _run("prefetch-quick", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["prefetch", "保险统计", "--platform", "web"]))),
+    ("pm", "wl-insight", "context 取全",
+     lambda: _run("context", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["context", "考勤", "--platform", "web"]))),
+    ("pm", "wl-task", "task list",
+     lambda: _run("task-list", _run_args(".qoder/scripts/domain/task/task.py", ["list"]))),
+
+    # Design 角色
+    ("design", "wl-design", "context 取全(扫描)",
+     lambda: _run("context-design", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["context", "保险", "--platform", "web", "--role", "design"]))),
+
+    # Dev 角色
+    ("dev", "wl-code", "context 取全(代码视角)",
+     lambda: _run("context-dev", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["context", "考勤", "--platform", "web", "--role", "dev"]))),
+    ("dev", "wl-commit", "git status(只读)", None),
+    # test 角色
+    ("test", "wl-test", "context 取全(test视角)",
+     lambda: _run("context-test", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["context", "登录", "--platform", "app", "--role", "test"]))),
+
+    # Admin 角色
+    ("admin", "wl-status", "status_snapshot 聚合",
+     lambda: _run("status-snapshot",
+                  _run_args(".qoder/scripts/domain/report/status_snapshot.py", [REPO]))),
+    ("admin", "wl-report", "report_snapshot 聚合",
+     lambda: _run("report-snapshot",
+                  _run_args(".qoder/scripts/domain/report/report_snapshot.py", [REPO]))),
+    ("admin", "wl-init", "init_doctor",
+     lambda: _run("init-doctor",
+                  _run_args(".qoder/scripts/deployment/setup/init_doctor.py", []))),
+
+    # 全员通用
+    ("all", "wl-search", "context(代码类)",
+     lambda: _run("search-context", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["context", "保险", "--platform", "web"]))),
+    ("all", "wl-search", "grep-text(中文文案)",
+     lambda: _run("grep-text", _run_args(".qoder/scripts/domain/kg/kg.py",
+                  ["grep-text", "车辆不存在"]))),
+]
+
+
+def main():
+    quick = "--quick" in sys.argv
+    print("=" * 70)
+    print(f"  全角色 × 全命令 底层脚本实测  ({datetime.now():%Y-%m-%d %H:%M})")
+    print("=" * 70)
+
+    results = []
+    cur_role = None
+    for role, cmd, desc, fn in CHECKS:
+        if quick and cmd in ("wl-init",):  # init_doctor 较慢
+            continue
+        if role != cur_role:
+            cur_role = role
+            print(f"\n── {role.upper()} ──")
+        # wl-commit 特殊处理: 直接跑 git status
+        if cmd == "wl-commit":
+            r = _run_git_status()
+        elif fn is None:
+            continue
+        else:
+            r = fn()
+        results.append((role, cmd, desc, *r))
+        label, ok, ms, calls, note = r
+        mark = "✓" if ok else "✗"
+        line = f"  {mark} {cmd:14s} {desc:24s} {ms:6d}ms  {calls}调用"
+        if note:
+            line += f"  ⚠ {note[:50]}"
+        print(line)
+
+    # 汇总: results 元组 = (role, cmd, desc, label, ok, ms, calls, note)
+    #        ok 在索引 4, ms 在 5, calls 在 6, note 在 7
+    passed = sum(1 for r in results if r[4])
+    total = len(results)
+    fails = [r for r in results if not r[4]]
+    avg_ms = sum(r[5] for r in results) // total if total else 0
+    total_calls = sum(r[6] for r in results)
+    print("\n" + "=" * 70)
+    print(f"  汇总: {passed}/{total} PASS  |  平均 {avg_ms}ms  |  总调用 {total_calls} 次")
+    if fails:
+        print(f"  ⚠ {len(fails)} 个失败:")
+        for r in fails:
+            print(f"    {r[1]} ({r[2]}): {r[7]}")
+    else:
+        print("  ✓ 全部健康, 命令链可执行")
+    print("=" * 70)
+    return 0 if not fails else 1
+
+
+def _run_git_status():
+    """wl-commit Step1 合并后的 git 命令: status + diff HEAD --stat 一条。"""
+    t0 = time.time()
+    try:
+        r = subprocess.run("git status && git diff HEAD --stat",
+                           cwd=REPO, capture_output=True, text=True, timeout=10,
+                           encoding="utf-8", errors="replace", shell=True)
+        ms = int((time.time() - t0) * 1000)
+        ok = r.returncode == 0
+        return ("git-status", ok, ms, 1, "" if ok else r.stderr[:80])
+    except Exception as e:
+        return ("git-status", False, int((time.time() - t0) * 1000), 1, str(e)[:80])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/templates/qoder/settings.json

@@ -39,6 +39,36 @@
           }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "command": "python .qoder/hooks/user-prompt-submit.py || python3 .qoder/hooks/user-prompt-submit.py"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "command": "python .qoder/hooks/post-tool-use.py || python3 .qoder/hooks/post-tool-use.py"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "command": "python .qoder/hooks/stop-eval.py || python3 .qoder/hooks/stop-eval.py"
+          }
+        ]
+      }
     ]
   }
 }

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

@@ -11,11 +11,11 @@ trigger: "user invokes /wl-* command explicitly"
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # Design Import Skill（设计师专用）
 
-> 🚫 **边界铁律：蓝湖工具（`mcp__lanhu__*`）只能在本 skill（即 `/wl-design 预览`）内部调用。**
+> 🚫 **边界铁律：蓝湖工具（`MCP 工具 (`）只能在本 skill（即 `/wl-design 预览`）内部调用。**
 > 用户直接说"查蓝湖""读一下这个蓝湖链接"而没走录入命令时，**不要裸调蓝湖**——先确认意图，
 > 引导到 `/wl-design 预览 <蓝湖链接>`。工作流是非侵入式的，所有能力必须经命令/工序站触发，
 > 不能脱离流程裸调工具（否则不可控、不可审计）。
@@ -24,10 +24,19 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 存到 `data/style/`，进入知识图谱。从此同需求的 AI 原型优先锚定这份 spec，
 不再跟设计师的稿打架。
 
+## 🔌 MCP 工具可用性（双轨）
+
+本 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 照常生成，本地可用）。
+
 ## ⚙️ 自取上下文（QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前设计师名（产出归属）
-- `.qoder/.current-task` — 若存在，spec 命名带上任务关键词
+- **当前身份**：当前设计师名（产出归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
+- **活动任务**：若存在，spec 命名带上任务关键词。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 - 平台必须明确（Web/APP/Both）；如未指定，先问
 
 **已录入清单**（设计师问"我录过哪些"时）：
@@ -51,7 +60,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 
 **A-1. 探测蓝湖可用性（失败就静默降级）**
 ```
-调 mcp__lanhu__get_designs(url=<链接>)
+调 cap.mcp.call("get_designs", {"url": "<链接>"})
 ```
 - 返回设计图列表 → 继续 A-2
 - 报"连接失败"/工具不存在/418（cookie 失效）→ **立刻降级**：告诉用户"蓝湖没起/cookie 失效，改用截图口述"，然后走方式 B，**不许卡住**
@@ -60,7 +69,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 
 **A-2. 选设计图（图多时帮用户缩小范围）**
 ```
-调 mcp__lanhu__get_designs(url=<链接>)  → 返回 {designs:[{name, width, height, ...}], sectors:[...], total_designs}
+调 cap.mcp.call("get_designs", {"url": "<链接>"})  → 返回 {designs:[{name, width, height, ...}], sectors:[...], total_designs}
 ```
 - **图少（≤15 张）**：直接列全部图名，问"录入哪张？"（**问了就停**）
 - **图多（>15 张）**：别一次倒几百张，先帮缩小：
@@ -71,9 +80,9 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 
 **A-3. 读标注 + 切图**
 ```
-调 mcp__lanhu__get_ai_analyze_design_result(url=<链接>, design_names=[<选中的图名>])
+调 cap.mcp.call("get_ai_analyze_design_result", {"url": "<链接>", "design_names": "[<选中的图名>]"})
   → 返回: HTML/CSS 标注 (rgba 值、width、padding、font...) + 还原指引
-调 mcp__lanhu__get_design_slices(url=<链接>, design_name=<图名>, include_metadata=true)
+调 cap.mcp.call("get_design_slices", {"url": "<链接>", "design_name": "<图名>", "include_metadata": "true"})
   → 返回: {slices:[{name, size, download_url, svg_url, scale_urls:{1x,2x,3x}}]}
 ```
 - CSS 标注 → 填 `design_tokens`/`layout`/`components`
@@ -97,7 +106,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/setup/setup_lanhu.py"`；换角色改 `.developer` + 配新角色 cookie 后重启 QoderWork。
+> 没配的话跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" setup-lanhu`；换角色改 `.developer` + 配新角色 cookie 后重启 QoderWork。
 
 **方式 B：截图 + 口述**
 设计师发一张 Figma/Axure 截图，口述关键设计决策：
@@ -178,7 +187,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 
 spec.json 落盘后埋点，供 /wl-status 统计设计录入活跃度：
 ```bash
-python "$R/.qoder/scripts/report/learn.py" record design_import "{\"requirement\": \"<需求名>\", \"platform\": \"<web|app>\", \"source\": \"<蓝湖|截图|导出>\"}"
+python "$R/.qoder/scripts/orchestration/wlkj.py" learn record design_import "{\"requirement\": \"<需求名>\", \"platform\": \"<web|app>\", \"source\": \"<蓝湖|截图|导出>\"}"
 ```
 > 失败静默忽略。
 
@@ -202,7 +211,7 @@ python "$R/.qoder/scripts/report/learn.py" record design_import "{\"requirement\
 
 ## 铁律
 
-- **有蓝湖 MCP 时优先用它直读**：设计师发蓝湖链接，AI 调 `mcp__lanhu__*` 提取精确参数，
+- **有蓝湖 MCP 时优先用它直读**：设计师发蓝湖链接，AI 调 `MCP 工具 (` 提取精确参数，
   不要让设计师截图口述（截图口述是蓝湖不可用时的降级方案）
 - **绝不编造 token**：设计师没说的值，留空或标"待确认"，不要自己猜
 - **图标必须来自真源**：即使设计师用了 emoji 示意，录入时也要替换成系统真源
@@ -213,9 +222,9 @@ python "$R/.qoder/scripts/report/learn.py" record design_import "{\"requirement\
 
 设计师录入 spec 前，可以先问 AI 系统现状，让 spec 更贴合系统：
 
-- **"这个功能模块现在有哪些页面？"** → AI 调 `mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')`
+- **"这个功能模块现在有哪些页面？"** → AI 调 `cap.mcp.call("feature_overview", {"feature": "资产管理"})`
   返回该模块所有页面 + API + 按钮，设计师知道改哪些、加哪些
-- **"这个模块的业务流程是什么？"** → AI 调 `mcp__qoder-knowledge-graph__get_workflow(module='资产')`
+- **"这个模块的业务流程是什么？"** → AI 调 `cap.mcp.call("get_workflow", {"module": "资产"})`
   返回操作链（查询→新增→审批→...），spec 里的交互流程跟系统一致
 - **"系统里这个模块的按钮都叫什么？"** → 看 DESIGN.md 的 "Real Button Texts" 段
   或 entity-registry.json，spec 里的按钮文案跟系统统一

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

@@ -11,16 +11,25 @@ trigger: "user invokes /wl-* command explicitly"
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # Design Review Skill（设计师 + PM 都可用）
 
-> 🚫 **边界铁律：蓝湖工具（`mcp__lanhu__*`）只能在本 skill（即 `/wl-design 评审`）内部调用。**
+> 🚫 **边界铁律：蓝湖工具（`MCP 工具 (`）只能在本 skill（即 `/wl-design 评审`）内部调用。**
 > 用户直接说"用蓝湖对比一下"而没走评审命令时，引导到 `/wl-design 评审`。非侵入式，不裸调。
 
+## 🔌 MCP 工具可用性（双轨）
+
+本 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）跳过或人工评估。
+
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前评审人
+- **当前身份**：当前评审人。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - 设计文件路径由用户指定，或扫 `workspace/members/{dev}/drafts/prototype-*.html`
 - 若 `data/style/{需求名}-design-spec.json` 存在，作为评审基准（优先级最高）
 
@@ -56,15 +65,15 @@ PM 说"评审设计稿"，AI 检查设计师的 spec.json 或原型：
 - [ ] **🆕 按钮文案是否用了系统真实文案**（对照 DESIGN.md 的 "Real Button Texts" 段或 entity-registry，别用编的"新增/编辑"）
 - [ ] **🆕 布局是否跟同功能模块的标杆页面一致**（对照 DESIGN.md 的 "Feature Modules" 段）
 - [ ] **🆕 侧边栏宽度是否 = layout_fingerprint 的值**（fywl-ui 是 160px，不是 200px）
-- [ ] **🆕 若 spec 有 `lanhu_source`：原型配色是否忠于蓝湖原图**（调 `mcp__lanhu__get_ai_analyze_design_result` 拉蓝湖 CSS，逐项比原型 `:root` 的值是否一致；不一致=还原度问题）
+- [ ] **🆕 若 spec 有 `lanhu_source`：原型配色是否忠于蓝湖原图**（调 `cap.mcp.call("get_ai_analyze_design_result` 拉蓝湖 CSS，逐项比原型 `:root` 的值是否一致；不一致=还原度问题）
 - [ ] **🆕 若 spec 有 `icons`：原型图标是否用了蓝湖切图**（别退回 emoji 或通用图标）
 
 **评审时可调 MCP 工具辅助：**
-- `mcp__qoder-knowledge-graph__feature_overview(feature='XX')` → 看这个功能模块的完整画像，对比原型是否遗漏页面/按钮
-- `mcp__qoder-knowledge-graph__get_design_system(platform='web')` → 拿到真实 token/按钮文案/模块标杆做对照
-- **`mcp__qoder-knowledge-graph__get_workflow(module='XX')`** → 查业务操作链（查询→新增→审批→...），检查原型是否覆盖了完整交互流程（而不只是静态页面）
-- **`mcp__coverage_matrix()`** → 查这个功能有没有测试覆盖，如果原型要改的页面有测试，提醒"改动后需回归测试"
-- **`mcp__lanhu__get_ai_analyze_design_result`** → spec 有 lanhu_source 时，拉蓝湖原图 CSS 做还原度比对（蓝湖不可用则跳过此项，不阻塞）
+- `cap.mcp.call("feature_overview", {"feature": "XX"})` → 看这个功能模块的完整画像，对比原型是否遗漏页面/按钮
+- `cap.mcp.call("get_design_system", {"platform": "web"})` → 拿到真实 token/按钮文案/模块标杆做对照
+- **`cap.mcp.call("get_workflow", {"module": "XX"})`** → 查业务操作链（查询→新增→审批→...），检查原型是否覆盖了完整交互流程（而不只是静态页面）
+- **`cap.mcp.call("coverage_matrix", {})`** → 查这个功能有没有测试覆盖，如果原型要改的页面有测试，提醒"改动后需回归测试"
+- **`cap.mcp.call("get_ai_analyze_design_result`** → spec 有 lanhu_source 时，拉蓝湖原图 CSS 做还原度比对（蓝湖不可用则跳过此项，不阻塞）
 
 ## 输出
 
@@ -75,7 +84,7 @@ PM 说"评审设计稿"，AI 检查设计师的 spec.json 或原型：
 评审输出报告后，**立即调用 learning 引擎记录本次评审**（让团队学习哪些设计问题最常见）：
 
 ```bash
-python "$R/.qoder/scripts/report/learn.py" record review_done "{\"target\":\"{被评审的原型或spec}\",\"result\":\"PASS或问题数\",\"issues\":[\"严重问题1\",\"建议1\"]}"
+python "$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

@@ -11,7 +11,7 @@ trigger: "user invokes /wl-* command explicitly"
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # PRD Generator Skill
 
@@ -39,24 +39,28 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## 自取上下文（Quest / QoderWork 无 hook，必须自读）
 
-- `.qoder/.developer` — 当前开发者名
-- `.qoder/.current-task` — 当前活动任务
+- **当前身份**：当前开发者名。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
+- **活动任务**：当前活动任务。读法 `python "$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/report/role.py" 2>/dev/null || echo pm)
-python "$R/.qoder/scripts/kg/kg.py" prefetch "<需求描述>" --platform <p>
+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>
 ```
-或直接：`python .qoder/scripts/kg/prefetch.py "<需求描述>" --platform <p>`
+或直接：`python "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>`
 
 prefetch 一次返回 8 段（含历史PRD/数据库表/真实字段/API/Wiki），等于把多个业务词的查询合并。**prefetch 之后严禁再串行 search/find/grep**（这是轮次爆炸的根因——查一个词不命中就换词再查 6+ 次）。
 
 **仅当 prefetch 明确没覆盖到时才补调一次**（极少）：
-- 字段枚举值：`mcp__qoder-mysql__query_distinct(table='表名', column='状态列')` — prefetch 给了表结构但没给枚举取值，需要时才调
-- 改表影响：`mcp__qoder-knowledge-graph__table_impact(table='表名')` — 评估改动范围时才调
+> 以下两个 MCP 工具自动路由（有 MCP 走 MCP，无 MCP 走 CLI）；Qoder IDE/Quest/CLI 无 MCP 时跳过即可，靠 prefetch 已返回的数据足够。
+
+- 字段枚举值：`cap.mcp.call("query_distinct", {"table": "表名", "column": "状态列"})` — prefetch 给了表结构但没给枚举取值，需要时才调
+- 改表影响：`cap.mcp.call("table_impact", {"table": "表名"})` — 评估改动范围时才调
 
 ## STEP 0: 必须先问平台
 
@@ -110,12 +114,12 @@ prefetch 一次返回 8 段（含历史PRD/数据库表/真实字段/API/Wiki）
 **第 1 步｜并行取全（同一条消息并发，别串行）**
 ```
 同一条消息里并行发：
-  ① context_pack.py <关键词> --platform <p>   ← 代码+页面+字段+API+样式一次拿全
-  ② Read 历史相关 PRD
-  ③ Read 业务草稿
+  ① kg.py prefetch "<需求描述原句>" --platform <p>   ← 多词预测一次取全: 代码+页面+字段+API+样式+历史PRD标题
+  ② Read 业务草稿（workspace/members/{dev}/drafts/ 下相关草稿）
   （若衔接了 insight 报告：同时 Read 该报告，作为现状背景输入）
 ```
-然后只读 context_pack 列出的最相关 1-2 个 Vue 文件。
+然后只读 prefetch 列出的最相关 1-2 个 Vue 文件。
+> 历史相关 PRD：prefetch 第4段已返回标题列表。**只有要参考某篇历史 PRD 的写法/结构时，才额外 Read 那一篇**，不要每次都读。
 > ⚠️ 探索/调研/对标已归 /wl-insight，第 1 步**不派多 agent、不做 web 搜索**。
 
 **第 2 步｜轻反思 + 批量确认（核心：基于现状反思，重点是跟用户确认）**
@@ -138,10 +142,10 @@ prefetch 一次返回 8 段（含历史PRD/数据库表/真实字段/API/Wiki）
 ```bash
 # 门 1+2: 角色边界(当前角色能否产 prd?) + 契约校验(@contract 头是否合规?)
 # 软提示不阻塞, 越权/无契约头会提示但仍可发布
-python "$R/.qoder/scripts/common/check_publish.py" prd <draft-prd.md>
+python "$R/.qoder/scripts/foundation/identity/check_publish.py" prd <draft-prd.md>
 
 # 门 3: 质量分 (eval_prd 内部也会跑契约校验, 这里是质量评分)
-python "$R/.qoder/scripts/report/eval_prd.py" <draft-prd.md> <prototype.html>
+python "$R/.qoder/scripts/orchestration/wlkj.py" eval <draft-prd.md> <prototype.html>
 ```
 - check_publish 越权提示 → 软提示(如 dev 产 prd 会提示"建议产品经理"),不阻塞
 - eval_prd < 80% 不准发布，按报告修到 PASS
@@ -178,12 +182,12 @@ context_pack 字段段返回"无直接相关字段"时，**字段锁不报错，
 | REQ-ID 分配器失败 | 扫最大号+1，文件名带 `-manual`，push 时 team_sync 校验唯一 |
 | team_sync SYNC_CONFLICT | AI 按脚本给的命令自行解决，不让用户碰 git |
 
-> 完整降级表（含平台答错、归档失败等）见 `.qoder/commands/wl-prd-full.md` 的「故障降级表」。
+> 完整降级表（含平台答错、归档失败等）见 `.qoder/commands/wl-prd.md` 的「故障降级表」。
 
 ## 取上下文 — 一次取全（不要逐个搜）
 
 ```bash
-python "$R/.qoder/scripts/kg/context_pack.py" <关键词> --platform <web|app>
+python "$R/.qoder/scripts/orchestration/wlkj.py" context <关键词> --platform <web|app>
 ```
 返回 7 章节（代码+页面+字段+PRD+API+样式+Wiki）。**只读最相关 1-2 个 Vue 文件**。
 
@@ -206,7 +210,7 @@ python "$R/.qoder/scripts/kg/context_pack.py" <关键词> --platform <web|app>
 ## 原型规则
 
 - 从模板开始（`.qoder/templates/prototype-{web|app}.html`），模板已有正确颜色与 mixed-nav 多级菜单骨架
-- 先跑 `python "$R/.qoder/scripts/report/fill_prototype.py" <关键词> --platform <web|app>` 拿 80% 草稿;
+- 先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>` 拿 80% 草稿;
   它会按目标项目的 `layout_fingerprint` 自动填示例菜单骨架和真实字段,你只微调 20%
 - 颜色/布局指纹见 fill_prototype 输出的"设计 Token"段(布局模式/主色/侧边栏宽度)
 - **菜单层级**: 若需求描述了侧边栏/菜单结构(如"一级→二级,右侧三四级"),
@@ -221,7 +225,7 @@ python "$R/.qoder/scripts/kg/context_pack.py" <关键词> --platform <web|app>
 PRD 写入 drafts 后，**顺手归档一份**到当前成员的按时间文件夹，方便人翻查"我那天做了啥"：
 
 ```bash
-python "$R/.qoder/scripts/report/archive_prd.py" <刚生成的PRD文件路径>
+python "$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

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