@hupan56/wlkj 3.1.31 → 3.2.0

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

@@ -15,6 +15,13 @@ User input: $ARGUMENTS
 
 ## 🚦 路由（看第一个词或描述特征）
 
+### 🔴 命令优先铁律（最重要，先读）
+**只要用户打了 `/wl-prd`，就必须产出 PRD，绝不跨命令跑去别处。**
+哪怕描述含"报错/无法提交/bug/异常"这类词（如"养护计划无法提交，时间报错"——这是要为修复写需求），也走本命令出 PRD，**不准**跑去 `/wl-test`（测试）/ `/wl-code`（直接改码）/ 排查。
+- 用户要写需求 → 本命令（不管描述像 bug 还是新功能）
+- 用户要直接改代码 → 那是 `/wl-code`，但前提是用户打的是 `/wl-code`
+- 判断不准 → 问一句，不要擅自换命令
+
 | 用户说 | 模式 | 走哪个 |
 |--------|------|--------|
 | "完整""深度""正经需求" 或 描述含"新模块/新业务/新流程" | **完整** | prd-full-template（13 章）|
@@ -29,28 +36,37 @@ User input: $ARGUMENTS
 
 ---
 
+## 🔧 仓库根定位（完整档/快速档共用，进任何模式前先跑这一条）
+
+> QoderWork 桌面端 cwd 不在仓库根（在 `.qoderwork/workspace/xxx`），相对路径
+> `.qoder/scripts/...` **必然失败**（真实踩坑：连续 2 条命令报错浪费一轮）。
+> 进模式前**必须先定位仓库根**。Mac 只有 python3，两个都试：
+
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+```
+> 后续所有 `$PY "$R/.qoder/scripts/..."` 都用这两个变量。**不准自己编 `cd /d` / 裸相对路径**。
+
+---
+
 ## 完整模式（13 章 PRD）
 
 **新模块/新业务/新流程用这个。** 支持衔接 insight：`参考:<报告路径>`
 
 **铁律：平台必问。** 先问：
-``
+```
 这个需求是针对哪个平台？
 1. Web 管理端 (fywl-ui)
 2. APP 移动端 (Carmg-H5)
 3. 两端都要
 请选择 (1/2/3):
-``
+```
 
 ### 取上下文（1 次调用取全 8 段）
-先定位仓库根（Mac 只有 python3, 两个都试）:
-``bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
-``
-``bash
+```bash
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <web|app>
-``
+```
 - 第 4 段 = 历史 PRD（防重复）
 - 第 5 段 = 相关 API
 - 第 8 段 = 数据库表结构+真实字段
@@ -63,7 +79,7 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <we
 
 ### 原型要不要画？（融入批量确认）
 
-**默认建议**（用户可一键改，详见 `.qoder/skills/wl-prd-full/SKILL.md` STEP 0.5）：
+**默认建议**（用户可一键改）：
 - 纯规则/接口/定时/参数/计算类 → **不画**（如"出交车点检固定为总部全局规则"）
 - 含页面/菜单/表单/弹窗/详情/向导/看板/大屏 → **画**
 - 加字段/按钮/文案/导出 → **不画**
@@ -75,9 +91,9 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <we
 eval 自动跳过 A2（满分从 100 降到 70，照样 PASS）；`/wl-design` `/wl-code` 据此跳过原型环节。
 
 ### 质量门禁
-``bash
+```bash
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
-``
+```
 ≥ 80% 才 PASS。完整模板见 `.qoder/templates/prd-full-template.md`。
 
 ---
@@ -88,9 +104,18 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
 
 **平台必问**（同上）。
 
+### 取上下文（1 次 prefetch，禁止串行 search）
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" prefetch "<需求描述>" --platform <p>
+```
+prefetch 一次返回代码/字段/API/Wiki/历史 PRD。**之后不要逐个 search/find/grep 查词**（会变 6+ 次串行往返，轮次爆炸根因）。不够才补调一次。
+
 ### 产出
 - Mini-PRD: `workspace/members/{dev}/drafts/REQ-{YYYY}-{NNN}-{标题}.md`（6 章）
-- 6 章：功能入口 / 需求背景 / 需求说明 / 影响范围 / 验收标准 / 不在本次范围
+- **6 章缺一不可（铁律）**：功能入口 / 需求背景 / 需求说明 / 影响范围 / 验收标准 / 不在本次范围
+  > 🚫 **禁止只写 1-2 章就交差**（真实反面教材：海外考勤 PRD 只写了"功能入口"一段就停，6 章缺 5 章 → 残废品）。
+  > 即使是 bug 修复，也要写全 6 章（需求背景=bug 现象、需求说明=修复方案、验收标准=修复后行为）。
+  > 不涉及的章节写"不涉及"或一句话说明，**标题必须保留，不许整章省略**。Stop hook 会检测缺章并阻断。
 - 模板见 `.qoder/templates/prd-quick-template.md`
 
 ---
@@ -115,3 +140,52 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
 ## 埋点
 
 PRD 生成/评审后自动记录到 learning（eval_prd.py 已内置）。
+
+**评审模式额外**：给出 PASS/FAIL 结论后立即记一条 `review_done`（可用性指标 F2 评审级数据唯一来源，不埋则该级永远为 0）：
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"prd\": \"<被评审PRD名>\", \"verdict\": \"PASS|FAIL\"}"
+```
+埋点失败不阻塞，但能埋一定要埋。
+
+---
+
+## 📤 发禅道（PRD 写完后的衔接，完整/快速档都问）
+
+PRD 产出后，**主动问一句**（不要默默结束）：
+```
+PRD 已写好: <路径>
+要发到禅道吗？(发禅道 = 建禅道需求 + 可选关联计划/版本)
+```
+
+### 用户说"发" → 交互式逐项确认（不要一次性全问，按需）
+
+用禅道 MCP 现查现选（QoderWork: `qw_mcp_call`）：
+
+**① 选产品（必选）**
+- `list_products()` → 列出现有产品 → 让用户选 product_id
+- 禅道需求必须挂产品，没产品发不了
+
+**② 关联计划？（可选，问一句）**
+```
+要关联到计划(迭代)吗？(可跳过)
+```
+- 用户要 → `list_plans(product_id=<上一步选的>)` → 选 plan_id
+- 跳过 → 不传 plan
+
+**③ 挂版本？（可选，问一句）**
+```
+要纳入某个版本(build)吗？(可跳过)
+```
+- 用户要 → `list_builds(project_id=N)` → 选 build_id（⚠️ builds 按项目维度查最常见，禅道无"全量版本"端点）
+- 跳过 → 不传 build
+
+**④ 执行发布**
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" req <REQ-ID> 发布 \
+    --product=<①> [--plan=<②>] [--build=<③>] --confirm
+```
+- 默认先 dry-run 预览，用户确认后再 `--confirm` 真发
+- 真发后禅道建好需求，PRD 末尾自动回写 `<!-- zentao: story=ID -->` 留痕
+
+> 用户说"不发" → 不勉强，PRD 留本地，后续可随时 `/wl-req <REQ-ID> 发布`。
+> 直连禅道 HTTP（脚本内部），AI 只触发一次，几乎不耗 token。

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

@@ -14,7 +14,7 @@ argument-hint: "[REQ-ID] [发布]"
 |------|--------|
 | `/wl-req` | 列出所有需求 (跨草稿/产出/历史桶) |
 | `/wl-req REQ-2026-001` | 显示该需求的全部产出 |
-| `/wl-req REQ-2026-001 发布` | 草稿→产出→发禅道 (一步到位) |
+| `/wl-req REQ-2026-001 发布` | 草稿→产出→**真发禅道**(建需求+关联计划+纳入版本) |
 
 ## 实现层
 
@@ -29,10 +29,17 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" req
 # 看某需求全貌
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001
 
-# 发布 (promote + publish)
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001 发布
+# 发布 (promote + publish)。默认 dry-run 只预览, --confirm 才真写禅道
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001 发布 --product=1
+# 真发(建需求→关联计划→纳入版本, 一步到位)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" req REQ-2026-001 发布 --product=1 --plan=12 --build=8 --confirm
 ```
 
+> **产品/计划/版本从哪来**: 命令行 `--product/--plan/--build` 优先; 或在 PRD 顶部标
+> `<!-- zentao: product=1 plan=12 build=8 -->` 自动读取。缺产品ID会停(禅道需求必须挂产品)。
+> 发布后 PRD 末尾自动回写 `<!-- zentao: story=762 -->` 留痕, 防重复建。
+> 直连禅道 HTTP(不走MCP), AI 只触发一次 → 几乎不耗 token。
+
 ## 结构
 
 ```