@hupan56/wlkj 3.0.0 → 3.1.2

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

@@ -11,13 +11,13 @@ 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-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/report/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/report/role.py" 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/kg/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

@@ -11,13 +11,13 @@ 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-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: 必须先问平台（任何分析前）
@@ -40,7 +40,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 1. **先 prefetch（预测 + 批量预取，禁止串行 search）**：
    ```bash
-   python "$R/.qoder/scripts/kg/prefetch.py" "<需求描述>" --platform <p>
+   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）

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

@@ -11,12 +11,12 @@ 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-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/report/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 里无所谓），但能埋一定要埋。
+

package/templates/qoder/skills/wl-report/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-report — 日报 / 周报（按开发者隔离）
 
@@ -19,33 +19,35 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — **必需**。未设置则停止，提示用户先初始化
-- `.qoder/.current-task` — 当前任务
-- `workspace/members/{dev}/journal/` — 历史日报/周报
-- `workspace/members/{dev}/drafts/` — 今日/本周产出的 PRD/原型草稿
+### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls/git log）
 
-## 模式自动判断
-
-- **周五**（周一=1，周五=5）→ 周报模式
-- 其他工作日 → 日报模式
-- 用户明说"周报/日报" → 覆盖自动判断
+```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  # 周报
+```
 
-## 数据采集（全部按当前开发者过滤）
+这一个命令**一次返回全部所需数据**（JSON，全部已按当前开发者过滤）：
+- `developer` — 当前开发者（报告归属）
+- `my_tasks` — 我创建/被指派的任务（`task.py list --mine` 结果）
+- `commits` — 我的 git 提交（自动扫 data/code/ 各项目，按 author 过滤）
+- `journal` — 我的 journal 学习/反馈事件
+- `my_prds` — 我写的 PRD/草稿
+- `date_range` — 报告日期范围（直接套模板）
 
-```bash
-# 1. 我的任务
-python "$R/.qoder/scripts/task/task.py" list --mine
+**拿到后直接写报告，不要再 cat/ls/git log 探查。**
+> 性能：旧方式 5-7 次工具调用、多轮思考；聚合后 1 轮 + 1 次调用（实测 650-740ms < 旧 836ms）。
+> 缺失字段为 null = 该数据源无内容（如今天无提交），正常处理，如实写"无代码产出"即可。
 
-# 2. 我的提交（按 git author 过滤）
-git log --author=<开发者名> --since="<时间范围>" --pretty=format:"%h %s (%ar)" --no-merges
+## 模式自动判断
 
-# 3. 我的产出（drafts 目录按时间筛）
-# 读 workspace/members/{dev}/drafts/ 下今日/本周改动的文件
-```
+- **周五**（周一=1，周五=5）→ 周报模式（聚合脚本传 `--days 7`）
+- 其他工作日 → 日报模式（默认 `--days 1`）
+- 用户明说"周报/日报" → 覆盖自动判断
 
 ## 🧩 QoderWork 增强：日历补数据（可选 · 无连接器则自动回退）
 
-> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 或 macOS）。
+> 通过 capability 层自动路由（Settings → Connectors，授权 Microsoft 365 或 macOS）。
 > **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，日报照常只用上面 3 个数据源，功能完全不受影响。**
 > 探测方式：仅当运行环境提供了「日历/会议」工具可直接读取时才用；看不到这些工具就跳过。
 
@@ -100,7 +102,7 @@ PM / 设计岗常一天在开会、评审，没有 git 提交，纯靠 commit
 
 保存到 `workspace/members/{dev}/journal/{YYYY-MM-DD}-{daily|weekly}.md`，然后：
 ```bash
-python "$R/.qoder/scripts/task/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 让团队/上级看到。
 
@@ -118,8 +120,8 @@ python "$R/.qoder/scripts/task/team_sync.py" push
 ### 方式 B: webhook（任何环境，脚本化）
 如果没有连接器，用引擎自带的 webhook 推送：
 ```bash
-python "$R/.qoder/scripts/report/report.py" daily --push-feishu
-python "$R/.qoder/scripts/report/report.py" weekly --push-feishu
+python "$R/.qoder/scripts/orchestration/wlkj.py" report daily --push-feishu
+python "$R/.qoder/scripts/orchestration/wlkj.py" report weekly --push-feishu
 ```
 这会通过 config.yaml 里配的飞书 bot webhook 发卡片通知。
 两种方式不冲突，连接器更富交互，webhook 更可靠无依赖。

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

@@ -7,109 +7,174 @@ trigger: "user invokes /wl-* command explicitly"
 
 # wl-search — 代码 / 知识图谱搜索
 
-## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+## 执行方式（宿主无关，自动路由）
 
-**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```python
+from capability import resolve
+cap = resolve()
+result = cap.mcp.call("search_code", {"keyword": "保险", "platform": "web"})
 ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
+
+自动路由：有 MCP 走 MCP（快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
 
 > ⚠️ 这是查代码、业务、知识图谱的**唯一入口**。禁止直接 grep `data/code/` 全库。
 
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+> 🚫 **绝对禁止**用 `findstr /s` / `grep -r` / `os.walk` / `subprocess` 全盘递归扫
+> data/code（8973+ 文件）——Windows 下会**卡死 + 疯狂弹 cmd 子进程窗口**。中文文案/报错
+> 溯源（如"车辆不存在"）只能用 `grep-text`（单进程、范围限定、不弹窗）。
+
+## ⚙️ 自取上下文
 
 - `data/index/.index-meta.json` — 图谱新鲜度；若 >7 天或不存在，提示用户
   "知识图谱可能过期，建议先说'初始化'（/wl-init）刷新"，但不要阻塞本次搜索
-- 平台意图：用户提到"Web/PC/管理端"→ `--platform web`；
-  "APP/H5/移动端"→ `--platform app`；不明确就不加该 flag
+- 平台意图：用户提到"Web/PC/管理端"→ `platform: "web"`；
+  "APP/H5/移动端"→ `platform: "app"`；不明确就不加
 
-## 双轨执行：kg.py（全系列通用） / MCP（仅 QoderWork）
+## ⚡⚡ 第一步永远是 context（强制 — 反碎片化命门）
 
-**所有能力都有两条路，功能等价：**
+**实测：旧版 AI 在十几个子命令间试错，单次搜索连调 5 次、6 轮迭代。
+本规则把这压成 1 次调用、1-2 轮。**
 
-- **QoderWork 环境**（有 `mcp__qoder-knowledge-graph` 工具）：AI 直接调 MCP 工具，更快
-- **Qoder IDE / Quest / CLI**（无 MCP）：一律跑 `python "$R/.qoder/scripts/kg/kg.py" <子命令>`
+```python
+cap.mcp.call("context_pack", {"keyword": "<业务词>", "role": "<pm|dev|design|test>"})
+```
 
-> 不确定在哪个环境？优先试 MCP 工具；MCP 工具不存在就用 kg.py。两条路返回的数据一致。
+**除非用户明确要"影响分析/覆盖矩阵/多跳遍历"等图谱高级能力（见下方后备表），
+否则第一步且唯一一步就是 `context_pack`。** 它一次返回：代码文件 + 字段 + API + PRD + Repo Wiki。
+拿到后直接 Read 2-3 个核心文件回答，**绝大多数情况禁止再跑第二个子命令。**
 
-## 能力总表（自然语言 → 命令）
+角色裁剪：
+- `role: "pm"`：字段+PRD+API（PM 首选）
+- `role: "dev"`：代码+字段+API+Wiki（开发首选）
+- `role: "design"`：页面示例+风格
+- `role: "test"`：代码+PRD+API
 
-### A. 基础搜索（找文件/接口/需求）
+> **纠偏（唯一允许追加 search 的情形）**：若 context 返回的前几个文件明显跑偏
+> （如搜"考勤"却全是二维码模块），**最多**补 1 次 `search_code` 用精确关键词定位，
+> 然后直接 Read。禁止搜超过 2 次。
 
-| 用户问法 | kg.py 命令 | MCP 工具 |
-|---------|-----------|---------|
-| "考勤代码在哪""搜保险" | `kg.py search <关键词> [--platform web\|app]` | search_code |
-| "薪资 API""有哪些接口" | `kg.py api <关键词>` | search_api |
-| "保险相关的 PRD"（防重复造轮子） | `kg.py prd <关键词>` | search_prd |
+### 能并发的工具调用必须并发，别串行等（性能命门）
 
-### B. 知识图谱高级能力（PM/开发/测试最常用）
+**串行执行是工作流慢的最大原因。** 每次工具调用要等返回（图谱查询 2-3 秒、读文件 1 秒），
+串行 10 步 = 白等 30 秒。MCP 工具调用**支持在同一回合并发**，务必利用：
 
-| 用户问法 | kg.py 命令 | MCP 工具 | 谁最该用 |
-|---------|-----------|---------|---------|
-| "改 /asset 影响哪些页面" | `kg.py impact <端点>` | get_impact | 开发改接口前 |
-| "handleExport 的完整关联" | `kg.py context360 <符号>` | context_360 | 开发/测试 |
-| "哪些功能没测试""回归盲区" | `kg.py coverage` | coverage_matrix | **PM/测试/管理** |
-| "资产管理功能画像"（几端点几按钮几测试） | `kg.py feature <功能名>` | feature_overview | **PM 写 PRD 前** |
-| "资产盘点有几步"（业务流程链） | `kg.py workflow <模块名>` | get_workflow | **PM/测试** |
-| "从资产管理能到哪些实体"（多跳遍历） | `kg.py hop <符号> [--depth 1-5]` | multi_hop | 开发/架构 |
-| "考勤的 Wiki 文档"（比读源码省 token） | `kg.py wiki <关键词>` | search_wiki | 所有人 |
+**并发规则（强制）：**
+1. **多个独立的 search/Read → 同一回合一起发**。
+2. **搜索 + 搜索 可并发**：要同时搜 `OSS` 和 `upload`，一次发 2 个 search_code。
+3. **只有"后一步依赖前一步结果"时才串行**。
+4. **一轮思考里尽量塞满**：能同回合发的全发出去，等它们一起回来。
 
-### C. 设计/原型辅助（设计师/PM 出原型前）
+**反例（慢，禁止）**：search A → 等 → Read X → 等 → search B → 等 → Read Y → 等 ...
+**正例（快，正确）**：[search A + search B] 并发 → 等 → [Read X + Read Y + Read Z] 并发 → 答
 
-| 用户问法 | kg.py 命令 | MCP 工具 |
-|---------|-----------|---------|
-| "用真实数据预填原型" | `kg.py fill-prototype <关键词> [--platform]` | fill_prototype |
-| "项目设计规范"（布局/配色/组件） | `kg.py design-system [--platform]` | get_design_system |
+---
 
-### D. 字段 / 页面风格 / 组件（写 PRD/原型参考）
+## 🔧 后备能力表（仅当 context 不够用时）
 
-这些仍走 search_index.py（kg.py 未单独封装，直接用）：
+> 以下子命令是 **context 的补充**，不是默认起点。先用 context，不够再查这里。
+> **禁止"先翻这张表挑命令"——那是旧版连调 5 次的根因。**
 
-```bash
-# 搜字段用法（返回字段标签 + 使用文件）
-python "$R/.qoder/scripts/kg/search_index.py" --field <字段名>
+### A. 基础搜索（context 跑偏时才用）
 
-# 搜同类页面示例（table/form/detail/modal/dashboard）
-python "$R/.qoder/scripts/kg/search_index.py" --style <类型> [--platform web|app]
+| 用户问法 | 调用方式 |
+|---------|---------|
+| "考勤代码在哪""搜保险" | `cap.mcp.call("search_code", {"keyword": "考勤", "platform": "web"})` |
+| "薪资 API""有哪些接口" | `cap.mcp.call("search_api", {"keyword": "salary"})` |
+| "保险相关的 PRD"（防重复造轮子） | `cap.mcp.call("search_prd", {"keyword": "保险"})` |
 
-# 浏览所有关键词 Top50
-python "$R/.qoder/scripts/kg/search_index.py" --list
+### A++. 中文文案/报错溯源（findstr 安全替代）
 
-# 项目模块概览
-python "$R/.qoder/scripts/kg/search_index.py" --modules
+用户查的是中文短语（报错文案"车辆不存在"、字段标签"项目车号"、业务词），代码标识符
+索引天然查不到。**这时只能用 grep-text**（单进程、限定 data/code、限定扩展名、不弹窗）：
 
-# 组件使用统计
-python "$R/.qoder/scripts/kg/search_index.py" --components
+```bash
+# grep-text 走 CLI 降级（不是 MCP 工具）
+python "$R/.qoder/scripts/orchestration/wlkj.py" kg grep-text 车辆不存在 --ext java --limit 20
 ```
 
-## 一次取全（推荐写 PRD/Spec 前）
+> 🚫 这是中文文案搜索的**唯一合法通道**。绝不用 `findstr /s`/`grep -r`/`os.walk` 全盘扫。
+
+### 🔴 DB. 数据库查询（表结构/数据/枚举）— 查库前必须先问环境，不可跳过
+
+当用户意图涉及**数据库 / 表结构 / 字段 / 枚举值 / 真实数据**，走 `cap.mcp.call("list_envs")` 等，**不走知识图谱**。
+
+**🚫 安全红线（最高优先级）：查任何数据库之前，必须先问用户选哪个环境。
+绝不能自动判断、绝不能默认走 test 就不问。**
+
+**强制流程（每轮对话首次查库时执行，不可省略）：**
+
+1. **先调 `cap.mcp.call("list_envs", {})`** 拿到所有环境标签；
+2. **把环境列给用户，问"要查哪个环境"，然后停下等用户选**；
+3. **用户明确选定后**，后续查询都带 `env=<用户选的标签>`。
+
+可用工具（全部带可选 `env` 参数）：
+- `cap.mcp.call("list_envs", {})` — 列出环境（**第一步必调**）
+- `cap.mcp.call("query_schema", {"table": "t_xxx", "env": "test"})` — 表结构
+- `cap.mcp.call("query_data", {"table": "t_xxx", "env": "test"})` — 数据
+- `cap.mcp.call("query_distinct", {"table": "t_xxx", "column": "status", "env": "test"})` — 枚举值
 
-要一次性拿到代码+页面+字段+PRD+API+样式+图标，用上下文打包，支持**角色裁剪**只看相关部分：
+### A+. 语义检索补充（中→英跨语言，自动触发）
+
+关键词精确匹配查不到时，**自动**用语义向量补一轮——查"报销"能命中 `expense`/`reimburse`。
+
+- 触发条件：`search` / `context` 关键词命中 ≤2 个文件时自动叠加「语义补充」段
+- 模型未装时静默跳过，不报错
+- 管理员构建向量：`python "$R/.qoder/scripts/orchestration/wlkj.py" semantic build-embeddings`
+
+### B. 知识图谱高级能力
+
+| 用户问法 | 调用方式 | 谁最该用 |
+|---------|---------|---------|
+| "改 /asset 影响哪些页面" | `cap.mcp.call("get_impact", {"endpoint": "/asset"})` | 开发改接口前 |
+| "handleExport 的完整关联" | `cap.mcp.call("context_360", {"symbol": "handleExport"})` | 开发/测试 |
+| "哪些功能没测试""回归盲区" | `cap.mcp.call("coverage_matrix", {})` | **PM/测试/管理** |
+| "资产管理功能画像" | `cap.mcp.call("feature_overview", {"feature": "资产管理"})` | **PM 写 PRD 前** |
+| "资产盘点有几步" | `cap.mcp.call("get_workflow", {"module": "assets"})` | **PM/测试** |
+| "从资产管理能到哪些实体" | `cap.mcp.call("multi_hop", {"symbol": "资产管理", "depth": 3})` | 开发/架构 |
+| "考勤的 Wiki 文档" | `cap.mcp.call("search_wiki", {"keyword": "考勤"})` | 所有人 |
+
+### C. 设计/原型辅助
+
+| 用户问法 | 调用方式 |
+|---------|---------|
+| "用真实数据预填原型" | `cap.mcp.call("fill_prototype", {"keyword": "车辆", "platform": "web"})` |
+| "项目设计规范" | `cap.mcp.call("get_design_system", {"platform": "web"})` |
+
+### D. 字段 / 页面风格 / 组件
+
+这些走 CLI 降级（不是 MCP 工具）：
 
 ```bash
-python "$R/.qoder/scripts/kg/kg.py" context <业务词> --platform <web|app> --role <pm|design|dev|test|admin>
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --field <字段名>
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --style <类型> [--platform web|app]
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --list
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --modules
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --components
 ```
 
-角色裁剪说明：
-- `--role pm`：只看字段+PRD+API，不看代码噪音（**PM 首选**）
-- `--role design`：只看页面示例+布局指纹+风格速查
-- `--role dev`：只看代码+字段+API+Wiki
-- `--role test`：只看代码+PRD+API
+## 一次取全（推荐写 PRD/Spec 前）
+
+```python
+cap.mcp.call("context_pack", {"keyword": "<业务词>", "platform": "web", "role": "pm"})
+```
 
-> 等价旧命令：`python "$R/.qoder/scripts/kg/context_pack.py" <业务词> --platform <web|app>`
+角色裁剪：
+- `role: "pm"`：只看字段+PRD+API（**PM 首选**）
+- `role: "design"`：只看页面示例+布局指纹+风格速查
+- `role: "dev"`：只看代码+字段+API+Wiki
+- `role: "test"`：只看代码+PRD+API
 
 ## 决策树：该用哪个能力？
 
 ```
 用户想查什么？
-├─ "这个东西有了吗/在哪" → search（找文件）/ prd（找需求）/ api（找接口）
-├─ "这个功能现在啥样" → feature（画像）+ context --role pm
-├─ "改这个会影响谁" → impact
-├─ "这个流程有几步" → workflow
-├─ "哪些功能缺测试" → coverage
-├─ "XX 谁调用/调用链" → context360 或 hop
-└─ 要出原型/查风格 → design-system + fill-prototype
+├─ "这个东西有了吗/在哪" → search_code / search_prd / search_api
+├─ "这个功能现在啥样" → feature_overview + context_pack --role pm
+├─ "改这个会影响谁" → get_impact
+├─ "这个流程有几步" → get_workflow
+├─ "哪些功能缺测试" → coverage_matrix
+├─ "XX 谁调用/调用链" → context_360 或 multi_hop
+└─ 要出原型/查风格 → get_design_system + fill_prototype
 ```
 
 ## 结果使用规则
@@ -119,23 +184,29 @@ python "$R/.qoder/scripts/kg/kg.py" context <业务词> --platform <web|app> --r
 3. 基于读到的真实代码/数据回答用户问题
 4. 不要把脚本原始输出整个贴给用户 —— 提炼后再回答
 
+### Glob/文件找不到怎么办
+
+context/search 已给出文件路径时，直接 Read 那个路径。若 Glob 报"未找到文件"，
+**不要**去跑 `find`/`findstr`/`dir /s` 命令行兜底。正确做法：
+- 用 `cap.mcp.call("search_code", {"keyword": "ServiceImpl"})` 在索引里搜
+- 或用 `wlkj.py kg grep-text ServiceImpl --ext java` 单进程搜文案
+
 ## 索引/图谱缺失怎么办
 
-kg.py 全容错，索引缺失会给出友好提示。遇到"知识图谱未构建"类提示：
+遇到"知识图谱未构建"类提示：
 - 对 AI 说「初始化」（/wl-init）自动刷新
-- 或 `python "$R/.qoder/scripts/kg/kg_build.py"` 手动构建
-- 或 `python "$R/.qoder/scripts/setup/init_doctor.py" --fix` 自检修复
+- 或 `python "$R/.qoder/scripts/orchestration/wlkj.py" kg-build` 手动构建
+- 或 `python "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix` 自检修复
 
 ## 高频场景对照
 
-| 用户问法 | 该跑的命令 |
-|---------|-----------|
-| "考勤代码在哪" | `kg.py search 考勤` |
-| "改 /asset 接口影响谁" | `kg.py impact /asset` |
-| "哪些功能没测试覆盖" | `kg.py coverage` |
-| "资产管理功能完整吗" | `kg.py feature 资产管理` |
-| "资产盘点业务流程" | `kg.py workflow assets` |
-| "从资产管理关联到哪些" | `kg.py hop 资产管理 --depth 3` |
-| "nickName 字段在哪用" | `search_index.py --field nickName` |
-| "列表页有哪些例子（Web）" | `search_index.py --style table --platform web` |
-| "写 PRD 前一次取全" | `kg.py context 车辆 --role pm` |
+| 用户问法 | 调用方式 |
+|---------|---------|
+| "考勤代码在哪" | `cap.mcp.call("search_code", {"keyword": "考勤"})` |
+| "改 /asset 接口影响谁" | `cap.mcp.call("get_impact", {"endpoint": "/asset"})` |
+| "哪些功能没测试覆盖" | `cap.mcp.call("coverage_matrix", {})` |
+| "资产管理功能完整吗" | `cap.mcp.call("feature_overview", {"feature": "资产管理"})` |
+| "资产盘点业务流程" | `cap.mcp.call("get_workflow", {"module": "assets"})` |
+| "nickName 字段在哪用" | `wlkj.py search --field nickName` |
+| "列表页有哪些例子（Web）" | `wlkj.py search --style table --platform web` |
+| "写 PRD 前一次取全" | `cap.mcp.call("context_pack", {"keyword": "车辆", "role": "pm"})` |

package/templates/qoder/skills/wl-spec/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-spec — 生成开发 Spec（/wl-spec 命令入口）
 
@@ -22,11 +22,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 金额）见
   `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
 
@@ -39,7 +41,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 5. 通知开发评审
 6. 发布后自动同步：
    ```bash
-   python "$R/.qoder/scripts/task/team_sync.py" push
+   cap.mcp.call("sync", {"direction": "push"})
    ```
 
 ## Review 模式