@hupan56/wlkj 2.4.6 → 2.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "2.4.6",
+  "version": "2.4.8",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

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

@@ -37,21 +37,57 @@ WAIT for the answer. Platform determines everything downstream:
 
 | 用户怎么说 | 模式 | 做什么 | 出 PRD？ | 出原型？ |
 |-----------|------|--------|---------|---------|
-| 直接说需求（默认） | **Reference** 参考模式 | 参考现有代码+历史PRD，出标准PRD+原型 | ✅ | ✅ |
-| "探讨""聊聊""分析一下""我想做个XX不知道怎么做" | **Discuss** 探讨模式 | 纯讨论：理需求、拆问题、给方案建议，**不出PRD不出原型** | ❌ | ❌ |
-| "头脑风暴""brainstorm" | **Brainstorm** 头脑风暴 | SCAMPER+多agent调研，产出创新方案→PRD+原型 | ✅ | ✅ |
-| "规划""plan" | **Planning** 规划模式 | 现状分析+理想态+Gap+MVP路线图→PRD+原型 | ✅ | ✅ |
-| "快速""quick""加个字段""小改动" | **Quick** 快速模式 | 快速定位+Mini-PRD+微型原型（只改diff） | ✅ | ✅ |
+| `/wl-prd discuss <需求>` 或 "探讨""聊聊""分析一下" | **Discuss** 探讨模式 | 纯讨论：理需求、拆问题、给方案建议，不出文件 | ❌ | ❌ |
+| `/wl-prd <需求>`（默认） | **Reference** 参考模式 | 参考现有代码+历史PRD，出标准PRD+原型 | ✅ | ✅ |
+| `/wl-prd quick <需求>` 或 "快速""加个字段""小改动" | **Quick** 快速模式 | 快速定位+Mini-PRD+微型原型（只改diff），跳过EVA | ✅ | ✅ |
+
+> **精简为 3 个模式**（原 Brainstorm/Planning 已合并进 Reference）：
+> - 需要**创新/头脑风暴**？Reference 模式里先说"帮我从不同角度分析"，AI 会做 SCAMPER
+> - 需要**规划/Gap 分析**？Reference 模式里先说"先分析现状和差距"，AI 会做 Gap 分析
+> - 这两种场景都是"先分析再生成 PRD"，不需要单独模式
+
+### 模式路由规则
+
+1. **显式参数优先**：`/wl-prd quick XX` 或 `/wl-prd discuss XX`
+2. **关键词推断**：自然语言带"探讨/快速" → 匹配
+3. **默认**：不带关键词 → Reference
+4. **兜底**：不确定 → 先问用户
 
 ### 什么时候用哪个模式？
 
-- **不知道怎么做** → 探讨模式（先聊清楚再决定要不要出PRD）
-- **照着已有的做类似的** → 参考模式（默认）
+- **不知道怎么做** → 探讨（先聊清楚再决定要不要出PRD）
+- **照着已有的做类似的** → 参考（默认）
 - **想创新/没思路** → 头脑风暴
-- **大方向/季度规划** → 规划模式
-- **小功能/Bug fix** → 快速模式
+- **大方向/季度规划** → 规划
+- **小功能/Bug fix** → 快速
+
+### Discuss 转 Reference 的标记（审计用）
+
+Discuss 结束、用户说"出PRD"时，AI 必须输出：
+```
+[MODE-SWITCH: discuss→reference]
+```
+然后按 Reference 模式流程生成。
 
-> 探讨模式结束后，用户可以说"按这个方向出PRD"→ 自动转参考模式生成。
+### Quick 模式的特殊处理
+
+Quick 模式生成的 PRD **头部必须标注 `mode: quick`**：
+```markdown
+<!-- mode: quick -->
+# Mini-PRD: {标题}
+```
+syncgate 的 EVA 门禁检查到 `mode: quick` 时**跳过 A3（字段引用检查）**，
+因为 Mini-PRD 格式精简，A3 的表格字段检查不适用。
+其他检查（平台/REQ-ID/秘密）仍然生效。
+
+### Brainstorm 中间文件清理
+
+Brainstorm 模式可能生成 `brainstorm-agent-*.md` 中间调研文件。
+生成最终 PRD 后**必须删除这些中间文件**：
+```bash
+rm -f workspace/members/*/drafts/brainstorm-agent-*.md
+```
+team_sync 的 staging allowlist 也会拒绝 `brainstorm-agent-*` 文件名。
 
 The agent files define the detailed workflow for each mode. When
 dispatching a sub-agent, ALWAYS include in the dispatch prompt:

package/templates/qoder/hooks/inject-workflow-state.py

@@ -97,6 +97,20 @@ GUIDE = {
 
 def main():
     tp, st = get_status()
+    # Hook-2: 如果任务/状态没变, 输出空 (减少 token 消耗)
+    # 用 .runtime/.last-workflow-state 存上次输出, mtime 变了才重新注入
+    state_file = os.path.join(BASE, '.qoder', '.runtime', '.last-wf-state.txt')
+    current_sig = '{}|{}'.format(tp or '', st or '')
+    try:
+        os.makedirs(os.path.dirname(state_file), exist_ok=True)
+        if os.path.isfile(state_file):
+            last_sig = open(state_file, 'r', encoding='utf-8').read().strip()
+            if last_sig == current_sig:
+                return  # 状态没变, 不重复注入 (省 token)
+        open(state_file, 'w', encoding='utf-8').write(current_sig)
+    except OSError:
+        pass
+
     g = GUIDE.get(st, 'Status "{}" - check task.json, expected planning/in_progress/completed.'.format(st))
     parts = []
     parts.append('<qoder-workflow>')

package/templates/qoder/hooks/session-start.py

@@ -76,6 +76,20 @@ def get_team_size():
 
 def get_index_info():
     lines = []
+    # Hook-3: 检查 hook 错误日志, 超过 3 条新错误时告警
+    try:
+        log_path = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
+        if os.path.isfile(log_path):
+            with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                errors = [l for l in f.readlines() if l.strip()]
+            # 只看最近 24h 的错误
+            recent = errors[-10:]  # 取最后 10 行检查
+            if len(recent) >= 3:
+                lines.append('[WARN] hook 最近频繁失败 (%d 条错误), 详情见 .qoder/.runtime/hook-errors.log' % len(recent))
+                lines.append('  跑 python .qoder/scripts/init_doctor.py --fix 排查')
+    except OSError:
+        pass
+
     lines.append('## Knowledge Index')
     lines.append('Use search script (DO NOT read large JSON files directly):')
     lines.append('  python .qoder/scripts/search_index.py <keyword> [--platform web|app]')
@@ -191,6 +205,9 @@ def main():
         parts.append(style_info)
 
     parts.append('</qoder-context>')
+    # Hook-1: 健康标记 — AI 能感知 hook 是否真的跑了
+    # QoderWork/Quest 里看不到 [hook-ok] 就知道 hook 没生效, 要自取上下文
+    parts.append('<!-- [hook-ok] session-start hook ran successfully -->')
     print(NL.join(parts))
 
 

package/templates/qoder/scripts/syncgate.py

@@ -275,6 +275,15 @@ def check_eval_gate(
         full = os.path.join(repo_root, prd) if not os.path.isabs(prd) else prd
         if not os.path.isfile(full):
             continue
+        # PRD-3: Quick 模式 PRD 跳过 A3 (字段引用检查)
+        # Mini-PRD 格式精简, A3 的表格字段检查不适用
+        try:
+            with open(full, 'r', encoding='utf-8', errors='replace') as f:
+                head = f.read(2048)
+            if 'mode: quick' in head.lower():
+                continue  # Quick 模式, 跳过 EVA
+        except OSError:
+            pass
         # 找同名原型 (可选)
         dirname = os.path.dirname(full)
         base = os.path.splitext(os.path.basename(full))[0]

package/templates/qoder/scripts/team_sync.py

@@ -270,7 +270,11 @@ def _stage_scopes_safely(skip_secret=False):
             fpath = line[3:]
             if status[0] == '?' or status[1] == '?':  # 未跟踪
                 ext = os.path.splitext(fpath)[1].lower()
-                if ext in SAFE_EXTENSIONS:
+                # PRD-4: 拒绝 brainstorm 中间文件
+                basename = os.path.basename(fpath)
+                if 'brainstorm-agent' in basename:
+                    skipped.append(fpath + ' (brainstorm 中间文件, 不提交)')
+                elif ext in SAFE_EXTENSIONS:
                     git('add', '--', fpath)
                     staged += 1
                 else:

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

@@ -38,18 +38,17 @@ trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-
 - `.qoder/.current-task` — 当前活动任务
 - `data/index/.index-meta.json` — 知识图谱新鲜度（过期提示先 `/wl-init`，不阻塞）
 
-## 五种模式（看用户怎么说自动选）
+## 三种模式（精简版）
 
 | 用户怎么说 | 模式 | 出PRD？ | 出原型？ |
 |-----------|------|---------|---------|
 | 直接说需求（默认） | Reference 参考 | ✅ | ✅ |
 | "探讨""聊聊""分析一下""不知道怎么做" | **Discuss 探讨** | ❌ | ❌ |
-| "头脑风暴""brainstorm" | Brainstorm 头脑风暴 | ✅ | ✅ |
-| "规划""plan" | Planning 规划 | ✅ | ✅ |
-| "快速""quick""加个字段" | Quick 快速 | ✅ | ✅ |
+| "快速""quick""加个字段""小改动" | Quick 快速 | ✅ | ✅ |
 
-> **探讨模式**：纯讨论，理需求、拆问题、给方向建议。不出文件。
-> 讨论完用户说"出PRD"→ 自动转参考模式。
+> **只有 3 个模式**。需要头脑风暴？Reference 里说"从不同角度分析"。
+> 需要规划？Reference 里说"先分析现状和差距"。都是"先分析再生成"，不需要单独模式。
+> **探讨模式**：纯讨论，不出文件。聊完用户说"出PRD"→ 自动转参考模式。
 
 ## 完整流程（Reference/Brainstorm/Planning/Quick 模式）