@hupan56/wlkj 2.4.5 → 2.4.7

package/bin/cli.js

@@ -278,6 +278,17 @@ function doUpdate() {
 
   console.log(`\nwlkj update${oldVer ? " " + oldVer : ""} -> v${PKG_VERSION}\n`);
 
+  // P1-15: 显式声明 update 绝不触碰的路径
+  console.log("  受保护路径 (绝不覆盖):");
+  console.log("    .qoder/config.yaml          (团队 git 配置)");
+  console.log("    .qoder/settings.json         (权限/hook 配置)");
+  console.log("    .qoder/.developer            (你的身份)");
+  console.log("    .qoder/.current-task         (当前任务)");
+  console.log("    .qoder/.engine-version       (版本戳)");
+  console.log("    workspace/                   (你的全部产出)");
+  console.log("    data/                        (代码仓库+知识图谱)");
+  console.log("");
+
   // === 1. 刷新引擎文件（保护 config.yaml / settings.json）===
   let copied = 0, protectedN = 0, skipped = 0;
   if (fs.existsSync(qoderSrc)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "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,54 @@ 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 <需求>`（默认）或 `/wl-prd reference <需求>` | **Reference** 参考模式 | 参考现有代码+历史PRD，出标准PRD+原型 | ✅ | ✅ |
+| `/wl-prd brainstorm <需求>` 或 "头脑风暴" | **Brainstorm** 头脑风暴 | SCAMPER+多agent调研，产出创新方案→PRD+原型 | ✅ | ✅ |
+| `/wl-prd plan <需求>` 或 "规划" | **Planning** 规划模式 | 现状分析+理想态+Gap+MVP路线图→PRD+原型 | ✅ | ✅ |
+| `/wl-prd quick <需求>` 或 "快速""加个字段" | **Quick** 快速模式 | 快速定位+Mini-PRD+微型原型（只改diff） | ✅ | ✅ |
+
+### 模式路由规则（程序级优先）
+
+1. **显式参数优先**：用户输 `/wl-prd quick XX` → 强制 Quick 模式，不推断
+2. **关键词推断**：用户自然语言带"探讨/聊聊/快速/头脑风暴/规划" → 匹配对应模式
+3. **默认**：不带关键词 → Reference（参考模式）
+4. **兜底**：≥2 模式都沾边 → **先问用户**，不要猜
 
 ### 什么时候用哪个模式？
 
-- **不知道怎么做** → 探讨模式（先聊清楚再决定要不要出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))