@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/commands/wl-task.md

@@ -21,24 +21,82 @@ User input: $ARGUMENTS
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`（task.py / team_sync.py 等）。
+> 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
+
+---
+
+## 🔌 禅道模式判定（先于路由，决定数据走向）
+
+**禅道为唯一事实源**（已确认架构）。`/wl-task` 的 create/start/finish/reassign 优先走禅道 MCP；
+本地 task.json 降级为离线缓存 + 增强字段层（RICE/依赖甘特这些禅道没有的本地能力全部保留，叠加在禅道任务上）。
+
+### ⚠️ 归属安全（防改错队友任务，必须遵守）
+
+禅道是**每人一个账号**（凭据在 `workspace/members/{我}/.private/secrets/zentao.env`，gitignore），归属靠 member.json 的 `zentao_account` 映射 + 工具默认行为兜底：
+
+- **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。
+- **空账号直接拒绝**：member.json 没配 `zentao_account` 时，"看我的"工具返回 `🚫 未识别禅道身份`（不再静默降级返回全队）。原样转述，引导 `/wl-init`。
+- **改任务前必校验**：start/finish/assign/update 拿到 task_id 后，**先 `get_task(id)` 看 assignedTo**：
+  - `assignedTo == 我` → 正常执行；
+  - `assignedTo == 别人` → **停下来问用户**"这是指派给 X 的任务，确认要改吗？"，**不静默改**。
+- **建任务**：`create_task` 的 `assignedTo` **默认指派给当前开发者**（从 member.json 的 zentao_account），显式传参才派别人。
+- 隔离红线见 `contracts/isolation.md`「禅道同步」。
+
+### 第 0 步：探测禅道可达性
+调用禅道健康检查（QoderWork: `qw_mcp_call("check_zentao_status", {})` / CLI: `cap.mcp.call("check_zentao_status")`）——内网 + 凭据一道探测：
+- **✅ 可达** → 走**禅道模式**（下方各动作的「禅道走法」）
+- **❌ 不可达 / 未配置** → 走**本地模式**（下方各动作的原有 `task.py` 走法，离线兜底，不报错不阻塞）
+- **用户明确说"离线"/"先存本地"** → 即使禅道可达也走本地模式
+
+> 这套判定让禅道有就同步、没内网就静默回退 —— 符合 AGENTS.md「本地数据是唯一事实源、连接器是可选增强、断网不阻塞」原则。
+> 探测本身要 1 次调用。**高频场景（看我的活）可省略探测**：直接 my_workbench，它内部自带内网/凭据门，不通会返回友好提示，不浪费一次往返。
+
+### 列表勾选式交互（禅道模式的统一范式）
+
+禅道所有关联/选择类操作都用这个范式 —— **PM/组长回个数字就完事，零学习成本**：
+
+```
+用户说一句话 → AI 调 list_* 工具搜候选 → 列 5-8 个带编号(附状态/数量)
+→ 用户回编号(支持 1,2 多选) → AI 调 create/link/resolve 执行
+→ 反馈 ✅ + 关联结果 → (可选)追问下一步
+```
+
+**剧本示例（组长拆任务，跨执行多选）：**
+```
+组长: 把 R-231 报价单导出拆成任务
+AI:   匹配到需求 #761 报价单导出 ✅
+      要拆到哪个执行？(最近 5 个):
+      [1] 执行#73 车险v2后端   进行中 · 14任务
+      [2] 执行#75 小程序改版    进行中 · 6任务
+      [3] 执行#71 理赔优化      已完成
+组长> 1,2          ← 支持多选 = 跨执行建任务
+AI:   建议: ①后端导出接口(6h) ②前端按钮(3h) ③测试用例(2h)
+      拆哪几个? (回 1,3 或 "全部")
+组长> 全部
+AI:   ✅ 6 个任务已建(2执行×3任务), 均挂 story=#761
+```
 
 ---
 
 ## ⚠️ STEP 0: 动作路由（看 $ARGUMENTS 第一个词）
 
 **判断 `$ARGUMENTS` 第一个词，立刻决定走哪条线。没有动作词 → 语义自动归档。**
+> ⚠️ 边界：本命令管的是**本地任务工序**（建/查/排/归档）。禅道的**自然查询**（"我的禅道任务""看下#301""Bug状态"）
+> 不走本命令 —— AI 直接用禅道 MCP 工具自然回答（见 AGENTS.md「禅道自然查询」），别把随口问拉进工作流。
+> 禅道的**显式工序**（PRD 发禅道建需求、记工时、改任务状态）走下表 zentao 动作。
 
 | 用户说 / 第一个词 | 动作 | 跑什么 |
 |------------------|------|--------|
 | `create` / "建任务" / "加个任务" | **create** | `task.py create` |
-| `list` / "看任务" / "我的任务" / "有哪些任务" | **list** | `task.py list` |
+| `list` / "看任务" / "有哪些任务" | **list** | `task.py list` |
 | `show` / "看下 XXX" / "XXX 怎么样了" | **show** | `task.py show <name>` |
 | `start` / "开始做" / "启动 XXX" | **start** | `task.py start <name>` |
 | `finish` / "做完了" / "完成了" | **finish** | `task.py finish` |
 | `archive` / "归档" | **archive** | `task.py archive <name>` |
 | `rank` / "排优先级" / "排一下" | **rank** | RICE 评估（见下） |
 | `plan` / "排期" / "甘特图" / "排个日期" | **plan** | `task.py gantt` + set-due |
+| `sync` / "同步到禅道" | **sync** | 本地缓存 → 禅道（见 STEP 2） |
+| `zentao` / "PRD发禅道" / "记工时" / "改任务状态" | **zentao** | 显式禅道工序（见 STEP 2 工序剧本） |
 | **（无动作词）** | **语义自动归档** | 见下 |
 
 ### 语义自动归档（无动作词时，AI 按这句话的意图判断）
@@ -46,7 +104,9 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 - "PRD 写完了，建个任务吧" / "把刚才那个需求建成任务" → **create**（带 PRD 衔接）
 - "现在要做哪些？" / "接下来干啥" → **list --ready**（只看能立刻开始的）
 - "卡住的有哪些？" → **list --blocked**
+- "PRD 发禅道" / "记下今天 3 小时工时" → **zentao**（显式工序）
 - 拿不准意图 → **先 list 给全貌，再问用户要操作哪个**
+- ⚠️ "我的任务" / "看下我的禅道" / "Bug 状态" 这类**纯查询**——不归档进工作流，AI 直接自然回答
 
 ---
 
@@ -54,17 +114,19 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 这三道是"鲁棒"的保障，防止脚本崩在半路、空数据吓到用户。
 
-### 检查 ①｜身份在不在
+> ①②相互独立 → **同一条消息并发探测**（一次回合发两个，别逐个等）；③是执行 task.py 后才看退出码，归 STEP 2。
+
+### 检查 ①｜身份在不在（与②并发）
 ```bash
-python -c "import sys; sys.path.insert(0,r'$R/.qoder/scripts'); from common.paths import get_developer, get_repo_root; d=get_developer(get_repo_root()); print(d or 'MISSING')"
+python -c "import sys; sys.path.insert(0,r'$R/.qoder/scripts'); from foundation.core.paths import get_developer, get_repo_root; d=get_developer(get_repo_root()); print(d or 'MISSING')"
 ```
 - 有名字 → 继续。
 - `MISSING` → **停下，提示**："还没初始化身份，先跑 `/wl-init 你的名字 产品`"。不要继续往下跑（create 会把 assignee 写成空）。
 
-### 检查 ②｜tasks 目录在不在
+### 检查 ②｜tasks 目录在不在（与①并发）
 - 不存在 / 空 → create 直接建；list/show/rank 等读操作 → **友好提示** "还没有任务，要建一个吗？" 而不是报错。
 
-### 检查 ③｜脚本退出码
+### 检查 ③｜脚本退出码（STEP 2 执行 task.py 后看）
 - `task.py` 任何子命令返回**非 0**，**先读 stderr 原样告诉用户**，不吞错。
 - 常见非 0：`4` = 权限不足（零信任 ACL，只有 creator/assignee/admin 能改任务）；`1` = 任务不存在 / task.json 缺失。
 - 权限不足时提示："这个任务不是你建的，找 `{assignee}` 或管理员操作。" 不要自己绕过 ACL。
@@ -80,34 +142,61 @@ python -c "import sys; sys.path.insert(0,r'$R/.qoder/scripts'); from common.path
 如果刚跑完 `/wl-prd-full`（或用户说"把刚才那个需求建成任务"），先确认 PRD 在哪：
 ```bash
 # 找最近的 PRD 草稿（当前开发者的）
-ls workspace/members/<developer>/drafts/REQ-*.md 2>nul
+ls workspace/members/<developer>/drafts/REQ-*.md 2>/dev/null
 # 或已发布的
-ls data/docs/prd/REQ-*.md 2>nul
+ls data/docs/prd/REQ-*.md 2>/dev/null
 ```
 - 有 PRD → 从 PRD 提取**标题、模块、验收点**填进任务，**别让用户重述一遍**。
   PRD 的 REQ-ID 记到 task.json 的 `tags` 里（如 `["REQ-2026-042"]`），方便双向追溯。
 - 无 PRD → 用 $ARGUMENTS 里用户给的一句话当标题。
 
 **B. 建任务**
+
+**禅道走法（禅道可达时优先）：** 需求建在禅道、任务也拆在禅道，本地只缓存一份。
 ```bash
-python "$R/.qoder/scripts/task.py" create "<标题>" --priority <P0|P1|P2|P3>
+# 1. 先确认需求在禅道(从 PRD 发布时已建, 或现在建):
+#    create_story(product_id=<PID>, title=<PRD标题>, spec=<描述>)
+#    ★ 建完需求后, 主动问 PM "要关联到哪个版本?(本周/未来)", 用
+#      list_builds(project_id=<项目ID>) 列候选 → link_story_to_build 关联
+#      (详见下方 story 域「建需求后主动问版本」剧本)
+# 2. 组长拆任务(列表勾选式):
+#    先 list_executions() 列候选执行让用户选 → create_task(execution_id=<EID>,
+#    name=<任务名>, assignedTo=<账号>, type=devel/test/design, estimate=<h>, story=<需求ID>)
+# 3. 同步一份到本地缓存(增强字段层用):
+#    python "$R/.qoder/scripts/domain/task/task.py" create "<标题>" --priority <P0|P1|P2|P3>
+```
+
+**本地走法（禅道不可达 / 用户要离线时）：**
+```bash
+python "$R/.qoder/scripts/domain/task/task.py" create "<标题>" --priority <P0|P1|P2|P3>
 ```
 - `--assignee` 不填则默认当前开发者（产品建的常指派给开发，可加 `--assignee 老李`）。
 - `--slug` 不填则自动从标题生成（中文标题也能生成，但建议给个英文 slug 如 `--slug login-export`）。
 - 同名撞库时脚本会自动加后缀（creator 短标记），**不阻塞**，告诉用户最终名字即可。
+- **禅道恢复后**：用 `sync` 动作把本地缓存推回禅道（见 STEP 2 sync）。
 
 **C. 建完必做**
 1. 告诉用户任务路径：`workspace/tasks/{MM-DD-slug}/`，里面有 `prd.md` 模板（若已有 PRD，可把 PRD 内容贴进去或引用）。
 2. **待排期池 >3 个任务时**，主动建议："要不要我跑个 rank 排下优先级？"
 3. 自动同步（用户永不碰 git）：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+python "$R/.qoder/scripts/domain/task/team_sync.py" push
 ```
 
 ### list —— 看任务（一次取全，别串行）
 
+**禅道走法（QoderWork 第一宿主，丝滑首选）：**
+```
+qw_mcp_call("my_workbench", {})            ← ★一行看全(任务+需求+Bug), 跨执行/产品聚合
+qw_mcp_call("list_my_tasks", {"status":"wait"})  ← 只看我未开始的任务
+qw_mcp_call("list_my_tasks", {"status":"doing"}) ← 只看我进行中的
+```
+> QoderWork 用 `qw_mcp_call(toolName, arguments)` 直接调（工具已起进程，省去 list/get 两步元调用）。
+> **禁逐个 list_execution_tasks**（会漏早期执行里的任务，且每次都要 execution_id）。"我的全部"用 my_workbench/list_my_tasks。
+
+**本地走法（离线缓存 / 禅道不可达）：**
 ```bash
-python "$R/.qoder/scripts/task.py" list [--mine] [--status <s>] [--ready] [--blocked]
+python "$R/.qoder/scripts/domain/task/task.py" list [--mine] [--status <s>] [--ready] [--blocked]
 ```
 
 | flag | 用途 |
@@ -126,44 +215,256 @@ python "$R/.qoder/scripts/task.py" list [--mine] [--status <s>] [--ready] [--blo
 - `--ready` 空 → "当前没有能立刻开始的任务，都在等依赖。要看卡住的吗？（--blocked）"
 
 ### show —— 看单个任务详情
-```bash
-python "$R/.qoder/scripts/task.py" show <任务名或目录>
-```
+
+**禅道走法（QoderWork）：** `qw_mcp_call("get_task", {"task_id": <禅道ID>})` ← 含工时预计/消耗/剩余/关联需求
+**本地走法：** `python "$R/.qoder/scripts/domain/task/task.py" show <任务名或目录>`
+
 任务名支持模糊匹配（脚本内部 `resolve_task_dir` 会解析）。读完把关键字段（状态/优先级/assignee/due/依赖/prd路径）整理给用户。
 
 ### start —— 启动任务（移交开发工位的信号）
-```bash
-python "$R/.qoder/scripts/task.py" start <任务名>
-```
+
+**禅道走法（QoderWork，优先）：** `qw_mcp_call("start_task", {"task_id": <禅道ID>, "left": <剩余工时h>})`
+**本地走法：** `python "$R/.qoder/scripts/domain/task/task.py" start <任务名>`
 - 状态 `planning → in_progress`，成为活跃任务（`.current-task`）。
 - 这是产品→开发的交接点：start 后开发就能 `/wl-code` 了。
 - **ACL**：只有 creator/assignee/admin 能 start。被拒（返回 4）→ 提示找对应人。
+- **禅道+本地双写**：先 qw_mcp_call start_task 同步禅道，再 task.py start 同步本地缓存（双源一致）。
 
 ### reassign —— 改派任务负责人（多角色协作必需）
-```bash
-python "$R/.qoder/scripts/task.py" reassign <任务名> <新负责人>
-```
+
+**禅道走法（QoderWork）：** `qw_mcp_call("assign_task", {"task_id": <禅道ID>, "account": <禅道账号>})`
+  - 账号先用 `qw_mcp_call("list_users", {})` 列候选让用户选（**列表勾选式**）。
+**本地走法：** `python "$R/.qoder/scripts/domain/task/task.py" reassign <任务名> <新负责人>`
 - 场景：PM 建任务（assignee 默认是自己）后，要转给开发老李做。
 - 改派后新负责人才能 `start`/`finish`（零信任 ACL 按 assignee 判定）。
 - **ACL**：只有 **creator/admin** 能改派（assignee 自己不能转手甩锅）。被拒（返回 4）→ 提示找 creator。
-- **改派历史自动记录**到 task.json 的 `assignee_history`（谁在何时从谁转给谁），便于追溯。
 
 ### finish —— 完成当前任务
-```bash
-python "$R/.qoder/scripts/team_sync.py" push
-```
+
+**禅道走法（QoderWork，优先）：** `qw_mcp_call("finish_task", {"task_id": <禅道ID>, "consumed": <本次消耗h>, "left": 0})`
+  - 禅道要求填消耗工时，**先问用户"这次花了多少小时？"** 再调。
+**本地走法：** `python "$R/.qoder/scripts/domain/task/task.py" finish` → 然后 `team_sync.py push`
 - 活跃任务状态 → `completed`，活跃指针清除。
 - 完成后提示：要不要 `archive` 归档？要不要看下个 `--ready` 的任务？
-- 自动同步 push。
 
-### archive —— 归档（移到 .qoder/archive/{YYYY-MM}/）
-```bash
-python "$R/.qoder/scripts/task.py" archive <任务名>
-```
+### archive —— 归档（移到 .qoder/archive/{YYYY-MM}/}）
+
+**本地走法：** `python "$R/.qoder/scripts/domain/task/task.py" archive <任务名>`
 - 事务化：先 move 成功再改 status，move 失败原任务完好。
 - **自动清理孤儿依赖**：归档后，其它任务里对它的 `blocked_by/blocks/children/parent` 引用会被扫除（防止僵尸任务永远 blocked）。
 - 提示用户：归档后任务不再出现在 list 里，但归档目录可翻历史。
 
+### zentao —— 禅道全域（需求/任务/Bug/规划工时，一站式）
+
+禅道是完整的项目管理域（63 工具）。`/wl-task` 是唯一入口，按自然语言判断属于哪个域，直接调对应禅道 MCP 工具。
+
+**先按这句话的意图判断属于哪个域：**
+
+| 用户说的关键词 | 域 | 典型动作 |
+|---------------|-----|---------|
+| 需求/PRD/story/发布/计划/版本 | **需求(story)** | 建需求/看需求/改状态/关联 |
+| 任务/task/拆任务/开始/完成/工时 | **任务(task)** | 建/看/开始/完成/记工时 |
+| Bug/缺陷/问题/bug/解决/激活 | **Bug** | 提bug/看/确认/解决/关闭 |
+| 产品/项目/执行/迭代/发布/计划/工时统计 | **规划+工时** | 建产品/执行/版本, 看工时 |
+
+#### 域路由表（自然语言 → 工具调用，低 AI 调用：每句直达一个工具）
+
+**① 需求(story)域**
+```
+用户说                          → 工具
+"PRD 发禅道"/"建需求"            → create_story(product_id=?, title=<PRD标题>, spec=<描述>)
+                                   (不知道产品先 list_products() 让用户选)
+"看下需求"/"有哪些需求"          → list_stories(product_id=?)
+"看需求#761详情"                 → get_story_detail(story_id=761)
+"需求改状态"(draft→reviewing等)  → change_story_status(story_id=?, status=?)
+"需求关联到计划/版本/执行"       → link_story_to_plan / link_story_to_build / link_story_to_execution
+```
+
+#### 建需求后主动问版本（★ 你们的版本=项目级 build，PM 最高频关联动作）
+
+> 你们的「版本」是**项目级 build**（项目#9 下按周 `V+日期`，如 `V20260625`），不是产品级 plan/release。
+> 一个需求可能**同时进当前版本 + 未来版本**（一次发部分、下次发另一部分），所以**显式让 PM 多选**，不自动关联。
+
+**剧本（建需求/评审通过后，AI 主动列 build 让 PM 勾选）：**
+```
+PM: 需求#761建好了
+AI: 要关联到哪个版本?(最近 6 个 build):
+    [1] #22 V20260625 (本周, 已关联 9 个 bug)
+    [2] #21 V20260618 (上周)
+    [3] #16 V20260604
+    [4] #11 V20260429 (已含 25 个需求)
+    ...
+PM> 1,3        ← 支持多选 = 一个需求进当前版本(本周发)+未来版本
+AI: ✅ 需求#761 已关联 build#22(本周) + #16(未来)
+```
+- 候选用 `list_builds(project_id=<项目ID>)`（项目维度，最直观）或 `list_builds(product_id=<产品ID>)` 取最近 6 个，按时间倒序编号。
+- 关联调 `link_story_to_build(build_id=<选中>, stories=[<需求ID>])`，**逐个 build 调一次**（每个版本独立关联）。
+- **PM 也可主动触发**："把#761 关联到本周版本" → AI 查本周 build 再关联。
+- 不知道项目/产品 ID 时先 `list_projects()` / `list_products()` 让用户勾选。
+
+**② 任务(task)域**（详见前面 create/start/finish 段，这里补查询）
+```
+"看我的任务"/"这周干啥"/"我手头有什么活" → ★my_workbench() 或 list_my_tasks()
+                                            ↑ 跨所有执行全量聚合, 不漏! 别用 list_execution_tasks 逐个查
+"看我未开始的" / "看进行中的"        → list_my_tasks(status='wait') / list_my_tasks(status='doing')
+"看某执行的任务"(已知执行ID)         → list_execution_tasks(execution_id=?)  ← 默认只看我的
+"看全队任务"                         → list_execution_tasks(execution_id=?, all=true)
+"拆需求为任务"/"建任务"              → create_task(execution_id=?, name=?, ...) ← 不填 assignedTo 默认指派给我
+"看任务#301"                         → get_task(task_id=301)  ← 含工时预计/消耗/剩余
+"任务改指派/改工时/改截止"           → update_task(task_id=?, ...) 或 assign_task(task_id=?, account=?)
+"记工时"/"今天干了3小时"             → log_effort(task_id=?, consumed=3, left=?)
+"看任务工时记录"                     → list_effort(task_id=?)
+```
+
+> **🚫 铁律: 问啥查啥, 禁止跨域冒充 (v3.1.5)**
+> 用户问「任务」就查 task 域(my_workbench/list_my_tasks/get_task), 问「需求」查 story 域, 问「Bug」查 bug 域。
+> **查不到必须如实说**「没有指派给你的任务」+ 贴查询证据, **绝不拿需求/Bug 顶替任务来回答**(用户实测踩坑:
+> 问任务却收到需求列表)。归属过滤空账号时工具会拒绝并提示 /wl-init, 把拒绝原样转述, 不绕过。
+
+**③ Bug 域**
+```
+"提个Bug"/"发现个问题"           → create_bug(product_id=?, title=?, openedBuild=?, severity=1-4)
+"看我的Bug"/"我的缺陷"           → ★list_my_bugs()  ← 跨所有产品全量, 不漏! 别逐产品查
+"看某产品的Bug"(已知产品ID)      → list_bugs(product_id=?)  ← 默认只看指派给我的
+"看全队的Bug"                    → list_bugs(product_id=?, all=true)
+"看Bug#101"                      → get_bug(bug_id=101)
+"Bug解决了"/"修好了"             → resolve_bug(bug_id=?, resolution='fixed', resolvedBuild=?)
+"确认Bug"/"认领Bug"              → confirm_bug(bug_id=?)
+"Bug没改好,重开"                 → activate_bug(bug_id=?)
+"关闭Bug"                        → close_bug(bug_id=?)
+```
+
+**④ 规划+工时域**
+```
+"有哪些产品/项目/执行"           → list_products() / list_projects() / list_executions()
+"建产品/项目/执行/版本/计划"     → create_product / create_project / create_execution / create_build / create_plan
+"看执行#73"                      → get_execution(execution_id=73)
+"需求/Bug 关联计划/版本"         → link_story_to_plan / link_bug_to_plan / link_*_to_build
+```
+
+#### 通用规则（所有禅道操作）
+- **不知道 ID 时**：先调 list_* 让用户勾选（列表勾选式，别让用户背 ID）。
+- **写操作默认归属校验**：工具层已强制——改任务/Bug 前自动校验 assignedTo==我，不是我的会拒绝并提示归属人。
+- **建任务/Bug 不填 assignedTo**：默认指派给当前开发者自己（防共享账号误派）。
+- **禅道不可达**：提示"内网未连，看本地缓存用 `/wl-task list`"，不报错。
+- **🚫 跨域不冒充**：问任务查任务、问需求查需求。查不到如实说"没有"+贴证据，绝不拿别的域顶替。
+
+#### 🔌 宿主路由：禅道怎么调（显式工序操作用）
+
+> 仅适用于本文件的**显式工序操作**（建需求/建任务/改状态/记工时）。
+> 自然查询（"我的任务""看下 #301"）不走本表 —— AI 直接用禅道 MCP 工具自然回答，不拉入 /wl-task。
+
+| 宿主 | 调用入口 |
+|------|---------|
+| **QoderWork** | `qw_mcp_call("工具名", {参数})`（复用已起的 zentao 进程；工具名确定时直接 call，省 qw_mcp_list/get 两步） |
+| **Qoder IDE / Quest** | `mcp__qoder-zentao__工具名(参数)` |
+| **CLI / 其他** | `cap.mcp.call("工具名", {参数})` |
+
+#### 🎯 工序操作剧本（显式建/改，非查询）
+
+> 下面是 /wl-task 的**工序动作**（建需求/建任务/改状态/记工时），需要流程保障。
+> 查询类（看我的活、看进度）见 AGENTS.md「禅道自然查询」，直接用 MCP 工具回答，不在这里。
+
+**① 发需求到禅道（PM 产出动作 · 完整工序，别发完就停）**
+```
+触发: "PRD 发禅道"/"建需求"/"发布到禅道"/"把这个需求发上去"
+
+★这是 PM 最重要的产出动作, 必须走完整工序(7步), 发完一句"✅已创建"就停 = 失败。
+
+AI 步骤:
+1. 读 PRD: 把本地 PRD.md 全文读出来 (背景/目标/功能详细/验收标准), 别只取标题
+2. 确认产品: 不知道就 qw_mcp_call("list_products", {}) 勾选 (你们活跃: #1 ICS2.0/#12 车辆作业/#13 车辆异常)
+3. ★建需求(spec 必填全文, 不是一句摘要):
+   qw_mcp_call("create_story", {
+     "product_id": <选>,
+     "title": <PRD标题>,
+     "spec": <★PRD全文: 背景+目标+功能详细说明+验收标准, 用 markdown>,
+     "pri": <1-4, 默认3>,
+     "category": "feature"
+   })
+   → 拿到 story_id
+
+4. ★提评审 (不跳过! draft 不评审等于没发):
+   告诉用户: "需求 #X 已建(draft), 建议提交评审让相关人过目"
+   qw_mcp_call("change_story_status", {"story_id": <X>, "status": "reviewing"})
+   → 状态 draft→reviewing, 评审人会收到通知
+
+5. ★关联计划 (你们版本=项目级 plan, 不关联计划的需求等于孤儿):
+   qw_mcp_call("list_plans", {"product_id": <选>}) 取最近计划 → 列给用户:
+   [1] #15 2026年6月迭代  [2] #14 2026年7月迭代
+   用户选 → qw_mcp_call("link_story_to_plan", {"plan_id": <选>, "stories": [<story_id>]})
+
+6. 关联版本 (build, 可选, 发布管理用):
+   qw_mcp_call("list_builds", {"project_id": 9}) 取最近 build → 问用户要不要关联
+   要 → qw_mcp_call("link_story_to_build", {"build_id": <选>, "stories": [<story_id>]})
+
+7. ★原型图 (有则处理, 无则跳过):
+   有本地原型文件 → qw_mcp_call("upload_file", {"file_path":"<原型路径>","object_type":"story","object_id":<X>})
+   - 上传成功: 告诉用户附件已挂
+   - 上传失败(禅道REST限制): 给降级方案(手动上传/截图嵌入), 并保留本地预览路径
+   无原型: 跳过此步
+
+8. ★富反馈 (告诉用户做了什么, 不是一句"✅"):
+   汇总输出:
+   ┌──────────────────────────────────┐
+   │ ✅ 需求已发布到禅道             │
+   │ 标题: <PRD标题>                 │
+   │ ID: #<X>  地址: <URL>/story-view-<X>.html │
+   │ 产品: <选的产品>                │
+   │ 状态: reviewing(已提评审)       │
+   │ 关联: 计划 #<P> 版本 #<B>(若有) │
+   │ 原型: 已上传/降级(见上)         │
+   │ spec: 已填全文(<N>字)           │
+   └──────────────────────────────────┘
+   → 追问: "评审过了要我关联到执行让研发拆任务吗? (list_executions 勾选)"
+```
+⚠️ 铁律: spec 必须是 PRD 全文(背景/目标/功能/验收), 不是一句话摘要。发完"✅已创建"就停、
+   不提评审不关联计划 = 半成品发布, 用户感受不到价值(实测踩坑)。
+
+
+**② 拆任务/改状态/记工时（组长·研发工序）**
+```
+触发: "拆任务"/"把需求拆成任务"/"开始做#301"/"完成了"/"今天干了3小时"
+AI:  拆任务(列表勾选式, 跨执行多选):
+     1. qw_mcp_call("list_executions", {}) 列候选执行 → 用户选 [1,2]
+     2. AI 建议任务拆分模板(基于需求): "建议: ①后端接口(6h) ②前端(3h) ③测试(2h), 拆哪几个?"
+     3. 用户回"全部" → qw_mcp_call("create_task", {"execution_id":<eid>,"name":<名>,"assignedTo":<我>,"type":"devel","estimate":6,"story":<sid>}) 逐个建, ✅ 汇总
+     改状态(QoderWork 用 qw_mcp_call):
+     "开始做#301" → qw_mcp_call("start_task", {"task_id":301,"left":6}) → ✅ + 追问"要同步本地 task.py start 吗?"
+     "完成了"     → 先问"花了多少小时?" → qw_mcp_call("finish_task", {"task_id":301,"consumed":X,"left":0})
+     "记工时"     → qw_mcp_call("log_effort", {"task_id":301,"consumed":3,"left":<剩余>})
+```
+
+---
+
+### sync —— 本地缓存同步回禅道（离线恢复后用）
+
+> v3.1.3 起有**独立脚本** `zentao_sync.py`，安全优先（不拉错/不覆盖队友）。
+> **隔离红线**见 `contracts/isolation.md`「禅道同步」。
+
+离线时本地建的任务，禅道恢复后用脚本推上去。**默认 dry-run 预览，确认无误再加 `--apply`：**
+
+```bash
+# 看同步状态（只读：本地哪些任务关联了禅道，哪些待推）
+python "$R/.qoder/scripts/domain/task/zentao_sync.py" status
+
+# 推送本地任务到禅道（先 dry-run 预览）
+python "$R/.qoder/scripts/domain/task/zentao_sync.py" push --execution_id <执行ID>      # 预览
+python "$R/.qoder/scripts/domain/task/zentao_sync.py" push --execution_id <执行ID> --apply  # 真推
+
+# 拉取禅道任务到本地（仅 assignedTo=我，队友的拉不进来）
+python "$R/.qoder/scripts/domain/task/zentao_sync.py" pull <执行ID> --apply
+```
+
+**安全保证（脚本强制，不靠 AI 自觉）：**
+- **幂等**：本地已有 `zentao_id` 的任务跳过（不重复建）。
+- **归属硬过滤**：拉取只取 `assignedTo == 我的禅道账号`；推送只推 `creator == 我` 的本地任务。
+- **防误改队友**：推送时若禅道同名任务的 `assignedTo` ≠ 我 → **拒绝更新**。
+- **归属映射**：本地 developer → 禅道 account 靠 `member.json` 的 `zentao_account` 字段，没配则拒绝同步（宁可不同步也不猜）。
+- **禅道不可达**：提示"内网未连，看本地缓存用 `/wl-task list`"，退出码 5 不报错。
+
+> 提示：首次用前确认 `member.json` 配了 `zentao_account`（如 hupan56→hupan），见 `contracts/isolation.md`。
+
 ---
 
 ## STEP 3: RICE 排序（rank 动作 —— 产品的优先级决策）
@@ -172,7 +473,7 @@ python "$R/.qoder/scripts/task.py" archive <任务名>
 
 ### 一次取全（别逐个问）
 ```bash
-python "$R/.qoder/scripts/task.py" list --status planning
+python "$R/.qoder/scripts/domain/task/task.py" list --status planning
 ```
 拿到所有待排任务，**一次性**评估，不要一个任务问四轮 R/I/C/E。
 
@@ -203,23 +504,23 @@ python "$R/.qoder/scripts/task.py" list --status planning
 
 ### 设置截止日期
 ```bash
-python "$R/.qoder/scripts/task.py" set-due <任务名> <YYYY-MM-DD>
+python "$R/.qoder/scripts/orchestration/wlkj.py" task set-due <任务名> <YYYY-MM-DD>
 ```
 
 ### 依赖关系（谁挡谁）
 ```bash
 # A 被 B 阻塞（要等 B 完成）
-python "$R/.qoder/scripts/task.py" block <A任务名> <B任务名>
+python "$R/.qoder/scripts/orchestration/wlkj.py" task block <A任务名> <B任务名>
 # 解除
-python "$R/.qoder/scripts/task.py" unblock <A任务名> <B任务名>
+python "$R/.qoder/scripts/orchestration/wlkj.py" task unblock <A任务名> <B任务名>
 ```
 - **循环依赖自动检测**：脚本会 BFS 检查，发现环就拒绝（返回 1）。
 - 反向 `blocks` 关系自动维护（A 被 B 阻塞时，B 的 blocks 自动加 A）。
 
 ### 看甘特图
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
-python "$R/.qoder/scripts/task.py" gantt [--weeks 4]
+python "$R/.qoder/scripts/domain/task/team_sync.py" push
+python "$R/.qoder/scripts/orchestration/wlkj.py" task gantt [--weeks 4]
 ```
 - 只排有 `start_date`/`due_date` 的任务。
 - 没日期的任务 → 提示："用 `set-due` 给任务加截止日期，甘特图才会显示。"
@@ -231,8 +532,8 @@ python "$R/.qoder/scripts/task.py" gantt [--weeks 4]
 
 ```bash
 # 把大任务 A 拆出子任务 B
-python "$R/.qoder/scripts/task.py" add-subtask <A任务名> <B任务名>
-python "$R/.qoder/scripts/task.py" remove-subtask <A任务名> <B任务名>
+python "$R/.qoder/scripts/orchestration/wlkj.py" task add-subtask <A任务名> <B任务名>
+python "$R/.qoder/scripts/orchestration/wlkj.py" task remove-subtask <A任务名> <B任务名>
 ```
 - 父任务记录 `children`，子任务记录 `parent`。
 - 产品用：把一个大需求拆成"前端/后端/数据"几个子任务，各自指派。
@@ -287,16 +588,18 @@ prd ──create(带REQ-ID)──→ task ──start──→ code/test ──f
 
 ```
 /wl-task                       ← list 给全貌（语义：看任务）
-/wl-task create <标题>          ← 建任务（最高频）
+/wl-task create <标题>          ← 建任务（最高频）禅道可达时同步建禅道
 /wl-task list --ready          ← 看能立刻做的
 /wl-task list --blocked        ← 看卡住的
 /wl-task show <名>             ← 看详情
-/wl-task start <名>            ← 启动（移交开发）
+/wl-task start <名>            ← 启动（移交开发）禅道可达时同步 start_task
 /wl-task reassign <名> <开发>   ← 改派任务负责人（PM 建完转给开发，多角色协作）
-/wl-task finish                ← 完成
+/wl-task finish                ← 完成（禅道可达时同步 finish_task + 记工时）
 /wl-task archive <名>          ← 归档
 /wl-task rank                  ← RICE 排优先级
 /wl-task plan                  ← 甘特图/排期/依赖
+/wl-task zentao                ← 查禅道侧任务/需求（禅道模式专属）
+/wl-task sync                  ← 本地缓存 → 禅道（离线恢复后用）
 ```
 
 > 完整执行规则见 `.qoder/skills/wl-task/SKILL.md`（Quest/QoderWork 自然语言入口）。

package/templates/qoder/commands/wl-test.md

@@ -18,7 +18,7 @@ User input: $ARGUMENTS
 ```bash
 R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+> 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 
 ## 🚦 第一步：路由（看用户输入，立刻决定走哪条线）
 
@@ -39,29 +39,55 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 +该页面的通用交互模式生成用例。平台/环境 AI 推断（web 默认、test 默认），
 **只在真不确定平台时才问一句**。不要问地址、不要问登录方式——这些 config/文档里都有。
 
-### 流程（3 步，不绕弯）
+### 🔴 quick 执行铁律（实测踩过的坑，违反 = 测试失败）
 
-**Step 1：AI 据用户描述生成用例 JSON。** 不搜代码。常见页面直接写：
-- 登录页：goto /auth/login → 填账号密码 → 点登录 → 断言跳转
+- **① 用意图式 intent+anchor 格式，禁止旧 action+CSS selector**（如 `input[placeholder*='账号']`）
+- **② 占位符精确用 `{{ask:登录账号}}`/`{{ask:登录密码}}`**（匹配个人文档 key，别写"测试账号"）
+- **③ `--cases-file` 传文件，禁止内联 `--cases`**（长 JSON 截断）
+- **④ recall 空时先 navigate+snapshot 拿真实 anchor 再填，禁止预猜 selector**
+- **⑤ URL 写 `{{base_url}}/auth/login`（带斜杠，base_url 已去尾斜杠）**
+- **⑥ recall 的 `--url` 用相对路径 `auth/login`**（前导斜杠会被 Windows Git-bash 转成 `/D:/.../Git/auth/login`）
+- **⑦ Playwright 工具批量加载，snapshot 结果直接读，不写文件再 Read**
+- **⑧ 验证码一气呵成（snapshot→截图→Read→type→点登录→删图），填完立刻提交**
+- **⑨ 用例一次生成全部（正向+异常），别一条一条**
+
+### 流程（4 步，不绕弯）
+
+**Step 0：recall 查锚点（用相对 URL）。**
+```bash
+python "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+```
+- 有锚点 → 直接填进用例 anchor（零 LLM）
+- 无锚点（首次）→ **先 navigate + snapshot 拿真实 a11y 树，从里面提取 anchor**，禁止预猜 selector
+
+**Step 1：AI 据用户描述 + 锚点生成用例 JSON。** 不搜代码。常见页面直接写：
+- 登录页：goto `{{base_url}}/auth/login` → 填账号密码 → 点登录 → 断言跳转
 - 列表页：goto 列表 → 断言表格加载 → 翻页/筛选
 - 表单页：goto → 填字段 → 提交 → 断言成功提示
-需要真实数据(账号/密码)用 `{{ask:描述}}` 占位，URL 用 `{{base_url}}`。
-正向 + 关键异常各一条。
+需要真实数据(账号/密码)用 `{{ask:描述}}` 占位，URL 用 `{{base_url}}/xxx`（**带斜杠**）。
+正向 + 关键异常各一条。**一次生成全部用例。**
+```json
+// ✅ 意图式格式 (anchor 来自 recall 或 snapshot)
+{"intent":"fill","desc":"账号框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员"}}
+// ❌ 禁止: 旧 action+CSS selector
+{"action":"fill","target":"input[placeholder*='账号']","value":"{{ask:测试账号}}"}
+```
 
 **Step 2：调脚本，注入数据 + 出执行计划：**
 ```bash
-python "$R/.qoder/scripts/autotest.py" quick \
-  --cases '<Step1生成的JSON>' \
+# AI 先把用例 JSON 写文件, 再传路径 (--cases-file, 不截断)
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
+  --cases-file <文件路径> \
   --desc "<用户描述>" --platform <web|app>
 ```
 脚本自动：解析 test 环境域名 + 从个人文档注入账号密码 + 出执行计划。
 若提示"需要测试数据" → 逐项问用户，再用 `--data` 传。
 
-**Step 3：执行由 QoderWork 浏览器连接器承担（真实场景）。**
-脚本只出计划，不自己开浏览器。无连接器 → 降级人工核对清单。
+**Step 3：执行由 Playwright MCP 驱动（真实场景）。**
+脚本只出计划，不自己开浏览器。批量加载 browser_* 工具后按执行计划连发操作。
 跑完回传结果出报告：
 ```bash
-python "$R/.qoder/scripts/autotest.py" quick --record '{"Q-1":"pass","Q-2":"fail"}'
+python "$R/.qoder/scripts/orchestration/wlkj.py" test quick --record '{"Q-1":"pass","Q-2":"fail"}'
 ```
 
 ---
@@ -71,11 +97,11 @@ python "$R/.qoder/scripts/autotest.py" quick --record '{"Q-1":"pass","Q-2":"fail
 用户明确给了任务名/回归某个任务时走这条。完整流程见 skill。
 
 ```bash
-python "$R/.qoder/scripts/task.py" list                     # 确认任务
-python "$R/.qoder/scripts/autotest.py" generate <task>      # 生成骨架
+cap.mcp.call("list_tasks", {})                     # 确认任务
+python "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架
 # 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"}'  # 回收结果
 ```
 
 ---
@@ -84,9 +110,9 @@ python "$R/.qoder/scripts/autotest.py" run <task> --record '{"..":"pass"}'  #
 
 用户说"测试覆盖""哪些没测""回归盲区"时走这条。
 
-**PREFERRED: MCP 工具（最快）：**
+**调用方式：**
 ```
-mcp__coverage_matrix()
+cap.mcp.call("coverage_matrix", {})
 ```
 
 **FALLBACK: 直接看索引：**