@hupan56/wlkj 2.3.3 → 2.3.5

package/package.json

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

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

@@ -35,12 +35,23 @@ WAIT for the answer. Platform determines everything downstream:
 
 ## Mode Detection
 
-| Keyword in input | Mode | Sub-agent (.qoder/agents/) |
-|------------------|------|---------------------------|
-| (none, DEFAULT) | Reference | prd-reference.md |
-| "头脑风暴" / "brainstorm" | Brainstorm | prd-research.md (N parallel) |
-| "规划" / "plan" | Planning | prd-planning.md |
-| "快速" / "quick" | Quick | prd-quick.md |
+| 用户怎么说 | 模式 | 做什么 | 出 PRD？ | 出原型？ |
+|-----------|------|--------|---------|---------|
+| 直接说需求（默认） | **Reference** 参考模式 | 参考现有代码+历史PRD，出标准PRD+原型 | ✅ | ✅ |
+| "探讨""聊聊""分析一下""我想做个XX不知道怎么做" | **Discuss** 探讨模式 | 纯讨论：理需求、拆问题、给方案建议，**不出PRD不出原型** | ❌ | ❌ |
+| "头脑风暴""brainstorm" | **Brainstorm** 头脑风暴 | SCAMPER+多agent调研，产出创新方案→PRD+原型 | ✅ | ✅ |
+| "规划""plan" | **Planning** 规划模式 | 现状分析+理想态+Gap+MVP路线图→PRD+原型 | ✅ | ✅ |
+| "快速""quick""加个字段""小改动" | **Quick** 快速模式 | 快速定位+Mini-PRD+微型原型（只改diff） | ✅ | ✅ |
+
+### 什么时候用哪个模式？
+
+- **不知道怎么做** → 探讨模式（先聊清楚再决定要不要出PRD）
+- **照着已有的做类似的** → 参考模式（默认）
+- **想创新/没思路** → 头脑风暴
+- **大方向/季度规划** → 规划模式
+- **小功能/Bug fix** → 快速模式
+
+> 探讨模式结束后，用户可以说"按这个方向出PRD"→ 自动转参考模式生成。
 
 The agent files define the detailed workflow for each mode. When
 dispatching a sub-agent, ALWAYS include in the dispatch prompt:
@@ -65,6 +76,31 @@ Never reuse an existing number. push 时 team_sync 会校验 REQ-ID 唯一性。
 
 ---
 
+## Discuss Mode (探讨模式 — 纯讨论，不出 PRD/原型)
+
+> 触发：用户说"探讨""聊聊""分析一下""我想做个XX但不知道怎么做"
+> 或需求很模糊，需要先理清思路时。
+
+### 做什么
+1. **听需求**：让用户把想法说完，不要急着出方案
+2. **问关键问题**（一次问完，不要一条一条问）：
+   - 要解决什么问题？（业务痛点）
+   - 谁用？（角色/场景）
+   - 现在怎么做的？（现状）
+   - 期望怎样？（目标）
+3. **给方向建议**：基于现有代码（跑 context_pack 了解现状）给出 2-3 个可行方向
+4. **不生成 PRD、不生成原型、不分配 REQ-ID**
+5. 讨论结束后问："要按这个方向出 PRD 吗？" → 用户说是 → 转 Reference 模式
+
+### 不做什么
+- ❌ 不写 PRD 文件
+- ❌ 不画原型
+- ❌ 不分配 REQ-ID
+- ❌ 不跑 EVA 评估
+- ❌ 不 push
+
+---
+
 ## Reference Mode (DEFAULT)
 
 ### Step 1: Get ALL Context in ONE Call (fast path)

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

@@ -38,10 +38,22 @@ trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-
 - `.qoder/.current-task` — 当前活动任务
 - `data/index/.index-meta.json` — 知识图谱新鲜度（过期提示先 `/wl-init`，不阻塞）
 
-## 完整流程
+## 五种模式（看用户怎么说自动选）
 
-按 `.qoder/commands/wl-prd.md` 执行（含 Reference/Brainstorm/Planning/Quick
-四种模式）。核心步骤：
+| 用户怎么说 | 模式 | 出PRD？ | 出原型？ |
+|-----------|------|---------|---------|
+| 直接说需求（默认） | Reference 参考 | ✅ | ✅ |
+| "探讨""聊聊""分析一下""不知道怎么做" | **Discuss 探讨** | ❌ | ❌ |
+| "头脑风暴""brainstorm" | Brainstorm 头脑风暴 | ✅ | ✅ |
+| "规划""plan" | Planning 规划 | ✅ | ✅ |
+| "快速""quick""加个字段" | Quick 快速 | ✅ | ✅ |
+
+> **探讨模式**：纯讨论，理需求、拆问题、给方向建议。不出文件。
+> 讨论完用户说"出PRD"→ 自动转参考模式。
+
+## 完整流程（Reference/Brainstorm/Planning/Quick 模式）
+
+按 `.qoder/commands/wl-prd.md` 执行。核心步骤：
 
 1. **一次取全上下文**（fast path）：
    ```bash

package/templates/cli.js

@@ -1,198 +0,0 @@
-#!/usr/bin/env node
-// wlkj - workflow toolkit
-// 参考 Trellis 架构：用户看到的极简，背后 scripts/hooks 精确控制
-
-const path = require("path");
-const fs = require("fs");
-const { execSync } = require("child_process");
-
-const T = path.join(__dirname, "..", "templates");
-
-// --- helpers ---
-function py(script, args = []) {
-  const p = path.join(process.cwd(), ".qoder", "scripts", script);
-  if (!fs.existsSync(p)) {
-    console.log("请先运行: npx wlkj init");
-    process.exit(1);
-  }
-  try {
-    return execSync(
-      `python "${p}" ${args.map(a => `"${a}"`).join(" ")}`,
-      { cwd: process.cwd(), encoding: "utf-8", timeout: 15000 }
-    );
-  } catch (e) {
-    return (e.stdout || e.message);
-  }
-}
-
-function cp(src, dest) {
-  const s = path.join(T, src);
-  const d = path.join(process.cwd(), dest);
-  if (!fs.existsSync(s)) return;
-  fs.mkdirSync(path.dirname(d), { recursive: true });
-  if (!fs.existsSync(d)) { fs.copyFileSync(s, d); return true; }
-  return false;
-}
-
-function cpDir(src, dest) {
-  const s = path.join(T, src);
-  const d = path.join(process.cwd(), dest);
-  if (!fs.existsSync(s)) return;
-  fs.mkdirSync(d, { recursive: true });
-  const items = fs.readdirSync(s);
-  items.forEach(item => {
-    const srcPath = path.join(s, item);
-    const destPath = path.join(d, item);
-    if (fs.statSync(srcPath).isDirectory()) {
-      cpDir(path.join(src, item), path.join(dest, item));
-    } else if (!fs.existsSync(destPath)) {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  });
-}
-
-// --- init ---
-function doInit(name) {
-  const cwd = process.cwd();
-  console.log(``);
-  console.log(`wlkj init -> ${cwd}`);
-
-  // 目录结构
-  const dirs = [
-    ".qoder/rules", ".qoder/context", ".qoder/scripts/common",
-    ".qoder/scripts/hooks", ".qoder/skills/prd-generator",
-    ".qoder/skills/spec-generator", ".qoder/skills/spec-coder",
-    ".qoder/skills/test-generator", ".qoder/agents", ".qoder/hooks",
-    ".qoder/tasks", ".qoder/archive", ".qoder/workspace",
-    ".qoder/.runtime/sessions",
-    ".codex/hooks", ".codex/agents",
-    "docs/ai/prd", "docs/ai/specs", "src", "tests"
-  ];
-  dirs.forEach(d => fs.mkdirSync(path.join(cwd, d), { recursive: true }));
-
-  // 模板文件（flat list，一目了然）
-  let copied = 0;
-  const files = [
-    // .qoder 核心
-    ["qoder/config.yaml",        ".qoder/config.yaml"],
-    ["qoder/workflow.md",        ".qoder/workflow.md"],
-    // rules
-    ["rules/code-style.md",      ".qoder/rules/code-style.md"],
-    ["rules/prd-template.md",    ".qoder/rules/prd-template.md"],
-    ["rules/spec-template.md",   ".qoder/rules/spec-template.md"],
-    ["rules/testing.md",         ".qoder/rules/testing.md"],
-    // context
-    ["context/architecture.md",  ".qoder/context/architecture.md"],
-    ["context/data-dictionary.md",".qoder/context/data-dictionary.md"],
-    // skills
-    ["skills/prd-generator/SKILL.md",   ".qoder/skills/prd-generator/SKILL.md"],
-    ["skills/spec-generator/SKILL.md",  ".qoder/skills/spec-generator/SKILL.md"],
-    ["skills/spec-coder/SKILL.md",      ".qoder/skills/spec-coder/SKILL.md"],
-    ["skills/test-generator/SKILL.md",  ".qoder/skills/test-generator/SKILL.md"],
-    // agents
-    ["agents/qoder-spec-gen.toml", ".qoder/agents/qoder-spec-gen.toml"],
-    ["agents/qoder-coder.toml",    ".qoder/agents/qoder-coder.toml"],
-    ["agents/qoder-test-gen.toml", ".qoder/agents/qoder-test-gen.toml"],
-    // hooks
-    ["hooks/post-prd-push.py",    ".qoder/hooks/post-prd-push.py"],
-    // scripts
-    ["scripts/init_developer.py", ".qoder/scripts/init_developer.py"],
-    ["scripts/task.py",           ".qoder/scripts/task.py"],
-    ["scripts/add_session.py",    ".qoder/scripts/add_session.py"],
-    ["scripts/common/__init__.py",   ".qoder/scripts/common/__init__.py"],
-    ["scripts/common/paths.py",      ".qoder/scripts/common/paths.py"],
-    ["scripts/common/developer.py",  ".qoder/scripts/common/developer.py"],
-    ["scripts/common/active_task.py",".qoder/scripts/common/active_task.py"],
-    ["scripts/common/task_utils.py", ".qoder/scripts/common/task_utils.py"],
-    // codex hooks
-    ["codex/config.toml",                    ".codex/config.toml"],
-    ["codex/hooks.json",                     ".codex/hooks.json"],
-    ["codex/hooks/inject-pipeline-state.py", ".codex/hooks/inject-pipeline-state.py"],
-    ["codex/agents/qoder-spec-gen.toml",     ".codex/agents/qoder-spec-gen.toml"],
-    ["codex/agents/qoder-coder.toml",        ".codex/agents/qoder-coder.toml"],
-    ["codex/agents/qoder-test-gen.toml",     ".codex/agents/qoder-test-gen.toml"],
-    // root
-    ["root/AGENTS.md",            "AGENTS.md"],
-  ];
-
-  files.forEach(([s, d]) => { if (cp(s, d)) copied++; });
-  console.log(`  copied ${copied} files`);
-
-  // git init
-  if (!fs.existsSync(path.join(cwd, ".git"))) {
-    try {
-      execSync("git init", { cwd, stdio: "pipe" });
-      console.log("  git init done");
-    } catch (_) {}
-  }
-
-  // developer
-  if (name) {
-    console.log("");
-    process.stdout.write(py("init_developer.py", [name]));
-  } else {
-    console.log("");
-    console.log("  next: npx wlkj init <your-name>");
-  }
-  console.log("");
-}
-
-// --- status ---
-function doStatus() {
-  console.log("");
-  // developer
-  const dev = path.join(process.cwd(), ".qoder", ".developer");
-  if (fs.existsSync(dev)) {
-    const line = fs.readFileSync(dev, "utf-8").split("\n")[0];
-    console.log("dev: " + line.split("=")[1]?.trim());
-  } else {
-    console.log("dev: -");
-  }
-  // task
-  process.stdout.write(py("task.py", ["current", "--source"]));
-  // docs
-  const count = (d) => {
-    const p = path.join(process.cwd(), d);
-    return fs.existsSync(p) ? fs.readdirSync(p).filter(f => f.endsWith(".md")).length : 0;
-  };
-  console.log(`prd: ${count("docs/ai/prd")}  spec: ${count("docs/ai/specs")}`);
-  console.log("");
-}
-
-// --- main ---
-const [,, cmd, ...rest] = process.argv;
-
-switch (cmd) {
-  case "init":
-    doInit(rest[0]);
-    break;
-  case "task":
-    // 映射 -p 到 --priority（CLI 便捷）
-    const mapped = rest.map(a => a === "-p" ? "--priority" : a);
-    process.stdout.write(py("task.py", mapped));
-    break;
-  case "status":
-    doStatus();
-    break;
-  case "session":
-    process.stdout.write(py("add_session.py", rest));
-    break;
-  default:
-    console.log("");
-    console.log("wlkj - workflow toolkit");
-    console.log("");
-    console.log("  npx wlkj init [name]     init workflow + developer");
-    console.log("  npx wlkj status          show status");
-    console.log("  npx wlkj task <cmd>      task management");
-    console.log("  npx wlkj session <args>  record session log");
-    console.log("");
-    console.log("task commands:");
-    console.log('  create "Title" [-p P0|P1|P2|P3] [--assignee who]');
-    console.log("  list [--mine] [--status planning|in_progress]");
-    console.log("  start <name>");
-    console.log("  finish");
-    console.log("  current");
-    console.log("  archive <name>");
-    console.log("  add-subtask <parent> <child>");
-    console.log("");
-}

package/templates/qoder/scripts/code_index.py

@@ -1,41 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-DEPRECATED: code_index.py used to keep its own (cruder) index builder
-whose schema conflicted with git_sync.py's - running it would overwrite
-the real indexes. It now delegates to the single implementation.
-
-Usage:
-  python code_index.py scan          # full index rebuild (= git_sync.py --index-only)
-  python code_index.py search <kw>   # use search_index.py instead
-"""
-
-import os
-import sys
-
-# UTF-8 stdio (防御性: stdout 被捕获时不崩溃)
-try:
-    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
-except (AttributeError, TypeError, OSError, IOError):
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except Exception:
-        pass
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-
-if __name__ == '__main__':
-    cmd = sys.argv[1] if len(sys.argv) > 1 else ''
-    if cmd == 'scan':
-        from git_sync import build_full_indexes, FAILURES
-        build_full_indexes()
-        sys.exit(1 if FAILURES else 0)
-    elif cmd == 'search' and len(sys.argv) > 2:
-        import subprocess
-        script = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'search_index.py')
-        sys.exit(subprocess.call([sys.executable, script] + sys.argv[2:]))
-    else:
-        print('Usage:')
-        print('  python code_index.py scan          # full index rebuild')
-        print('  python code_index.py search <kw>   # -> search_index.py')
-        sys.exit(1)

package/templates/qoder/scripts/notify.py

@@ -1,5 +0,0 @@
-# notify.py - Simple console notification
-class Notifier:
-    def notify(self, event, title, content):
-        sep = '=' * 50
-        print(chr(10).join(['', sep, 'NOTIFY: ' + title, sep, content, sep]))

package/templates/qoder/scripts/team.py

@@ -1,29 +0,0 @@
-# team.py - Team member registration
-import os, json, sys
-NL = chr(10)
-BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-def add_member(name, role):
-    members_dir = os.path.join(BASE, 'workspace', 'members')
-    member_dir = os.path.join(members_dir, name)
-    os.makedirs(os.path.join(member_dir, 'journal'), exist_ok=True)
-    os.makedirs(os.path.join(member_dir, 'drafts'), exist_ok=True)
-    os.makedirs(os.path.join(member_dir, 'inbox'), exist_ok=True)
-    info = {'name': name, 'role': role}
-    with open(os.path.join(member_dir, 'member.json'), 'w') as f:
-        json.dump(info, f, indent=2)
-    print('OK: member ' + name + ' (' + role + ') added')
-
-def list_members():
-    md = os.path.join(BASE, 'workspace', 'members')
-    if not os.path.isdir(md): print('No members'); return
-    for d in sorted(os.listdir(md)):
-        info_f = os.path.join(md, d, 'member.json')
-        if os.path.isfile(info_f):
-            info = json.load(open(info_f))
-            print(d + ' [' + info.get('role', '?') + ']')
-
-if __name__ == '__main__':
-    if len(sys.argv) < 2: list_members()
-    elif sys.argv[1] == 'add' and len(sys.argv) >= 4: add_member(sys.argv[2], sys.argv[3])
-    else: list_members()