@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -1,7 +1,7 @@
 ---
 name: spec-generator
-description: "从已确认的 PRD 自动生成开发 Spec 文档（技术规格说明）。Auto-generate development Spec documents from confirmed PRDs. 用户说'生成规格''写spec''出技术方案''把PRD转成开发文档'时触发。"
-trigger: "PRD 被确认/发布后自动触发；或用户说'生成Spec''写技术规格''/wl-spec'"
+description: "从已确认的 PRD 自动生成开发 Spec 文档（技术规格说明）。Auto-generate development Spec documents from confirmed PRDs. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "PRD 被确认/发布后自动触发；或用户说'生成Spec''写技
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/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

@@ -1,7 +1,7 @@
 ---
 name: test-generator
-description: "从已实现代码和 Spec 自动生成单元测试。Auto-generate unit tests from implemented code and Spec. 用户说'写单元测试''补测试''覆盖一下''写个test'时触发。需用户确认（DANGEROUS）。"
-trigger: "代码实现完成后；用户说'写测试''补单测''生成test''/wl-test'"
+description: "从已实现代码和 Spec 自动生成单元测试。Auto-generate unit tests from implemented code and Spec. 需用户确认（DANGEROUS）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "代码实现完成后；用户说'写测试''补单测''生成test''/w
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/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/search_index.py" Test
+   python "$R/.qoder/scripts/orchestration/wlkj.py" search Test
    ```
 
 ## Step 3: 生成测试

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

@@ -1,7 +1,7 @@
 ---
 name: wl-code
-description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. 用户说'开始写代码''按规格实现''实现这个接口''把这个需求做出来'或输入 /wl-code 时触发。需用户确认（DANGEROUS）。"
-trigger: "Spec 已确认待实现；用户说'开始写代码''按spec实现''/wl-code'"
+description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. 需用户确认（DANGEROUS）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "Spec 已确认待实现；用户说'开始写代码''按spec实现''/w
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/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,7 +1,7 @@
 ---
 name: wl-commit
-description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 用户说'提交代码''commit''推上去''保存代码''提交一下'时触发。需用户确认（DANGERONS）。"
-trigger: "用户说'提交''commit''推上去''保存代码''提交一下''/wl-commit'"
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 需用户确认（DANGEROUS）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'提交''commit''推上去''保存代码''提交一下''/wl-c
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/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

@@ -1,7 +1,7 @@
 ---
 name: wl-design
-description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。用户说'录入设计稿''按设计出原型''评审原型'或输入 /wl-design 时触发。"
-trigger: "用户说'录入设计稿''Figma稿录入''按设计出原型''评审原型''/wl-design'"
+description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'录入设计稿''Figma稿录入''按设计出原型''评审
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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

@@ -1,7 +1,7 @@
 ---
 name: wl-init
-description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. 用户说'初始化''我是谁''换开发者''环境检查''/wl-init''设置一下''开始用'时触发。"
-trigger: "首次使用、换人、或遇到环境问题时；用户说'初始化''换开发者''环境检查''体检'"
+description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "首次使用、换人、或遇到环境问题时；用户说'初始化
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/init_doctor.py"
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor
 ```
 输出 8 段体检报告，每行 `[OK]/[WARN]/[FIX]/[MISS]` 标注。
 
 ### 带名字（注册 + 自愈）
 ```bash
-python "$R/.qoder/scripts/init_doctor.py" --fix <名字> [角色]
-# 例：python "$R/.qoder/scripts/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/init_doctor.py" --fix <名字> [角色]
 
 ### 仅自愈（不换人）
 ```bash
-python "$R/.qoder/scripts/init_doctor.py" --fix
+python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix
 ```
 
 ## 体检覆盖的 8 段
@@ -71,6 +71,6 @@ python "$R/.qoder/scripts/init_doctor.py" --fix
 体检/注册本身不需要 push（只改本地 `.developer`）。但若 `--fix` 触发了图谱重建，
 完成后建议跑一次：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 让队友拿到刷新后的索引。

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

@@ -1,7 +1,7 @@
 ---
 name: wl-insight
-description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。用户说'调研一下''竞品分析''接下来做什么''路线图''探讨一下需求''我发现个机会''规划下个版本'时触发。"
-trigger: "用户说'调研''竞品''对标''规划''路线图''roadmap''探讨需求''接下来做什么''发现个机会''下个版本做什么''/wl-insight'"
+description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'调研''竞品''对标''规划''路线图''roadmap''探讨
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/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/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/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 
 ---

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

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-full
-description: "完整档 PRD + 原型（13 章，正经需求）。新模块/新业务/新流程用这个。支持 参考:<insight报告> 衔接探索站。用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'或输入 /wl-prd-full 时触发。先问平台！"
-trigger: "用户描述正经需求、要 PRD、要原型、要 mockup，或直接 /wl-prd-full"
+description: "完整档 PRD + 原型（13 章，正经需求）。新模块/新业务/新流程用这个。支持 参考:<insight报告> 衔接探索站。先问平台！"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,13 +11,13 @@ trigger: "用户描述正经需求、要 PRD、要原型、要 mockup，或直
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-prd-full — 完整档 PRD + 原型（/wl-prd-full 命令入口）
 
 > 这是 `/wl-prd-full` 命令的 skill 入口。QoderWork 的 `/` 列表读 skills，
 > 所以本 skill 让 QoderWork 也能用 `/wl-prd-full`，与 Qoder IDE 保持一致。
-> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd-full`，
+> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd.md`，
 > 功能实现层见 `.qoder/skills/prd-generator/SKILL.md`。
 > **第一性原理：又快又准。**
 
@@ -38,6 +38,49 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 | 2 / APP / H5 / 移动端 | APP | `--platform app` | prototype-app.html |
 | 3 / 都要 / 两端 | Both | 都跑 | 两个模板，两份原型 |
 
+## ⚠️ STEP 0.5: 原型要不要画？（融入 Step 2 批量确认，不另开轮次）
+
+**不交给 AI 默默判断**（避免"AI 觉得不需要、用户其实想要"的扯皮），但也**不额外开一轮问答**——
+合并进 Step 2「轻反思 + 批量确认」那一步，跟背景/目标/指标一起一次性问完。
+
+### 关键词触发矩阵（给默认建议，用户可一键改）
+
+| 模式 | 关键词信号 | 默认建议 | 例子 |
+|------|-----------|---------|------|
+| 评审 | （任何） | ❌ 不画 | 评审别人的 PRD，本就不画 |
+| 快速 | 加字段/按钮/文案/导出/接口 | ❌ 不画 | "列表加个导出按钮" |
+| 快速 | 含"页面/弹窗/表单/交互" | ✅ 画 | "弹窗里加 3 个字段" |
+| 完整 | 含"页面/菜单/详情/列表/向导/看板/大屏" | ✅ 画 | "新出库单页面" |
+| 完整 | 纯"规则/接口/定时/对账/计算/开关/参数/性能" | ❌ 不画 | "出交车点检固定为总部全局规则" |
+| 完整 | 混合（既有页面又有规则） | ✅ 画（只画页面那部分） | "新增审批流 + 审批页" |
+
+### Step 2 问法（合并到批量确认）
+
+```
+确认 3 件事就开工：
+1. 背景/目标：……（AI 已补，要改吗？）
+2. 关键指标：……（AI 已补，要改吗？）
+3. 原型图：我建议【画/不画】，因为……（理由）。
+   要改吗？(画 / 不画 / 两端各画一份)
+```
+
+### 两端都画时的边界（v3.1）
+
+「完整模式 + 两端都要」如果用户选了"画"，**默认只画主端一份**（用户在 PRD 里标的主端），
+另一端在 PRD 第 11 章写"复用主端规则，UI 适配另出"。用户明确说"两端各画一份"才画 2 份。
+
+### 不画原型时的下游连锁（必须对齐）
+
+| 产物 | 处理 |
+|------|------|
+| PRD 第 11 章「原型地址」 | 写 `无（{原因}，经用户确认豁免）`，**保留章节标题**不省略 |
+| PRD 第 1 行 `@contract` 头 | 标记 `prototype: none` |
+| eval_prd | 检测到 `prototype: none` → A2 自动跳过，满分从 100 降到 70，照样能 PASS |
+| /wl-design | 读到 `prototype: none` 跳过原型环节 |
+| /wl-code | 直接以 PRD 字段表为准 |
+
+---
+
 ## 衔接 insight（参考模式）
 
 **若用户说"按 insight 报告做 PRD""转 PRD"或带 `参考：<报告路径>`：**
@@ -46,14 +89,22 @@ Read 指定 insight 报告 → 把现状锚定 + 选中的机会/Gap 作为 PRD
 
 ## 完整流程（详细见 command 文件）
 
-1. **并行取全上下文**：先读当前角色（`python "$R/.qoder/scripts/role.py"` 输出 pm/design/dev/test/admin 之一），按角色传 `--role`，让上下文匹配角色视角：
+1. **并行取全上下文**：先读当前角色（`python "$R/.qoder/scripts/orchestration/wlkj.py" role` 输出 pm/design/dev/test/admin 之一），用 prefetch 一次取全（完整档需求含多业务实体，prefetch 多词预测比单词 context 更准）：
    ```bash
-   ROLE=$(python "$R/.qoder/scripts/role.py" 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/kg.py" context <词> --platform <p> --role "$ROLE"
+   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>
    ```
+   > prefetch 把需求句拆成多个业务词批量搜、一次合并（例"考勤导入校验"→考勤/导入两词全搜）。
+   > 拿到后**按 $ROLE 视角看重点**：dev 看代码段、design 看页面+风格段、pm 看字段+历史PRD段。prefetch 之后不要再串行 search。
    > 不硬编码 pm：dev 写 PRD 能拿到代码视角、设计师拿到页面+风格视角，比统一 PM 视角更"准"。
 2. **轻反思 + 批量确认**：AI 自动补全背景/目标/指标，只把真缺失的 1-2 点一次性问完
-3. **一次生成 + 3 道质量锁**：PRD（prd-full-template.md，13 章）+ 原型一次 Write → 背景锁/字段锁/闭环锁 → eval_prd → 不过自动修
+3. **一次生成 + 3 道质量锁**：
+   - PRD（prd-full-template.md，13 章）一次 Write
+   - **原型按 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]`
+     （wlkj.py eval 内部映射 validation/metrics/eval_prd.py，路径不会漂移）
 4. **发布 + 归档 + 同步**（3 合 1）：collect_prds → team_sync push → archive_prd
 
 ## 🔒 3 道质量锁

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

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-quick
-description: "小改动极速出 Mini-PRD（6 章）。加字段/加按钮/改文案/加导出等零星需求专用。用户说'加个字段''加个导出按钮''改下文案''快速出个需求'时触发。先问平台！"
-trigger: "用户说小改动/加字段/加按钮/改文案/快速出 PRD，或直接 /wl-prd-quick"
+description: "小改动极速出 Mini-PRD（6 章）。加字段/加按钮/改文案/加导出等零星需求专用。先问平台！"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,13 +11,13 @@ trigger: "用户说小改动/加字段/加按钮/改文案/快速出 PRD，或
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-prd-quick — 小改动极速出 Mini-PRD（/wl-prd-quick 命令入口）
 
 > 这是 `/wl-prd-quick` 命令的 skill 入口。QoderWork 的 `/` 列表读 skills，
 > 所以本 skill 让 QoderWork 也能用 `/wl-prd-quick`，与 Qoder IDE 保持一致。
-> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd-quick.md`，
+> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd.md`，
 > 功能实现层见 `.qoder/skills/prd-generator/SKILL.md`（快档分支）。
 
 ## ⚠️ STEP 0: 必须先问平台（任何分析前）
@@ -38,11 +38,11 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## 3 步极速流程（详细见 command 文件）
 
-1. 先读当前角色再取上下文（不硬编码 pm，让 dev/设计师拿到匹配视角）：
+1. **先 prefetch（预测 + 批量预取，禁止串行 search）**：
    ```bash
-   ROLE=$(python "$R/.qoder/scripts/role.py" 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/kg.py" context <词> --platform <p> --role "$ROLE"
+   python "$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）
 3. "出好了，确认发布吗？" → 归档 + push
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-review
-description: "评审 PRD 完整性与质量（7 项 checklist + EVA 评分）。用户说'评审PRD''检查需求文档''PRD质量怎么样''这个 PRD 合格吗''帮我看看这个需求文档'时触发。"
-trigger: "用户说要评审/检查/审核 PRD 质量，或直接 /wl-prd-review"
+description: "评审 PRD 完整性与质量（7 项 checklist + EVA 评分）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,12 +11,12 @@ trigger: "用户说要评审/检查/审核 PRD 质量，或直接 /wl-prd-review
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 # wl-prd-review — 评审 PRD 质量（/wl-prd-review 命令入口）
 
 > 这是 `/wl-prd-review` 命令的 skill 入口。
-> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd-review.md`，
+> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd.md`，
 > 评审实现细节见 `.qoder/skills/prd-review/SKILL.md`。
 > **定位：评审已有 PRD，不产出新 PRD。**
 
@@ -24,11 +24,23 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 拿到一份 PRD，检查它够不够格发布/交付下游：
 1. **7 项 checklist**：用户故事清晰 / 验收可测 / 优先级已标 / 模块已识别 / 非功能已列 / 边界已考虑 / 依赖已识别
-2. **EVA 客观评分**：`python "$R/.qoder/scripts/eval_prd.py" <PRD> [原型]`，≥80% 才 PASS
+2. **EVA 客观评分**：`python "$R/.qoder/scripts/orchestration/wlkj.py" eval <PRD> [原型]`，≥80% 才 PASS
 3. **合并报告**：PASS → 可发布；不 PASS → 修复清单
 
 ## 定位要评审的 PRD
 
 用户给路径 → 直接 Read；没给 → 扫 `data/docs/prd/` + `workspace/members/*/drafts/` 列出最近 PRD 让用户选。
 
-详细流程见 `.qoder/commands/wl-prd-review.md`。
+详细流程见 `.qoder/commands/wl-prd.md`。
+
+## ✅ 评审完成后必须埋点（不要跳过）
+
+评审报告给出 PASS/不 PASS 结论后，**立即**记录一条 `review_done` 事件——
+这是「可用性指标 F2 转化漏斗」评审级数据的唯一来源，不埋则该级永远为 0：
+
+```bash
+python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<被评审PRD文件名>\", \"verdict\": \"PASS\"}"
+```
+- `verdict`：评审结论，`PASS` 或 `FAIL`
+- 埋点失败不阻塞评审（包在 try 里无所谓），但能埋一定要埋。
+