@hupan56/wlkj 3.0.0 → 3.1.2

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

@@ -11,18 +11,42 @@ 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`。
 
 # Prototype Generator
 
 Generate production-ready HTML prototypes that match the project's actual UI style.
 
+## 🔌 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` / `--field <名>` / `--vben` / `--components`）；仅 MCP 有的能力（如 fill_prototype/context_pack）跳过或人工补。
+
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 决定产出存到 `workspace/members/{dev}/drafts/`
+- **当前身份**：决定产出存到 `workspace/members/{dev}/drafts/`。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - 若 `.qoder/.current-task` 存在，原型命名带上任务关键词
 - 平台（Web/APP/Both）必须明确；如未指定，先问用户（见 prd-generator Step 0）
 
+## ⚠️ 前置门: 用户是否选了"画原型"？（v3.1 新增）
+
+本 skill **只在用户明确选择"画原型"后才进入**。
+
+- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
+  `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
+- 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
+  `这个需求要画原型吗？(画 / 不画)`
+  用户答"不画"→ 退出；用户答"画"→ 继续。
+- **绝不擅自决定画/不画**。决策权在用户，本 skill 只执行。
+
+> 这条门治"AI 默默画了个塑料骨架"的反模式——比如"出交车点检固定为总部全局规则"
+> 这种纯规则下发型需求，AI 不该自己往里塞一个配置页原型。
+
+---
 ## Step 0: Know the Platform
 
 The platform MUST already be decided (asked by /wl-prd-full Step 0).
@@ -62,15 +86,15 @@ style must STILL come from the system, never from generic admin templates:
 4. In the prototype header comment, cite which real files the style came from
    — if you cannot name a source file, you have NOT done step 1.
 
-## Step 0.5: Get Design System (MUST DO FIRST)
+## 🔒 Step 0.5: Get Design System（硬门 #1，跳过则 A2 必扣分）
 
 **PREFERRED: Call MCP tool (faster, auto-generates if missing):**
 ```
-mcp__qoder-knowledge-graph__get_design_system(platform='web')
+cap.mcp.call("get_design_system", {"platform": "web"})
 ```
 
 **FALLBACK: Read file directly:**
-Read `data/design/DESIGN.md`. If missing, run `python "$R/.qoder/scripts/report/gen_design_doc.py"`.
+Read `data/design/DESIGN.md`. If missing, run `python "$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.
@@ -86,16 +110,16 @@ Read the requirement to decide:
 - **Modal/Drawer**: Popup form
 - **Dashboard**: Charts + summary cards
 
-## Step 1.5: Prefill Draft (MUST DO - 80% auto, 20% you adjust)
+## 🔒 Step 1.5: Prefill Draft（硬门 #2，跳过等于从零手抄 → 必出模板感）
 
 **PREFERRED: Call MCP tool:**
 ```
-mcp__qoder-knowledge-graph__fill_prototype(keyword='营业外合同', platform='web')
+cap.mcp.call("fill_prototype", {"keyword": "营业外合同", "platform": "web"})
 ```
 
 **FALLBACK: Run script:**
 ```bash
-python "$R/.qoder/scripts/report/fill_prototype.py" <关键词> --platform <web|app>
+python "$R/.qoder/scripts/orchestration/wlkj.py" fill-prototype <关键词> --platform <web|app>
 ```
 
 Returns: 80% complete HTML draft (real columns/fields/layout injected) + data manifest.
@@ -130,28 +154,28 @@ Your job: 20% adjustment only (interaction details, layout tweaks).
 
 **PREFERRED: MCP tools (designer-focused, no code noise):**
 ```
-mcp__qoder-knowledge-graph__context_pack(keyword='异常资产申请', platform='web', role='design')
+cap.mcp.call("context_pack", {"keyword": "异常资产申请", "platform": "web", "role": "design"})
 ```
 `role='design'` 只返回页面示例+布局指纹+风格速查+字段，过滤掉代码/API噪音。
 比无 role 更干净，原型生成专用。
 
 **理解业务交互流程（原型要有状态，不只是静态截图）：**
 ```
-mcp__qoder-knowledge-graph__get_workflow(module='资产')
+cap.mcp.call("get_workflow", {"module": "资产"})
 ```
 返回操作链（如：查询→新增→提交→审批→归档→导出）。
 AI 据此设计原型的交互状态和页面跳转。
 
 **查语义级模块文档（比读代码更省 token）：**
 ```
-mcp__search_wiki(keyword='资产')
+cap.mcp.call("search_wiki", {"keyword": "资产"})
 ```
 
 **FALLBACK: Python scripts:**
 ```bash
-python "$R/.qoder/scripts/kg/search_index.py" --style <table|form|detail|modal|dashboard> --platform <web|app>
-python "$R/.qoder/scripts/kg/search_index.py" <keyword> --platform <web|app>
-python "$R/.qoder/scripts/kg/search_index.py" --field <field_name>
+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>
 ```
 
 Then read the TOP 2-3 most similar existing Vue files to extract:
@@ -236,6 +260,31 @@ ready-to-paste SVGs extracted from the actual projects).
 4. ICS 的菜单来自后端接口(`access_mode: backend`),静态代码里抓不到完整菜单树,
    所以菜单层级**必须由需求/PRD 提供**,不要去代码里找。
 
+## 🔒 Step 3.5: 来源锚定 + UTF-8（硬门 #3，eval A2 检查）
+
+### 来源锚定（必做）
+
+生成的 HTML 必须在 `<head>` 里写一行注释，标注样式来源的真实文件：
+
+```html
+<!-- @prototype-source: fywl-ui/apps/ics/src/views/xxx/index.vue, fywl-ui/apps/ics/src/api/xxx.ts -->
+<meta name="x-source-pages" content="fywl-ui/.../index.vue">
+```
+
+- 来源文件**必须来自 Step 2 读过的真实 Vue/TS 文件**（prefetch 返回的 page_examples）
+- 写不出具体文件名 = 你没做 Step 2 = 违规
+- eval A2 会检查：HTML 含 `@prototype-source:` 或 `x-source-pages` → 通过；否则 A2 扣 5 分
+
+### UTF-8 强制（治编码乱码）
+
+生成的 HTML **必须用 UTF-8 写入**，否则中文 `<title>`/注释会变成 `鍑轰氦杞?` 乱码。
+
+- Write 工具调用时，内容里的中文必须是原始 UTF-8（不要从 GBK 源复制）
+- 如果用 Python 写文件：`open(path, 'w', encoding='utf-8')`
+- **绝不要从 bash 输出里复制中文再粘贴**（bash 在 Windows 上可能转 GBK）→ 优先让
+  `fill_prototype` 脚本直接出文件，AI 只 Edit 占位符
+
+---
 ## Step 4: Highlight Changes + Interactivity
 
 - Mark NEW/CHANGED elements with the template's `highlight-new` class

package/templates/qoder/skills/spec-coder/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`。
 
 # Spec Coder
 
@@ -25,8 +25,10 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / 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`（输出任务路径；空=无活动任务）。
 - Spec 文件位置：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
 - 目标代码库：`data/code/`（fywl-ics 后端 / fywl-ui 前端 / Carmg-H5 移动端）
 
@@ -41,19 +43,26 @@ ls workspace/tasks/           # 任务内的 specs
 
 ## Step 2: 读取上下文
 
+### ⚡ 取全一次到位（先跑，省掉后续多次 search/Read）
+
+```bash
+cap.mcp.call("context_pack", {"keyword": "..."}) <spec里的模块关键词> --platform <web|app> --role dev
+```
+
+**一次拿到**：相关代码文件(第1段) + 真实字段名(第3段) + 相关 API(第5段) + Repo Wiki(第7段)。
+拿到后 Read top 2-3 个命中的相似文件，照着它们的命名/结构/异常处理写。**不要再 search_index 单词搜**。
+
+### 同时并发补这两项（与上面 context_pack 无依赖，同回合并发）
+
 1. **Spec 文件**（必需）：开发规格
 2. **PRD 文件**（推荐）：原始需求，理解业务背景
-3. **现有代码风格**（必需）：用 search_index.py 找相关模块真实代码作参考
-   ```bash
-   python "$R/.qoder/scripts/kg/search_index.py" <模块关键词>
-   ```
-   读 top 2-3 个相似文件，照着它们的命名/结构/异常处理写
-4. **架构/数据字典**（如存在）：`.qoder/context/architecture.md`、`data-dictionary.md`
-   不存在就跳过，从现有代码推断
-5. **真实表结构（推荐）**：写 Entity/SQL 前调 MySQL MCP 核对数据库真实列定义。
-   - `mcp__qoder-mysql__query_schema(table='表名', db='库名')`
+3. **真实表结构**（写 Entity/SQL 前必查）：context_pack 不含 DB schema，单独调
+   - `cap.mcp.call("query_schema", {"table": "表名", "db": "库名"})`（先 list_envs 问环境）
    - 拿真实列名/类型/可空/注释（含枚举定义），避免 Entity 字段和数据库对不上
-   - 注意：[QAS 测试环境] 结构与生产一致；数据行仅参考格式
+   - [QAS 测试环境] 结构与生产一致；数据行仅参考格式
+
+> 架构/数据字典 `.qoder/context/architecture.md`、`data-dictionary.md` 如存在顺手读，不存在跳过。
+> 以上 Spec/PRD/query_schema 三项相互独立 → **同一条消息并发发**，不要逐个等。
 
 ## Step 3: 按 Spec 实现
 

package/templates/qoder/skills/spec-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`。
 
 # Spec Generator
 
@@ -23,11 +23,13 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前开发者
-- `.qoder/.current-task` — 当前任务（决定 spec 存到哪个 task 目录）
+- **当前身份**：当前开发者。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
+- **活动任务**：当前任务（决定 spec 存到哪个 task 目录）。读法 `python "$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/kg/search_index.py" --field <字段名>` 查现有字段命名约定
+- 风格/字段参考：`python "$R/.qoder/scripts/orchestration/wlkj.py" search --field <字段名>` 查现有字段命名约定
 - 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）写在本 skill 的 Step 3
 
 ## Step 1: 定位 PRD
@@ -43,15 +45,25 @@ ls workspace/members/{developer}/drafts/REQ-*.md
 
 ## Step 2: 读取上下文
 
-按优先级读取：
+### ⚡ 取全一次到位（先跑，省掉后续多次 search/Read）
+
+```bash
+cap.mcp.call("context_pack", {"keyword": "..."}) <PRD里的模块关键词> --platform <web|app> --role dev
+```
+
+**一次拿到**：相关代码文件(第1段) + 真实字段名(第3段) + 相关 API(第5段) + Repo Wiki(第7段)。
+照着第1段命中的相似文件学写法，**不要再 search_index 单词搜**。
+
+### 同时并发补这几项（与 context_pack 无依赖，同回合并发）
+
 1. **PRD 文件**（必需）：需求源
 2. **历史 Spec**（推荐）：扫 `workspace/specs/` 看同类需求的写法，照着写
-3. **现有代码风格**（推荐）：用 search_index.py 找相关模块的真实代码做参考
-4. **数据字典**（如有）：`.qoder/context/data-dictionary.md`（不存在则跳过，从现有 Entity 类推断）
-5. **真实表结构（强烈推荐）**：调 MySQL MCP 查数据库真实字段，别靠猜。
-   - `mcp__qoder-mysql__query_schema(table='quality_case', db='fywl_ics_quality')`
+3. **真实表结构**（强烈推荐）：context_pack 不含 DB schema，写 API 字段前单独查
+   - 先 `cap.mcp.call("list_envs", {})` 问环境，再 `query_schema(table='quality_case', db='fywl_ics_quality')`
    - 拿到真实列名/类型/注释（注释里常含枚举定义，如"0=小时,1=工作日"）
-   - 注意：[QAS 测试环境] 表结构与生产一致可放心用；数据行是测试数据仅参考格式
+
+> 数据字典 `.qoder/context/data-dictionary.md` 如存在顺手读，不存在跳过。
+> 以上 PRD/历史Spec/query_schema 三项相互独立 → **同一条消息并发发**，不要逐个等。
 
 ## Step 3: 分析并生成
 

package/templates/qoder/skills/test-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`。
 
 # Test Generator
 
@@ -25,12 +25,14 @@ 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`（输出任务路径；空=无活动任务）。
 - Spec 文件：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
 - 已实现代码：用 search_index.py 定位
   ```bash
-  python "$R/.qoder/scripts/kg/search_index.py" <类名或模块关键词>
+  python "$R/.qoder/scripts/orchestration/wlkj.py" search <类名或模块关键词>
   ```
 
 ## Step 1: 定位待测代码
@@ -48,7 +50,7 @@ ls data/code/                     # 已实现代码库
 2. **Spec 文件**（推荐）：测试用例映射来源
 3. **现有测试代码**（推荐）：用 search_index.py 找同类 Test 类，照着写
    ```bash
-   python "$R/.qoder/scripts/kg/search_index.py" Test
+   python "$R/.qoder/scripts/orchestration/wlkj.py" search Test
    ```
 
 ## Step 3: 生成测试

package/templates/qoder/skills/wl-code/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`。
 
 # wl-code — 按 Spec 实现代码（/wl-code 命令入口）
 
@@ -22,28 +22,40 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / 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`（输出任务路径；空=无活动任务）。
 - 活动任务的 spec：`workspace/specs/` 或 `workspace/tasks/{id}/spec.md`
 
-### 改代码前必查（用知识图谱 MCP，防改崩）
+### ⚡ 取全一次到位（spec 里的模块名 → 1 次 context_pack 拿全）
 
-1. **改表影响分析**：涉及改数据库表/Entity 时，先 `mcp__qoder-knowledge-graph__table_impact(table='表名')`
+```bash
+cap.mcp.call("context_pack", {"keyword": "..."}) <模块关键词> --platform <web|app> --role dev
+```
+
+**一次返回**：相关代码文件(第1段) + 字段真名(第3段) + 相关 API(第5段) + Repo Wiki(第7段)。
+拿到后直接 Read 2-3 个命中的代码文件照着写，**不要再 search_index 单词搜**（context 第1段已给全代码路径）。
+> 只有关键词命中太少时，才回退 `search_index.py <词>` 补搜。
+
+### 改表/改 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 真实列类型）。
+
+1. **改表影响分析**：涉及改数据库表/Entity 时，先 `cap.mcp.call("table_impact", {"table": "表名"})`
    - 查这张表关联哪些 Entity + 影响哪些 Controller/接口。
    - 例：`table_impact(table='quality_case')` → 发现影响 QualityCaseController + 5 个接口。
    - 看完才知道改动波及面，避免改一处崩多处。
-2. **真实字段核对**：写 Entity/SQL 前 `mcp__qoder-mysql__query_schema(table='表名')`
+2. **真实字段核对**：写 Entity/SQL 前 `cap.mcp.call("query_schema", {"table": "表名"})`
+   - context_pack 不含 DB 表结构（只有代码字段名），写 Entity/DDL 必须单独查真实列。
    - 拿真实列名/类型/注释（含枚举定义），别靠推断。
    - [QAS环境] 表结构与生产一致可放心用。
 
 ## 执行
 
 1. **加载 Spec**：按 REQ-ID 找 spec；没参数就读 `.qoder/.current-task`
-2. **搜相关代码**：
-   ```bash
-   python "$R/.qoder/scripts/kg/search_index.py" <关键词>
-   ```
-   读相关文件了解现有模式。
+2. **一次取全上下文**：用上面 context_pack（spec 里的模块名）拿代码+字段+API，再 Read 命中的 2-3 个文件
 3. **按 spec-coder skill 实现**：严格按 spec，遵循 data/code/ 的团队约定
 4. **自检**：
    - [ ] Spec 所有需求都覆盖

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

@@ -1,6 +1,6 @@
 ---
 name: wl-commit
-description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 需用户确认（DANGERONS）。"
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 需用户确认（DANGEROUS）。"
 trigger: "user invokes /wl-* command explicitly"
 ---
 
@@ -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`。
 
 # wl-commit — 代码提交 + 质量门禁 + 同步
 
@@ -21,18 +21,19 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（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 不在仓库根，会读不到而误报未初始化）。
 - 当前工作目录的 `git status` 和 `git diff --stat` 看改了什么
-- `.qoder/.current-task` — 若有活动任务，提交信息关联任务 ID
+- **活动任务**：若有活动任务，提交信息关联任务 ID。读法 `python "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
 
 ## 执行流程
 
 ### Step 1: 看改动
 ```bash
-git status
-git diff --stat
-git diff --cached --stat
+git status && git diff HEAD --stat
 ```
+> 三个只读查询合并成一条命令一次拿全（status + 工作区/暂存区改动清单），别分三次发。
 
 ### Step 2: 质量门禁（提交前自检）
 
@@ -70,7 +71,7 @@ git push
 
 提交成功后埋点（写当前开发者的 journal，供 /wl-status 健康度统计）：
 ```bash
-python "$R/.qoder/scripts/report/learn.py" record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
+python "$R/.qoder/scripts/orchestration/wlkj.py" learn record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
 ```
 > 失败静默忽略，绝不阻塞提交流程。
 

package/templates/qoder/skills/wl-design/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`。
 
 # wl-design — 设计工序入口（/wl-design 命令入口）
 
@@ -36,8 +36,10 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / 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）；如未指定，先问
 - 风格真源：`data/style/*-design-spec.json`（优先）→ `data/code/` 源码 → `data/index/vben-style-reference.json`（Web）/ Vant（APP）
 

package/templates/qoder/skills/wl-init/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`。
 
 # wl-init — 开发者身份 + 环境体检
 
@@ -28,14 +28,14 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ### 无参数（仅体检）
 ```bash
-python "$R/.qoder/scripts/setup/init_doctor.py"
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor
 ```
 输出 8 段体检报告，每行 `[OK]/[WARN]/[FIX]/[MISS]` 标注。
 
 ### 带名字（注册 + 自愈）
 ```bash
-python "$R/.qoder/scripts/setup/init_doctor.py" --fix <名字> [角色]
-# 例：python "$R/.qoder/scripts/setup/init_doctor.py" --fix 小王 pm
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix <名字> [角色]
+# 例：python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 pm
 ```
 做 3 件事：
 1. 写 `.qoder/.developer`（key=value 格式）
@@ -44,7 +44,7 @@ python "$R/.qoder/scripts/setup/init_doctor.py" --fix <名字> [角色]
 
 ### 仅自愈（不换人）
 ```bash
-python "$R/.qoder/scripts/setup/init_doctor.py" --fix
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix
 ```
 
 ## 体检覆盖的 8 段
@@ -71,6 +71,6 @@ python "$R/.qoder/scripts/setup/init_doctor.py" --fix
 体检/注册本身不需要 push（只改本地 `.developer`）。但若 `--fix` 触发了图谱重建，
 完成后建议跑一次：
 ```bash
-python "$R/.qoder/scripts/task/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 让队友拿到刷新后的索引。

package/templates/qoder/skills/wl-insight/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`。
 
 # wl-insight — 需求探索（7 站之前的「探索站」· 产品工位）
 
@@ -54,17 +54,30 @@ insight（探索/调研/规划）→ [用户确认转PRD] → prd（落地）→
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前探索者（报告归属）
-- **现状锚点**：`python "$R/.qoder/scripts/kg/context_pack.py" <关键词> --platform <web|app>`（必跑，探索不能脱离现状凭空想）
-- `.qoder/learning/feedback.jsonl` — 历史 insight 报告索引（可能为空）
-- 相关历史 PRD：`data/docs/prd/`（看已经做了什么，避免重复）
+- **当前身份**：当前探索者（报告归属）。读法：先 `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.` 定位仓库根，
+  再 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
+  ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
+- **现状锚点（必跑，只跑这一次）**：用 prefetch 一次取全，不要串行换词搜：
+  ```bash
+  python "$R/.qoder/scripts/orchestration/wlkj.py" kg prefetch "<需求描述原句>"
+  ```
+  > **不传 `--platform` = 默认双平台一次返回**（platform: all）。探索阶段需求常未定平台，
+  > 直接默认双平台拿全，**绝不 web 跑一次、app 再跑一次**（这是 insight 慢的 #2 元凶）。
+  > 用户明确说"只要 web/只要 app"时，才加 `--platform web` 或 `app`。
+  > 探索需求常含多业务实体（如"3D地图实时车辆调度"），prefetch 自动拆多词批量搜、
+  > 一次合并代码+页面+字段+历史PRD标题+API+RepoWiki。**拿到后不要再串行 search/find/grep**，
+  > 也不要再单独扫 `data/docs/prd/`（prefetch 第4段已返回相关历史 PRD 标题，要参考某篇再单独读那篇）。
+- `workspace/members/{dev}/journal/feedback.jsonl` — 历史 insight 报告索引（可能为空；按人分文件，团队 git 共享）
+
+> 🚫 禁止串行换词搜：第一次 prefetch 没命中或命中少，先反思是不是需求描述太泛，
+> 不要本能地 context_pack 换第2个、第3个词再搜（这是 insight 慢的 #1 元凶）。
 
 ---
 
 ## 🔒 三道前置检查（任何动作前先做）
 
-1. **身份检查**：`.developer` 缺失 → 停下，提示先 `/wl-init`，不继续。
-2. **现状锚点**：任何探索前先跑 `context_pack.py`。**不锚定现状的探索 = 凭空臆想，禁止。**
+1. **身份检查**：跑 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`
+2. **现状锚点**：任何探索前先跑 **1 次** `kg.py prefetch "<需求句>"`（见上方自取上下文段）。**不锚定现状的探索 = 凭空臆想，禁止。禁止串行换词搜。**
 3. **报告归属**：报告必须写到 `workspace/members/{dev}/drafts/`，用 `.developer` 归属。
 
 ---
@@ -106,7 +119,7 @@ OST     ├─ Opportunity（用户机会/痛点）─ discover ──┤  → i
 ## 三类型怎么做（概要，详见命令定义）
 
 **discover（需求发现）—— 用 JTBD + OST 前两层：**
-1. 跑 context_pack 锚定现状
+1. 跑 **1 次** prefetch 锚定现状（多业务实体一次取全，不要串行换词搜）
 2. 用 JTBD 还原"用户要完成什么 job"，列出痛点/机会
 3. 每个机会对应一个业务 outcome（OST 第 1-2 层）
 4. 输出机会清单，问用户"哪个值得深入？"
@@ -155,7 +168,7 @@ prd 以 reference 模式（mode: reference）承接，读取 insight 报告作
 
 ## 🧩 QoderWork 增强：外部数据源（可选 · 无连接器则自动回退）
 
-> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors & MCP）。
+> 通过 capability 层自动路由（Settings → Connectors & MCP）。
 > **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，insight 用 context_pack + web 搜索足够。**
 > 探测方式：仅当运行环境提供了「Browser / MCP 工具」可调用时才用。
 
@@ -186,7 +199,7 @@ prd 以 reference 模式（mode: reference）承接，读取 insight 报告作
 
 insight 报告**默认不 push**（个人探索草稿）。用户说"发出去/同步/分享给团队"才：
 ```bash
-python "$R/.qoder/scripts/task/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 
 ---