@hupan56/wlkj 3.0.0 → 3.1.2

package/templates/qoder/skills/wl-status/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-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/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/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/task/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/task/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 落盘兜底，能力层自动切。
+

package/templates/qoder/skills/wl-task/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-task — 任务管理（7 站之「任务」站 · 产品工位）
 
@@ -25,8 +25,10 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 | 用户说什么 | 动作 | 跑什么 |
 |-----------|------|--------|
 | "建个任务 XXX" / "把刚才需求建成任务" / "create" | **create** | `task.py create`（带 PRD 衔接） |
-| "列一下任务" / "我的任务" / "有哪些任务" / "list" | **list** | `task.py list` |
-| "接下来做啥" / "能做的有哪些" | **list --ready** | 只看能立刻开始的 |
+| "列一下**本地**任务" / "有哪些任务" / "list" | **list** | `task.py list`（本地离线缓存，非禅道） |
+| **"我的任务" / "我的禅道" / "这周干啥" / "我的Bug"** | **自然查询** | ★直接 `my_workbench()`（见下方禅道查询总表），不走本命令工序 |
+| **"看下#301" / "需求#761怎么样了" / "Bug状态"** | **自然查询** | 直接 `get_task` / `get_story_detail` / `get_bug`，自然回答 |
+| "接下来做啥" / "能做的有哪些" | **list --ready** | 只看能立刻开始的（本地依赖视角） |
 | "卡住的有哪些" / "哪些被阻塞" | **list --blocked** | 只看有未完成依赖的 |
 | "看下 XXX 任务" / "XXX 怎么样了" / "show" | **show** | `task.py show <名>` |
 | "开始做 XXX" / "启动 XXX" / "start" | **start** | `task.py start <名>` |
@@ -36,16 +38,96 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 | "排期" / "甘特图" / "排个日期" / "plan" | **plan** | `task.py gantt` + set-due |
 | 模糊 / 拿不准 | 先 list 给全貌 | 再问要操作哪个 |
 
+> **边界**：上面"自然查询"行的（我的任务/看进度/Bug状态）—— AI 直接用禅道 MCP 工具回答，**不拉入工序流程**。
+> "PRD发禅道/记工时/改状态"这类**显式操作**才走工序（见 wl-task.md 的 zentao 剧本）。
+
+### 🔌 宿主路由：禅道怎么调（看你在哪个宿主）
+
+> ★ 丝滑关键。禅道工具有两条入口，用错就慢/重复 spawn/报错。
+
+| 宿主 | 调用入口 | 何时用 |
+|------|---------|--------|
+| **QoderWork** | `qw_mcp_call("工具名", {参数})` | 第一宿主。QoderWork 已起 zentao 进程，直接复用，**省 list/get 两步元调用**。下表工具名确定时直接 call。 |
+| **Qoder IDE / Quest** | `mcp__qoder-zentao__工具名(参数)` | IDE 把 MCP 工具暴露成 `mcp__<server>__<tool>`。 |
+| **CLI / 其他** | `cap.mcp.call("工具名", {参数})` | 无原生 MCP，capability 层 spawn 本地 server。 |
+
+**判定宿主**：`QODER_SESSION_ID` 存在 = QoderWork；否则 `detect_host()`。下表统一用 `qw_mcp_call(...)` 示意（CLI 换 `cap.mcp.call`，参数一致）。
+
+### ★★★ 禅道查询总表 + 三铁律（处理任何禅道意图，先查这张表，禁止瞎试）
+
+> 这三轮实测的病根：AI 看到"看我的禅道X"找不到路就**瞎试→枚举→调用爆炸/token浪费**。
+> 下面这张表是"宪法"——任何禅道意图，**先匹配表里的行，照着走**。匹配不上再问用户，**绝不逐个枚举**。
+
+#### 🔒 三条铁律（违反 = 失败，AI 必读）
+
+1. **禁止枚举扇出**：拿到 list 结果后，**绝不**逐个调 `get_*_detail`。list 返回的 `id+name+status` 已够用；只有用户明确点了某条（"看#761详情"），才单独 `get_story_detail(story_id=761)` 一次。
+2. **🚫 跨域不冒充（v3.1.5 新增，最重要）**：用户问「任务」就查 task 域，问「需求」查 story 域，问「Bug」查 bug 域。**查不到如实说"没有指派给你的任务"+贴查询证据，绝不拿需求/Bug 顶替任务来回答**。用户问"我的任务"却收到需求列表 = 严重失败。
+3. **写操作要确认**：改/删需求、执行、版本这类**无归属校验**的工具，调之前先把要操作的项列出来让用户确认（防改错队友/全局资源）。任务/Bug 的 start/finish/resolve 等有 `_assert_owner` 兜底，但仍建议先 get 一次确认是我的。
+
+#### 意图路由总表（用户说什么 → 调什么 → 调几次）
+
+| 用户说的意图 | 直达工具 | 调用次数 | 关键约束 |
+|------------|---------|:---:|---------|
+| **看我的禅道任务/这周干啥/我手头有啥** | ★`my_workbench()` | **1** | 跨执行/产品全量聚合，一行拿全！不再逐执行查 |
+| 看我未开始/进行中的任务 | `list_my_tasks(status='wait')` / `list_my_tasks(status='doing')` | 1 | 跨执行全量 |
+| **看我的禅道需求** / "我的需求" | `my_workbench()` 看需求段（或逐产品 `list_stories`） | 1 | 🚫**禁逐个 get_story_detail** |
+| **看我的Bug** | ★`list_my_bugs()` | **1** | 跨产品全量，不再逐产品查 |
+| 看某执行任务(已知eid) | `list_execution_tasks(eid)` | 1 | 默认只看我的 |
+| 看全队任务/需求/Bug | 对应工具 + `all=true` | 1 | ★**必须用户明说"全队"才加** |
+| 看某条详情（"#761怎么样"） | `get_story_detail` / `get_task` / `get_bug` (该 id) | 1 | 用户**点了具体 ID** 才调 |
+| 看有哪些产品/执行/版本 | `list_products` / `list_executions` / `list_builds(project_id=9)` | 1 | 导航类，可自由调（公开结构） |
+| 建需求 / PRD发禅道 | `create_story` → 然后**主动问关联版本**（见下） | 1+ | 不知产品先 `list_products` 勾选 |
+| 关联版本 | `list_builds(project_id=9)` → `link_story_to_build` | 2 | 多选 = 一个需求进当前+未来版本 |
+| 拆需求为任务 | `list_executions` 选 → `create_task` | 2 | 不填 assignedTo 默认指派给我 |
+| 开始/完成/记工时任务 | `start_task` / `finish_task` / `log_effort` (task_id) | 1 | 有归属校验；finish 要问消耗工时 |
+
+#### 「看我的工作」统一范式（v3.1.5 升级）
+
+```
+★ 首选: my_workbench() —— 一次返回任务+需求+Bug 三域全量聚合, 跨所有执行/产品不漏。
+  这是回答"我手头有什么活/我的任务/我的禅道"的默认工具, 调用次数从原来的 N(逐执行) 降到 1。
+
+单域查询: list_my_tasks(status=...) / list_my_bugs() —— 跨执行/产品全量, 只看我的。
+
+旧的逐执行/逐产品查法 (list_execution_tasks 逐个执行、list_stories 逐个产品) 仍可用,
+但只用于"已知具体执行/产品ID"的场景。查"我的全部"会被漏数据(实测 61 执行逐个查会漏)。
+```
+
+#### 归属账号未识别（v3.1.5 起工具层直接拒绝）
+
+若 `my_workbench` / `list_my_tasks` / `list_my_bugs` / `list_execution_tasks`(默认) 返回：
+`🚫 未识别禅道身份: member.json 缺 zentao_account...`
+→ 这是**工具层主动拒绝**（不再静默降级）。原样把提示转述给用户，引导跑 `/wl-init` 配置。
+**绝不绕过**（不传 all=true 去看全队当我的，不拿别的域顶替）。配好后重启 MCP 生效。
+
+
+#### 建需求后主动问版本（★ 你们的版本=项目级 build）
+
+> 你们的「版本」是**项目级 build**（项目#9 下按周 `V+日期`，如 `V20260625`），不是产品级 plan/release。一个需求可能**同时进当前+未来版本**，所以**显式让 PM 多选**，不自动关联。
+
+建需求/评审通过后，AI **主动**列最近 build 让 PM 勾选：
+```
+AI: 要关联到哪个版本?(最近 6 个 build):
+    [1] #22 V20260625 (本周)   [2] #21 V20260618 (上周)   [3] #16 V20260604 ...
+PM> 1,3        ← 多选 = 一个需求进当前版本(本周发)+未来版本
+AI: ✅ 需求#761 已关联 build#22(本周) + #16(未来)
+```
+- 候选：`list_builds(project_id=9)` 取最近 6 个，按时间倒序编号。
+- 关联：`link_story_to_build(build_id=<选中>, stories=[<需求ID>])`，**逐个 build 调一次**。
+- PM 也可主动触发："把#761 关联到本周版本" → AI 查本周 build 再关联。
+
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
-- `.qoder/.developer` — 当前开发者（assignee 默认值）
-- `.qoder/.current-task` — 当前活动任务（"开始做""完成了"默认对它操作）
-- 列出已有任务：`python "$R/.qoder/scripts/task/task.py" list`
+- **当前身份**：当前开发者（assignee 默认值）。读法：先 `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`（输出任务路径；空=无活动任务）。
+- 列出已有任务：`cap.mcp.call("list_tasks", {})`
 - 衔接 PRD：扫 `workspace/members/{dev}/drafts/REQ-*.md` + `data/docs/prd/REQ-*.md`
 
 ## 🔒 三道前置检查（任何动作前先做，保证健壮）
 
-1. **身份检查**：`.developer` 缺失 → 停下，提示先 `/wl-init`，不继续（否则 create 会把 assignee 写空）。
+1. **身份检查**：跑 `python "$R/.qoder/scripts/foundation/core/paths.py" whoami`，无输出/退出码1 = 未初始化 → 停下，提示先 `/wl-init`（否则 create 会把 assignee 写空）。
 2. **空数据兜底**：tasks 目录不存在/空 → 读操作友好提示"还没有任务"，不报错；create 直接建。
 3. **脚本退出码**：`task.py` 返回非 0 → 原样读 stderr 告诉用户。`4`=权限不足（零信任 ACL），`1`=任务不存在/JSON 缺失。**绝不绕过 ACL。**
 
@@ -56,7 +138,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 **create（最高频）—— PRD 衔接不丢字段：**
 - 有 PRD → 从 PRD 提取标题/模块/验收点，**别让用户重述**；把 REQ-ID 记进 task.json 的 `tags`。
 - 无 PRD → 用用户给的一句话当标题。
-- 建完 push：`python "$R/.qoder/scripts/task/team_sync.py" push`
+- 建完 push：`cap.mcp.call("sync", {"direction": "push"})`
 
 **rank（RICE）—— 一次取全，别逐个问：**
 1. `task.py list --status planning` 拿全待排任务
@@ -105,7 +187,7 @@ RICE = Reach × Impact × Confidence ÷ Effort
 
 `create` / `finish` / `archive` 改了任务状态，都要推给团队（用户永不碰 git）：
 ```bash
-python "$R/.qoder/scripts/task/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 
 ## finish 后：自动生成测试交接画像（可选增强）
@@ -124,7 +206,7 @@ python "$R/.qoder/scripts/task/team_sync.py" push
 
 ## 🧩 QoderWork 增强：待办双向同步（可选 · 无连接器则自动回退）
 
-> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 待办 / OneNote，或 macOS 提醒事项）。
+> 通过 capability 层自动路由（Settings → Connectors，授权 Microsoft 365 待办 / OneNote，或 macOS 提醒事项）。
 > **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，任务只在本地 task.json 管理，完全够用。**
 > 探测方式：仅当运行环境提供了「待办 / To-Do」工具可直接读写时才用。
 

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

@@ -46,9 +46,9 @@ trigger: "user invokes /wl-* command explicitly"
 **③ 用例 JSON 必须用 `--cases-file` 传文件，禁止内联 `--cases`。**
 ```bash
 # ✅ 对: 写文件再传路径(不截断)
-python "$R/.qoder/scripts/test/autotest.py" quick --cases-file <文件路径> --env test --platform web
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases-file <文件路径> --env test --platform web
 # ❌ 错: 内联(长JSON截断, 多条用例必丢)
-python "$R/.qoder/scripts/test/autotest.py" quick --cases '[{"case_id"...(超长)...}]'
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
 ```
 
 **④ 无锚点时必须先 snapshot 拿真实 anchor 再填，禁止预猜 CSS selector。**
@@ -67,9 +67,9 @@ python "$R/.qoder/scripts/test/autotest.py" quick --cases '[{"case_id"...(超长
 **⑥ recall 的 `--url` 必须用相对路径（无前导斜杠），避开 Git-bash/MSYS 路径转换坑。**
 ```bash
 # ✅ 对: 相对路径 (MSYS 不转换)
-python "$R/.qoder/scripts/test/autotest.py" recall --url auth/login
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
 # ❌ 错: 前导斜杠会被 Windows Git-bash 转成 /D:/.../Git/auth/login
-python "$R/.qoder/scripts/test/autotest.py" recall --url /auth/login
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
 ```
 （脚本已加 normalize 兜底能修这个，但别依赖兜底——直接写相对路径最干净。）
 
@@ -98,8 +98,8 @@ python "$R/.qoder/scripts/test/autotest.py" recall --url /auth/login
 > R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 > ```
 > `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。
-> **读到 1 次记住，后续所有脚本统一用 `python "$R/.qoder/scripts/<子包>/<脚本>.py"`（子包: kg/build/test/setup/io），不要再搜！**
-> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `python "$R/.qoder/scripts/setup/install_qoderwork.py"`。
+> **后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`，不要再搜！**
+> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `python "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
 
 - `<R>/.qoder/.developer` — 当前开发者
 - `<R>/.qoder/config.yaml` 的 `autotest:` 段 — 环境/域名
@@ -112,7 +112,7 @@ python "$R/.qoder/scripts/test/autotest.py" recall --url /auth/login
 
 **唯一正确做法**——1 条命令查 MySQL sys_menu 真实路由：
 ```bash
-python "$R/.qoder/scripts/kg/search_index.py" --routes 保险
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
 # → 保险管理 -> /veh/vehicle/vehAffair/insurance
 ```
 - 数据来自 MySQL `sys_menu` 表（后台动态菜单，**唯一事实源**）
@@ -121,10 +121,10 @@ python "$R/.qoder/scripts/kg/search_index.py" --routes 保险
 
 ### 生成用例时用 MySQL MCP 补真实数据（少手填、覆盖边界）
 
-1. **取真实测试数据**：需要业务单号/账号时 `mcp__qoder-mysql__query_data(table='表名', columns='id,单号列', where='条件', limit=5)`
+1. **取真实测试数据**：需要业务单号/账号时 `cap.mcp.call("query_data", {"table": "表名", "columns": "id", "单号列", "where": "条件", "limit": "5"})`
    - 拿测试库真实可用的数据，别编造。填进用例的 data 里。
    - [QAS环境] 数据行仅参考格式，不代表线上。
-2. **枚举边界覆盖**：涉及状态/类型字段时 `mcp__qoder-mysql__query_distinct(table='表名', column='状态列')`
+2. **枚举边界覆盖**：涉及状态/类型字段时 `cap.mcp.call("query_distinct", {"table": "表名", "column": "状态列"})`
    - 查真实取值范围（如 case_status = 1/2/3/4），按每个值造边界用例。
    - 取值范围可信 → 用例枚举全覆盖，不漏分支。
 
@@ -159,18 +159,27 @@ coverage_matrix()
 
 **不要任务/PRD。零搜索。** 用意图+锚点格式（A方案），observe-act-extract 执行。
 
-### Step 0：recall 查锚点（用相对 URL，避开 MSYS 坑）
+### Step 0 + 0.5：recall 查锚点 + context_pack 取全（两者无依赖，同回合并发）
+
+> Step0（recall 锚点）和 Step0.5（context_pack 上下文）互不依赖 → **同一条消息并发发**，别先跑0再跑0.5。
+
+**Step 0：recall 查锚点**（用相对 URL，避开 MSYS 坑）
 ```bash
-python "$R/.qoder/scripts/test/autotest.py" recall --url auth/login
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
 ```
 - **有锚点** → 生成用例时直接把 anchor 填进 step（确定性命中，快、零 LLM）
 - **无锚点（首次）** → **先 navigate + snapshot 拿真实锚点，再生成用例**（见 Step 0.6）
 
-### Step 0.5：用知识图谱 MCP 增强用例（1 次调用取全）
+**Step 0.5：用知识图谱 MCP 增强用例**（1 次调用取全，与 recall 并发）
+```python
+context_pack(keyword='功能名', platform='web', role='test')
+```
+- 返回(role=test 裁剪): 代码落点 + 相关历史 PRD 标题 + API + 字段
+- 拿到后用于: API→断言点, 字段→fill 步骤更准
 
-**只调 1 次** `context_pack(keyword='功能名', platform='web', role='test')`：
-- 返回(role=test 裁剪): 代码 + PRD验收标准 + API + 数据库表结构(第8段)
-- 拿到后用于: PRD验收标准→用例expected, API→断言点, 字段→fill步骤更准
+> ⚠️ **注意：context_pack 不抓 PRD 验收标准正文**（它只取 PRD 的 title+keywords，
+> 不解析「## 验收标准」章节）。**业务规则断言不要指望 context_pack**，它给不了 expected。
+> 要把 PRD 验收标准翻译成可执行断言，用 `assertion-gen` 子命令（见下方专节）。
 
 > 图谱无数据 → 跳过，按通用模式生成。**不要再单独调 feature_overview**（信息重叠，浪费一轮）。
 
@@ -203,8 +212,8 @@ snapshot 返回形如：
 
 **🎯 知道页面名/URL 时，AI 先查按钮+接口画像（最精准，1 条命令拿到所有交互点）：**
 ```bash
-python "$R/.qoder/scripts/test/autotest.py" page --kw 保险        # 按业务名查
-python "$R/.qoder/scripts/test/autotest.py" page --url /veh/insurance  # 按URL查
+python "$R/.qoder/scripts/orchestration/wlkj.py" test page --kw 保险        # 按业务名查
+python "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance  # 按URL查
 ```
 （这是 AI 在 `/wl-test` 流程内部自动调用的工具，**用户只用 `/wl-test`，不碰此命令**。）
 输出每个按钮的 handler + 调用接口 + HTTP 方法 + 置信度，**直接对应到用例的 click→assert 断言点**。开发 `finish` 任务时也会自动生成 `test-handoff.md`，内容同此画像——交接场景直接读那份即可，不必重查。
@@ -236,7 +245,7 @@ python "$R/.qoder/scripts/test/autotest.py" page --url /veh/insurance  # 按URL
 # AI 先写文件:
 #   写 workspace/members/{dev}/drafts/_autotest-cases.json
 # 再调:
-python "$R/.qoder/scripts/test/autotest.py" quick \
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
   --cases-file workspace/members/{dev}/drafts/_autotest-cases.json \
   --desc "<用户描述>" --platform <web|app>
 ```
@@ -317,7 +326,7 @@ python "$R/.qoder/scripts/test/autotest.py" quick \
 
 **执行方式**：把测试结果 + 测试中 `browser_snapshot` 看到的页面元素一起回传：
 ```bash
-python "$R/.qoder/scripts/test/autotest.py" quick \
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
   --cases-file <之前的cases文件> \
   --record '{"Q-1":"pass","Q-2":"pass","Q-3":"pass"}' \
   --page-json '{"url":"/veh/vehicle/vehAffair/insurance","elements":[{"role":"textbox","name":"车牌号"},{"role":"button","name":"搜索"},{"role":"button","name":"新增"}]}'
@@ -338,11 +347,11 @@ python "$R/.qoder/scripts/test/autotest.py" quick \
 ## browser 基于任务的浏览器测试（用户明确给了任务名时）
 
 ```bash
-python "$R/.qoder/scripts/task/task.py" list                     # 确认任务存在
-python "$R/.qoder/scripts/test/autotest.py" generate <task>      # 生成骨架到 autotest-cases.jsonl
+cap.mcp.call("list_tasks", {})                     # 确认任务存在
+python "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架到 autotest-cases.jsonl
 # AI 读任务 PRD「验收标准」补全 steps/expected (真实数据用 {{ask:}}, 不搜源码)
-python "$R/.qoder/scripts/test/autotest.py" run <task>           # 注入+出执行计划
-python "$R/.qoder/scripts/test/autotest.py" run <task> --record '{"..":"pass"}'  # 回收结果
+python "$R/.qoder/scripts/orchestration/wlkj.py" test run <task>           # 注入+出执行计划
+python "$R/.qoder/scripts/orchestration/wlkj.py" test run <task> --record '{"..":"pass"}'  # 回收结果
 ```
 
 **回归测试增强（图谱 MCP）**：测接口改动时，用 `get_impact` 查影响范围，自动覆盖受影响页面：
@@ -363,6 +372,43 @@ JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
 
 ---
 
+## 📋 断言生成 assertion-gen（业务规则断言 · 第三档专用）
+
+> 解决痛点：quick 模式的 `_check_expect` 能执行 `{fetch, jsonpath, equals}` 断言，
+> 但那个 **equals 期望值从哪来** 没人管——靠 LLM 瞎编不可信。
+> `assertion-gen` 把"PRD 验收标准 → 可执行断言"这条断链接上。
+
+**分工（呼应图谱边界三条红线）：**
+- **人补语义**：PRD 里写结构化验收（Given-When-Then，或"条件-操作-预期"带接口名/状态码/字段值）
+- **图谱补字段**：`page_probe` 查按钮→接口，`field_map` 查中文标题→字段名
+- **真跑定对错**：assertion-gen 只产断言 JSON，跑不跑交给 quick/webaccess
+
+**什么时候用**：业务规则断言（保险延期要审批、退保校验、状态流转）——这是 quick 通用模式
+搞不定的第三档。冒烟（页面没崩）、CRUD 流（新增→列表出现）用 quick 就够，不需要这个。
+
+```bash
+# 从任务 PRD 的验收标准章节抿断言
+python "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen --task <任务名> --page 保险
+
+# 临时用 GWT 文本兜底（PRD 没写验收标准时）
+python "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
+  --gwt "Given 已登录保险页 When 点击延期提交 Then 接口 /api/insurance/delay 返回 code=200 且 状态列显示审批中" \
+  --page 保险
+```
+
+**输出**：`workspace/tasks/<task>/assertions.json`，每条断言带 `source` 置信度标记：
+- `规则·句中含接口` / `图谱·按钮画像` = 可信（接口路径已确定）
+- `需确认·字段未命中` = 待补（字段表查不到，留 `{{ask:}}` 占位）
+
+**两条铁律（assertion-gen 内置）：**
+1. **抽不到就老实说**：PRD 验收标准为空/纯描述 → 输出"无可抽取的结构化断言"，**绝不编造**断言。
+2. **语义不背书**：字段补全命中标 `[图谱]`，查不到留占位标 `[需确认]`，不让图谱假装懂业务。
+
+**下一步**：把 `assertions.json` 的 assertions 数组并进 quick 用例的 steps（`intent:"assert"`），
+用 webaccess 或 quick 执行真跑验证。**assertion-gen 自己不执行、不真跑。**
+
+---
+
 ## 🔐 测试数据处理原则（个人 vs 团队隔离）
 
 - **绝不编造**：账号/密码/手机号用 `{{ask:描述}}` 占位，问用户要。
@@ -370,9 +416,9 @@ JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
   域名才放 config（全团队一致）。账号密码每人不同 → 个人文档。
 - **个人文档**：`workspace/members/{你的名字}/autotest-data.yaml`（gitignored，永不 push）
 ```bash
-python "$R/.qoder/scripts/test/autotest.py" init-data                          # 生成模板
-python "$R/.qoder/scripts/test/autotest.py" set-data 登录账号 test --env test   # 填(按环境/平台分块)
-python "$R/.qoder/scripts/test/autotest.py" list-data --env test                # 查看(密码脱敏)
+python "$R/.qoder/scripts/orchestration/wlkj.py" test init-data                          # 生成模板
+python "$R/.qoder/scripts/orchestration/wlkj.py" test set-data 登录账号 test --env test   # 填(按环境/平台分块)
+python "$R/.qoder/scripts/orchestration/wlkj.py" test list-data --env test                # 查看(密码脱敏)
 ```
 run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆盖。
 
@@ -382,7 +428,7 @@ run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆
 
 **Step A：查登录态**
 ```bash
-python "$R/.qoder/scripts/test/autotest.py" login-state show
+python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
 ```
 
 **Step B：按登录态决定行为**
@@ -403,8 +449,8 @@ python "$R/.qoder/scripts/test/autotest.py" login-state show
 
 ```bash
 # 手动操作（一般不用，AI 会自动）:
-python "$R/.qoder/scripts/test/autotest.py" login-state mark --env pre --platform web   # 标记已登录
-python "$R/.qoder/scripts/test/autotest.py" login-state clear --env pre                 # 清除(强制重登录)
+python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state mark --env pre --platform web   # 标记已登录
+python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state clear --env pre                 # 清除(强制重登录)
 ```
 
 ## 🧩 QoderWork 增强：浏览器自动执行（可选 · 无连接器则自动回退）

package/templates/qoder/templates/prd-full-template.md

@@ -76,6 +76,13 @@
 #### 原型地址
 {prototype-{feature}.html 的路径；两端需求分别给 -web/-app 两个文件}
 
+> **原型可选（v3.1）**：若本需求为纯规则/接口/定时/参数下发/计算类（无 UI 变化），
+> 经用户在「轻反思+批量确认」环节明确同意不画原型后，本节写：
+> `无（{原因}，经用户确认豁免）`
+> 并在 PRD 第 1 行 `@contract` 头标记 `prototype: none`。
+> 下游 `/wl-design` 读到 `prototype: none` 跳过原型环节；`/wl-code` 直接以 PRD 字段表为准。
+> eval_prd 检测到 `prototype: none` 时 A2 自动跳过（满分从 100 降到 70，照样能 PASS）。
+
 ## 非功能性需求
 {性能（响应时间/并发）、安全（权限）、兼容性（浏览器/系统版本）、可用性}