@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -1,7 +1,7 @@
 ---
 name: wl-task
-description: "任务管理 + RICE 优先级 + 依赖排期。7 站流水线的'任务'站，产品在这里把 PRD 落成任务。Task management with RICE prioritization. 用户说'建任务''排优先级''开始做这个''任务做完了''列一下任务''归档''排期'时触发。"
-trigger: "用户说'建任务''建个任务''排优先级''开始做''做完了''看任务''列任务''归档''排期''甘特图''/wl-task'"
+description: "任务管理 + RICE 优先级 + 依赖排期。7 站流水线的'任务'站，产品在这里把 PRD 落成任务。Task management with RICE prioritization. "
+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-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.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/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/team_sync.py" push
+cap.mcp.call("sync", {"direction": "push"})
 ```
 
 ## finish 后：自动生成测试交接画像（可选增强）
@@ -124,7 +206,7 @@ python "$R/.qoder/scripts/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

@@ -1,7 +1,7 @@
 ---
 name: wl-test
 description: "测试工作流: 意图式用例 + Playwright MCP 执行 + 锚点缓存。触发: /wl-test 命令; 或自然语言里带'功能验证点'(如'测一下XX支不支持YY''验一下XX能不能ZZ''XX对不对')。纯随手看('打开XX页''看看登录')→不走本工作流。需确认(DANGEROUS)。"
-trigger: "/wl-test 命令; 或自然语言带具体功能验证点: '测一下XX支不支持YY''验一下XX能不能''XX功能对不对''回归XX'。仅'打开/看看/瞄一眼'等无验证点的不触发。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 # wl-test — 测试工作流（/wl-test 命令 或 带功能验证点的自然语言触发）
@@ -32,9 +32,9 @@ trigger: "/wl-test 命令; 或自然语言带具体功能验证点: '测一下XX
 
 **① 必须用意图式格式（intent+anchor），禁止旧 action+selector 格式。**
 ```json
-// ✅ 对: 意图式, anchor 来自 recall
+// ✅ 对: 意图式, anchor 来自 recall 或 snapshot
 {"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员"}}
-// ❌ 错: 旧 action+CSS selector (脆弱, recall 锚点白沉淀)
+// ❌ 错: 旧 action+CSS selector (脆弱, 脆弱, recall 锚点白沉淀)
 {"action":"form_input","target":"input[placeholder*='账号']","value":"{{ask:测试账号}}"}
 ```
 
@@ -46,20 +46,48 @@ trigger: "/wl-test 命令; 或自然语言带具体功能验证点: '测一下XX
 **③ 用例 JSON 必须用 `--cases-file` 传文件，禁止内联 `--cases`。**
 ```bash
 # ✅ 对: 写文件再传路径(不截断)
-python "$R/.qoder/scripts/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/autotest.py" quick --cases '[{"case_id"...(超长)...}]'
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
 ```
 
-**④ 执行前必须 recall 查锚点。有锚点 → 直接填进 anchor，不调 LLM 匹配。**
+**④ 无锚点时必须先 snapshot 拿真实 anchor 再填，禁止预猜 CSS selector。**
 ```bash
-python "$R/.qoder/scripts/autotest.py" recall --url "/auth/login"
+# recall 空时 → 不预猜! 先 navigate + snapshot 拿到真实 a11y 树
+# 再把 snapshot 里看到的 role+name 填进 step.anchor
 ```
-recall 返回的每个锚点，直接用它的 role+name 填进 step.anchor。这步是**省模型调用**的根本。
+- recall 命中 → 直接用 recall 的 anchor（确定性命中，零 LLM）
+- recall 空（首次）→ **navigate + browser_snapshot → 从 a11y 树提取 anchor → 填进用例**
+- **绝不**在没看页面的情况下凭"登录页一般有账号框"去猜 selector
 
-**⑤ 验证码必须用 Playwright MCP 的 `browser_take_screenshot` 截图 → QoderWork 自带视觉识别 → `browser_type` 填入 → 删图。禁止用 Computer 截图（实测反复失败超时）、禁止瞎蒙默认值。**
-- `{{ask:}}` 占位符里**绝不出现验证码**——验证码不存个人文档，执行时实时识别。
-- 截图工具不可用时 → 用 JS 提取 base64 → 存图 → Read 看 → 算答案 → 填入 → **删图**。
+**⑤ URL 必须写成 `{{base_url}}/auth/login`（带斜杠）。**
+- base_url 已去尾斜杠（脚本行为），写 `{{base_url}}auth/login` 会拼成 `https://xxxauth/login` 坏地址。
+- 脚本会检测并告警，但 AI 应一次写对。
+
+**⑥ recall 的 `--url` 必须用相对路径（无前导斜杠），避开 Git-bash/MSYS 路径转换坑。**
+```bash
+# ✅ 对: 相对路径 (MSYS 不转换)
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+# ❌ 错: 前导斜杠会被 Windows Git-bash 转成 /D:/.../Git/auth/login
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
+```
+（脚本已加 normalize 兜底能修这个，但别依赖兜底——直接写相对路径最干净。）
+
+**⑦ Playwright 工具一次性批量加载，snapshot 结果直接用内存 a11y 树，禁止写文件再 Read。**
+```bash
+# ✅ 对: 一个回合里并发加载所有要用的 browser_* 工具描述
+# ✅ 对: browser_snapshot 返回的 a11y 树直接在对话里读, 不落地文件
+# ❌ 错: 用一个加载一个(调用数翻倍); snapshot 写 yml 文件 → 再 Read 读回来(每步2次调用)
+```
+
+**⑧ 验证码识别一气呵成（截图→Read→type→删图），不绕路、不预先纠结。**
+- 登录用例里**不写**验证码 step——点登录后若弹验证码，执行循环自动走 5 步。
+- 固定 5 步连发：`browser_snapshot` 找验证码图 → `browser_take_screenshot` 存图 → Read 看图算 → `browser_type` 填 → 删图。
+- 验证码有时效（1-2分钟），所以**填完立刻点登录**，别在中间插别的操作。
+- 自识别连失 2 次才交人。
+
+**⑨ 用例必须一次生成全部（正向+异常），禁止一条一条生成。**
+- 每生成一条 = 一次模型调用。一次写完 Q-1(正向) + Q-2(异常) + ... 全部。
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
@@ -70,8 +98,8 @@ recall 返回的每个锚点，直接用它的 role+name 填进 step.anchor。
 > R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 > ```
 > `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。
-> **读到 1 次记住，后续所有脚本统一用 `python "$R/.qoder/scripts/xxx.py"`，不要再搜！**
-> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `python "$R/.qoder/scripts/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:` 段 — 环境/域名
@@ -84,7 +112,7 @@ recall 返回的每个锚点，直接用它的 role+name 填进 step.anchor。
 
 **唯一正确做法**——1 条命令查 MySQL sys_menu 真实路由：
 ```bash
-python "$R/.qoder/scripts/search_index.py" --routes 保险
+python "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
 # → 保险管理 -> /veh/vehicle/vehAffair/insurance
 ```
 - 数据来自 MySQL `sys_menu` 表（后台动态菜单，**唯一事实源**）
@@ -93,10 +121,10 @@ python "$R/.qoder/scripts/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），按每个值造边界用例。
    - 取值范围可信 → 用例枚举全覆盖，不漏分支。
 
@@ -131,30 +159,66 @@ coverage_matrix()
 
 **不要任务/PRD。零搜索。** 用意图+锚点格式（A方案），observe-act-extract 执行。
 
-### Step 0：先 recall 查有没有现成锚点（跳过 LLM）
+### 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/autotest.py" recall --url "/auth/login"
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
 ```
 - **有锚点** → 生成用例时直接把 anchor 填进 step（确定性命中，快、零 LLM）
-- **无锚点** → 用意图式生成（首次会调 LLM 匹配，执行后 learn 沉淀，下次就快）
+- **无锚点（首次）** → **先 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**（信息重叠，浪费一轮）。
 
+### Step 0.6：recall 空时，先 snapshot 拿真实锚点（🔴 首次跑关键，禁止预猜 selector）
+
+**recall 返回空 = 第一次测这页。此时绝不能凭"登录页一般有账号框"去猜 CSS selector。**
+正确做法：先用 Playwright 打开页面拿一次 a11y 树，从里面提取真实 anchor：
+
+```bash
+# 1. 批量加载要用的 browser_* 工具描述 (一次并发, 别一个一个加载)
+#    最少: browser_navigate, browser_snapshot, browser_click, browser_type,
+#          browser_take_screenshot, browser_evaluate
+
+# 2. browser_navigate 到 {{base_url}}/auth/login (base_url 从 config 取, 已去尾斜杠)
+# 3. browser_snapshot 一次 → 拿到 a11y 树 (直接读对话里的内容, 不写文件)
+```
+snapshot 返回形如：
+```
+- textbox "尊敬的管理员，请输入您的账号" [ref=e36]
+- textbox "请输入您的密码" [ref=e42]
+- textbox "验证码" [ref=e56]
+- button "login" [ref=e64]: 登录
+```
+**把这里的 role+name 直接填进用例的 anchor**：
+```json
+{"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员，请输入您的账号"}}
+```
+> 这一步把"首次跑要靠 LLM 兜底匹配"变成"确定性命中"，是省调用的根本。
+> 拿到锚点后继续 Step 1。
+
 **🎯 知道页面名/URL 时，AI 先查按钮+接口画像（最精准，1 条命令拿到所有交互点）：**
 ```bash
-python "$R/.qoder/scripts/autotest.py" page --kw 保险        # 按业务名查
-python "$R/.qoder/scripts/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`，内容同此画像——交接场景直接读那份即可，不必重查。
 
-### Step 1：AI 据用户描述 + 图谱信息生成意图式用例 JSON（**一次生成全部用例**）
+### Step 1：AI 据用户描述 + 锚点生成意图式用例 JSON（**一次生成全部用例**）
 **意图+锚点格式**（A方案核心）：用 `intent` 表达"做什么"，用 `anchor` 精确定位（有锚点则确定性命中，无则 LLM 兜底）。
 ```json
 [{"case_id":"Q-1","title":"正确账号密码登录","platform":"web","env":"test",
@@ -181,7 +245,7 @@ python "$R/.qoder/scripts/autotest.py" page --url /veh/insurance  # 按URL查
 # AI 先写文件:
 #   写 workspace/members/{dev}/drafts/_autotest-cases.json
 # 再调:
-python "$R/.qoder/scripts/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>
 ```
@@ -220,32 +284,40 @@ python "$R/.qoder/scripts/autotest.py" quick \
 > ⚠️ **导航是 `browser_navigate`（不是 BrowserNavigate / navigate）**。
 > 调用前对照上面清单，名字写错 = 工具不存在 = 整个测试失败。
 
+**🔴 调用效率（实测:一次登录测试不该超过 12 步调用）：**
+1. **工具批量加载**：进入执行阶段时，在一个回合里并发加载所有要用的 `browser_*` 工具描述（navigate/snapshot/click/type/take_screenshot/evaluate），不要用一个加载一个。
+2. **snapshot 不落地**：`browser_snapshot` 返回的 a11y 树**直接在对话里读**，禁止写 yml 文件再 Read 回来（每步省一次调用）。
+3. **有 anchor 连发不思考**：锚点已确定，`browser_type`/`browser_click` 直接按 role+name 操作，零模型调用。
+
 **对每个 step（用 Playwright MCP 工具，连着发，别每步深度思考）：**
 1. **intent=goto** → `browser_navigate`（1 次）
-2. **首次到新页面** → `browser_snapshot` **1 次**拿 a11y 树
+2. **首次到新页面** → `browser_snapshot` **1 次**拿 a11y 树（直接读，不写文件）
 3. **intent=click/fill**（锚点优先，**确定性匹配不思考**）：
    - **有 anchor** → snapshot 结果里按 `role+name`/`placeholder` 直接匹配 → 拿到元素 → `browser_type`/`browser_click`（**零模型调用，连着发**）
    - **无 anchor** → 用 `desc` 语义匹配（1 次模型调用）
    - 匹配失败 → self-heal：重新 `browser_snapshot` + 重试，最多 2 次
-4. **intent=extract** → 看 URL / read_page 判断（1 次模型调用）
+4. **intent=extract** → 看 URL / 当前页面判断（1 次模型调用）
 5. **intent=ask_human** → 暂停等人
 6. **intent=assert** → 确定性校验（零模型调用）
 
-### Step 3.5：验证码识别一条龙（数学题）
+### Step 3.5：验证码识别一条龙（数学题）— 一气呵成，别绕路
 
 > **🔴 验证码铁律（实测反复踩坑）：**
 > - **禁止用 Computer 截图 / zoom 截验证码**——实测反复失败、超时、浪费 5-6 步。
 > - **禁止填默认值/瞎蒙**（如 000000）。
 > - **唯一正确路径**：JS 提取 base64 → 存图 → Read 看 → 算答案 → 填 → 删图。固定 5 步，不偏离。
+> - **验证码有时效（1-2 分钟），所以填完立刻点登录，中间别插别的操作。**
 
-按这个**固定顺序**一次走完（用 Playwright MCP 工具，约 30 秒）：
-1. **`browser_snapshot`** 看页面元素，找到验证码图片元素
+按这个**固定顺序**一次走完（用 Playwright MCP 工具，约 30 秒，**连发不思考**）：
+1. **`browser_snapshot`**（如果刚才已经 snapshot 过且页面没变，可跳过）看页面元素，找到验证码图片元素
 2. **`browser_take_screenshot`** 截验证码图片 → 存临时文件（稳定，不像 Computer 截图会失败）
 3. **Read 工具看图 → 算出答案**（QoderWork 自带视觉，1 次模型调用，数学题识别率高）
 4. **`browser_type`** 填答案到验证码输入框
-5. **删掉临时图片**（bash `del _captcha.png`）
-> 验证码有时效（1-2 分钟），所以要快。过期了刷新重走一遍。
+5. **立刻 `browser_click` 点登录**（验证码刚填、还没过期，抓住窗口）
+6. **删掉临时图片**（bash `del _captcha.png`）
+> 验证码过期了（提示"验证码已失效"）→ 别纠结，直接刷新重走 1-5 步。
 > 识别完**必须删图**，不留垃圾。
+> 自识别连续失败 2 次或明显是短信/扫码类 → 才交人（见 Step A 铁律⑤）。
 
 ### Step 4：回收结果 + 自学习沉淀（🔴 必须，不做完不出报告）
 
@@ -254,7 +326,7 @@ python "$R/.qoder/scripts/autotest.py" quick \
 
 **执行方式**：把测试结果 + 测试中 `browser_snapshot` 看到的页面元素一起回传：
 ```bash
-python "$R/.qoder/scripts/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":"新增"}]}'
@@ -275,11 +347,11 @@ python "$R/.qoder/scripts/autotest.py" quick \
 ## browser 基于任务的浏览器测试（用户明确给了任务名时）
 
 ```bash
-python "$R/.qoder/scripts/task.py" list                     # 确认任务存在
-python "$R/.qoder/scripts/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/autotest.py" run <task>           # 注入+出执行计划
-python "$R/.qoder/scripts/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` 查影响范围，自动覆盖受影响页面：
@@ -300,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:描述}}` 占位，问用户要。
@@ -307,9 +416,9 @@ JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
   域名才放 config（全团队一致）。账号密码每人不同 → 个人文档。
 - **个人文档**：`workspace/members/{你的名字}/autotest-data.yaml`（gitignored，永不 push）
 ```bash
-python "$R/.qoder/scripts/autotest.py" init-data                          # 生成模板
-python "$R/.qoder/scripts/autotest.py" set-data 登录账号 test --env test   # 填(按环境/平台分块)
-python "$R/.qoder/scripts/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` 可临时覆盖。
 
@@ -319,7 +428,7 @@ run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆
 
 **Step A：查登录态**
 ```bash
-python "$R/.qoder/scripts/autotest.py" login-state show
+python "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
 ```
 
 **Step B：按登录态决定行为**
@@ -340,8 +449,8 @@ python "$R/.qoder/scripts/autotest.py" login-state show
 
 ```bash
 # 手动操作（一般不用，AI 会自动）:
-python "$R/.qoder/scripts/autotest.py" login-state mark --env pre --platform web   # 标记已登录
-python "$R/.qoder/scripts/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）。
+
 ## 非功能性需求
 {性能（响应时间/并发）、安全（权限）、兼容性（浏览器/系统版本）、可用性}