@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -1,7 +1,7 @@
 ---
 name: wl-report
-description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. 用户说'写日报''周报''我今天干了啥''这周做了什么''出个报告'时触发。"
-trigger: "用户说'日报''周报''我干了啥''今天做了什么''本周工作''出报告''/wl-report'"
+description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. "
+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-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.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/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 让团队/上级看到。
 
@@ -118,8 +120,8 @@ python "$R/.qoder/scripts/team_sync.py" push
 ### 方式 B: webhook（任何环境，脚本化）
 如果没有连接器，用引擎自带的 webhook 推送：
 ```bash
-python "$R/.qoder/scripts/report.py" daily --push-feishu
-python "$R/.qoder/scripts/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

@@ -1,115 +1,180 @@
 ---
 name: wl-search
-description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。用户说'查一下''代码在哪''搜保险''考勤API''字段含义''改这个影响谁''哪些功能没测试''资产盘点有几步''XX功能画像'时触发。"
-trigger: "用户问代码/业务/API/字段/页面在哪，或说'查''搜''找''有哪些文件''定位''影响''覆盖''功能画像''业务流程''调用链'"
+description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。"
+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/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.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/search_index.py" --field <字段名>
+### A. 基础搜索（context 跑偏时才用）
 
-# 搜同类页面示例（table/form/detail/modal/dashboard）
-python "$R/.qoder/scripts/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/search_index.py" --list
+### A++. 中文文案/报错溯源（findstr 安全替代）
 
-# 项目模块概览
-python "$R/.qoder/scripts/search_index.py" --modules
+用户查的是中文短语（报错文案"车辆不存在"、字段标签"项目车号"、业务词），代码标识符
+索引天然查不到。**这时只能用 grep-text**（单进程、限定 data/code、限定扩展名、不弹窗）：
 
-# 组件使用统计
-python "$R/.qoder/scripts/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.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/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.py" context <业务词> --platform <web|app> --role
 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_build.py"` 手动构建
-- 或 `python "$R/.qoder/scripts/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

@@ -1,7 +1,7 @@
 ---
 name: wl-spec
-description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. 用户说'生成规格''写spec''出技术方案''把PRD转开发文档'或输入 /wl-spec 时触发。"
-trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-spec'"
+description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-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`。
 
 # 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/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/team_sync.py" push
+   cap.mcp.call("sync", {"direction": "push"})
    ```
 
 ## Review 模式

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

@@ -1,7 +1,7 @@
 ---
 name: wl-status
-description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. 用户说'项目怎么样''进度''健康度''路线图''现在在做什么''整体情况'时触发。"
-trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况''/wl-status'"
+description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. "
+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-status — 项目状态总览
 
@@ -19,17 +19,33 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前开发者
-- `data/index/.index-meta.json` — 图谱新鲜度（健康度计算用）
-- `.qoder/learning/eval-history.jsonl` — EVA 评估历史（健康度趋势用，可能不存在）
-- `workspace/tasks/*/task.json` — 全部任务（current 维度用）
-
-## 维度 1：current（当前迭代）
+### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls）
 
 ```bash
-python "$R/.qoder/scripts/task.py" list
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+python "$R/.qoder/scripts/orchestration/wlkj.py" status-snapshot "$R"
 ```
-展示：
+
+这一个命令**一次返回全部所需数据**（JSON）：开发者、图谱新鲜度、EVA 历史、
+任务列表、团队同步、配置、成员、学习记录。**拿到后直接算健康度，不要再 cat/ls 探查。**
+
+> 性能：旧方式 5 轮迭代 + 10 次调用；聚合后 1 轮 + 1 次调用。
+> 缺失字段为 null = 该数据源不存在（如 eval_history 没跑过 EVA），正常处理即可。
+
+### 字段说明（聚合脚本返回的 JSON）
+
+- `developer` — 当前开发者（.developer 内容）
+- `index_meta` + `index_age_days` — 图谱元数据 + 距今天数（健康度·索引新鲜度）
+- `eval_history` — EVA 最近 10 次评估（健康度·EVA 合格率；null=未跑过）
+- `feedback_count` — 学习反馈条数（健康度·学习成长；null=无）
+- `task_list` — 全部任务（current 维度）
+- `team_sync` — ahead/behind/未同步数（健康度·团队同步）
+- `tasks_dir` / `patterns` / `members` — 目录清单（null=不存在）
+- `config_summary` — 项目配置摘要
+
+## 维度 1：current（当前迭代）
+
+直接用聚合脚本返回的 `task_list` 字段（**不要再调 task.py**）：
 - 当前活动任务（标 `*` 的那条）
 - 进行中任务清单 + 各自进度
 - 最近 5 个动作（建任务/finish/PRD 发布等，从 task.json 的 status 历史推）
@@ -52,21 +68,21 @@ python "$R/.qoder/scripts/task.py" list
 | 索引新鲜度 | 20% | .index-meta.json 的 last_sync 距今天数 |
 | 按时交付 | 20% | 近期 task finish 是否在计划期内 |
 | 团队同步 | 15% | `team_sync.py status` 的 ahead/behind |
-| 流水线流转 | 10% | task 在各阶段的停留时长 |
-| 学习成长 | 10% | learning 记录条数 |
+| **工作流采纳** | **10%** | **usability_score.py 的采纳分（U2/U3/U4/U6 达标率）** |
+| 流水线流转 | 5% | task 在各阶段的停留时长 |
+| 学习成长 | 5% | learning 记录条数 |
 
 判定：≥4 健康 / 3–4 有风险 / <3 需关注。
+> 7 维权重合计 = 1.00。**工作流采纳**是吸收宿主能力后新增的维度，回答"工作流用不用得起来"。
 
-## 团队同步健康（必跑）
+## 团队同步健康（用聚合数据）
 
-```bash
-python "$R/.qoder/scripts/team_sync.py" status
-```
+直接用聚合脚本返回的 `team_sync` 字段（**不要再调 team_sync.py**）：
 看 ahead/behind 是否对齐，未同步产出有几个。
 
 ## 🧩 QoderWork 增强：日历校准健康度（可选 · 无连接器则自动回退）
 
-> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 / macOS 日历，邮件可选）。
+> 通过 capability 层自动路由（Settings → Connectors，授权 Microsoft 365 / macOS 日历，邮件可选）。
 > **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，健康度照常按上表纯本地数据计算，不受影响。**
 > 探测方式：仅当运行环境提供了「日历」工具可直接读取时才用。
 
@@ -81,3 +97,19 @@ python "$R/.qoder/scripts/team_sync.py" status
 
 一段总览 + 三个分维度小节。健康度分数醒目显示。发现问题（如索引过期、
 未同步堆积、EVA 合格率低）在结尾列"建议动作"清单。
+
+## 📊 可用性看板（吸收宿主动态 UI 能力 · 双轨）
+
+健康度展示后，**追加一个可用性看板**（让"工作流用没用起来"可视化）：
+
+```bash
+python "$R/.qoder/scripts/orchestration/wlkj.py" usability --html
+```
+
+- **QoderWork**：脚本自动调 `qoder_show_widget` 把交互看板（仪表盘 + 绿黄红指标条）**嵌入对话流**。
+- **纯 IDE / CLI**：自动降级——看板落盘到 `workspace/members/{dev}/journal/dashboard-*.html`，
+  你把路径告诉用户让他点开看；同时口述核心数字（采纳分 + 红灯项）。
+- 看板数据源：eval-history + feedback + learning.yaml（同 `usability` 命令）。
+
+> 这是吸收宿主 Skills 动态 UI 能力的落点：富宿主嵌入对话，纯 CLI 落盘兜底，能力层自动切。
+