@hupan56/wlkj 2.0.1 → 2.2.0

package/bin/cli.js

@@ -172,10 +172,12 @@ function doHelp() {
   console.log("");
   console.log("wlkj - AI 产品研发工作流 (v2.0)");
   console.log("");
-  console.log("=== 一键安装 (新项目第一步) ===");
-  console.log("  npx wlkj init [你的名字]    安装完整引擎 + 自动初始化");
-  console.log("    例: npx wlkj init 小王");
-  console.log("    例: npx wlkj init          (从 git 探测名字)");
+  console.log("=== 环境安装 (什么都没装时先跑这个) ===");
+  console.log("  npx @hupan56/wlkj install-env       检测+自动装 Node/Python/git");
+  console.log("  npx @hupan56/wlkj install-env --check  只检测不装");
+  console.log("");
+  console.log("=== 一键安装 (装好环境后) ===");
+  console.log("  npx @hupan56/wlkj init [你的名字]    安装完整引擎 + 自动初始化");
   console.log("");
   console.log("=== 安装后怎么用 ===");
   console.log("  在 Qoder (IDE/Quest/QoderWork) 里:");
@@ -197,11 +199,93 @@ function doHelp() {
   console.log("");
 }
 
+function doInstallEnv(checkOnly = false) {
+  const { execSync } = require("child_process");
+  console.log("\n=== 环境检测 ===\n");
+
+  // 检测函数
+  function check(cmd) {
+    try { return execSync(`${cmd} --version`, { encoding: "utf-8", timeout: 5000, stdio: "pipe" }).trim().split("\n")[0]; }
+    catch { return null; }
+  }
+  function has(cmd) {
+    try { execSync(`where ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; }
+    catch { try { execSync(`which ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; } catch { return false; } }
+  }
+  function install(name, wingetId, brewPkg) {
+    if (checkOnly) return false;
+    const isWin = process.platform === "win32";
+    const isMac = process.platform === "darwin";
+    try {
+      if (isWin && has("winget")) {
+        console.log(`  用 winget 装 ${name}...`);
+        execSync(`winget install --id ${wingetId} -e --source winget --accept-source-agreements --accept-package-agreements`,
+          { stdio: "inherit", timeout: 300000 });
+        return true;
+      } else if (isMac && has("brew")) {
+        console.log(`  用 brew 装 ${name}...`);
+        execSync(`brew install ${brewPkg}`, { stdio: "inherit", timeout: 300000 });
+        return true;
+      } else if (!isWin && !isMac) {
+        // Linux: 尝试 apt/dnf/yum
+        for (const [mgr, pkg] of [["apt", brewPkg], ["dnf", brewPkg]]) {
+          if (has(mgr)) {
+            console.log(`  用 ${mgr} 装 ${name}...`);
+            execSync(`sudo ${mgr} install -y ${pkg}`, { stdio: "inherit", timeout: 300000 });
+            return true;
+          }
+        }
+      }
+    } catch (e) { console.log(`  自动安装失败: ${(e.message || "").slice(0, 80)}`); }
+    return false;
+  }
+
+  const nodeVer = check("node");
+  const pyVer = check("python") || check("python3");
+  const gitVer = check("git");
+
+  console.log(`  Node.js: ${nodeVer ? "[OK] " + nodeVer : "[缺失] (npx 命令需要)"}`);
+  console.log(`  Python:  ${pyVer ? "[OK] " + pyVer : "[缺失] (引擎需要)"}`);
+  console.log(`  git:     ${gitVer ? "[OK] " + gitVer : "[缺失] (可选, 核心功能不依赖)"}`);
+
+  if (checkOnly) {
+    console.log("\n仅检测。去掉 --check 自动安装。");
+    return;
+  }
+
+  const need = [];
+  if (!nodeVer) {
+    console.log("");
+    if (nodeVer || install("Node.js", "OpenJS.NodeJS.LTS", "node")) { console.log(`  [OK] Node.js 已装`); }
+    else { need.push("Node.js (手动: https://nodejs.org)"); }
+  }
+  if (!pyVer) {
+    console.log("");
+    if (install("Python", "Python.Python.3.12", "python@3.12")) { console.log(`  [OK] Python 已装`); }
+    else { need.push("Python (手动: https://python.org, 勾 Add to PATH)"); }
+  }
+  if (!gitVer) {
+    console.log("");
+    if (install("git", "Git.Git", "git")) { console.log(`  [OK] git 已装`); }
+    else { need.push("git (手动: https://git-scm.com, 可选)"); }
+  }
+
+  console.log("\n=== 结果 ===");
+  if (need.length === 0) {
+    console.log("  环境就绪! 下一步: npx @hupan56/wlkj init");
+    console.log("  (新装的可能需要重新打开终端)");
+  } else {
+    console.log("  以下需手动安装:");
+    need.forEach(n => console.log("    - " + n));
+  }
+}
+
 const [,, cmd, ...rest] = process.argv;
 const mapped = rest.map(a => a === "-p" ? "--priority" : a);
 
 switch (cmd) {
   case "init": doInit(rest[0]); break;
+  case "install-env": doInstallEnv(rest[0] === "--check"); break;
   case "task": process.stdout.write(py("task.py", mapped)); break;
   case "status": doStatus(); break;
   case "session": process.stdout.write(py("add_session.py", rest)); break;

package/bin/install-env.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+install-env.py - 一键安装前置环境 (Node.js + Python + git)
+
+在跑 npx @hupan56/wlkj init 之前, 如果什么都没装, 先跑这个。
+它会检测并自动安装缺失的环境。
+
+Usage:
+    python install-env.py          # 检测 + 自动装缺失的
+    python install-env.py --check  # 只检测, 不装
+
+注意: 这个脚本本身需要 Python 才能跑。如果用户连 Python 都没有:
+    Windows: 去 python.org 下载安装 (勾 Add to PATH), 或用 winget:
+             winget install Python.Python.3.12
+    Mac:     brew install python
+"""
+
+import argparse
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError):
+    pass
+
+IS_WIN = sys.platform == 'win32'
+IS_MAC = sys.platform == 'darwin'
+
+
+def run(cmd, **kw):
+    kw.setdefault('capture_output', True)
+    kw.setdefault('text', True)
+    kw.setdefault('encoding', 'utf-8')
+    kw.setdefault('errors', 'replace')
+    try:
+        return subprocess.run(cmd, **kw)
+    except FileNotFoundError:
+        import types
+        return types.SimpleNamespace(returncode=127, stdout='', stderr='not found')
+
+
+def check(cmd_name, version_flag='--version'):
+    """检查某个命令是否存在, 返回 (是否可用, 版本字符串)。"""
+    r = run([cmd_name, version_flag])
+    if r.returncode == 0:
+        return True, r.stdout.strip().split('\n')[0]
+    return False, None
+
+
+def ask(prompt, default='y'):
+    if not sys.stdin.isatty():
+        return default.lower() in ('y', 'yes')
+    try:
+        ans = input(f'{prompt} [{default}] ').strip().lower() or default
+        return ans in ('y', 'yes')
+    except (EOFError, KeyboardInterrupt):
+        return default.lower() in ('y', 'yes')
+
+
+def has_winget():
+    return check('winget')[0]
+
+def has_brew():
+    return check('brew')[0]
+
+def has_choco():
+    return check('choco')[0]
+
+
+# ============================================================
+# 安装器
+# ============================================================
+
+def install_node():
+    """安装 Node.js。"""
+    print('\n--- 安装 Node.js ---')
+    if IS_WIN:
+        # 优先 winget
+        if has_winget():
+            print('  用 winget 安装 Node.js LTS...')
+            r = run(['winget', 'install', '--id', 'OpenJS.NodeJS.LTS', '-e',
+                     '--source', 'winget', '--accept-source-agreements',
+                     '--accept-package-agreements'])
+            if r.returncode == 0:
+                print('  [OK] Node.js 安装成功 (可能需要新终端生效)')
+                return True
+            print('  winget 失败: ' + (r.stderr or '').strip()[:100])
+        # 回退 choco
+        if has_choco():
+            print('  用 choco 安装...')
+            r = run(['choco', 'install', 'nodejs-lts', '-y'])
+            if r.returncode == 0:
+                return True
+        print('  自动安装失败。手动下载: https://nodejs.org (选 LTS)')
+        return False
+    elif IS_MAC:
+        if has_brew():
+            print('  用 brew 安装 Node.js...')
+            r = run(['brew', 'install', 'node'])
+            return r.returncode == 0
+        print('  请先装 Homebrew: https://brew.sh')
+        return False
+    else:
+        # Linux
+        for mgr, cmd in [('apt', ['sudo', 'apt-get', 'install', '-y', 'nodejs', 'npm']),
+                         ('dnf', ['sudo', 'dnf', 'install', '-y', 'nodejs', 'npm']),
+                         ('yum', ['sudo', 'yum', 'install', '-y', 'nodejs', 'npm'])]:
+            if check(mgr)[0]:
+                print(f'  用 {mgr} 安装...')
+                r = run(cmd)
+                return r.returncode == 0
+        print('  请手动安装: https://nodejs.org')
+        return False
+
+
+def install_python():
+    """安装 Python 3.9+。"""
+    print('\n--- 安装 Python ---')
+    if IS_WIN:
+        if has_winget():
+            print('  用 winget 安装 Python 3.12...')
+            r = run(['winget', 'install', '--id', 'Python.Python.3.12', '-e',
+                     '--source', 'winget', '--accept-source-agreements',
+                     '--accept-package-agreements'])
+            if r.returncode == 0:
+                print('  [OK] Python 安装成功 (可能需要新终端生效)')
+                return True
+            print('  winget 失败: ' + (r.stderr or '').strip()[:100])
+        print('  自动安装失败。手动下载: https://python.org (勾 Add to PATH)')
+        return False
+    elif IS_MAC:
+        if has_brew():
+            print('  用 brew 安装 Python...')
+            r = run(['brew', 'install', 'python@3.12'])
+            return r.returncode == 0
+        print('  请先装 Homebrew: https://brew.sh')
+        return False
+    else:
+        for mgr, cmd in [('apt', ['sudo', 'apt-get', 'install', '-y', 'python3', 'python3-pip']),
+                         ('dnf', ['sudo', 'dnf', 'install', '-y', 'python3']),
+                         ('yum', ['sudo', 'yum', 'install', '-y', 'python3'])]:
+            if check(mgr)[0]:
+                print(f'  用 {mgr} 安装...')
+                r = run(cmd)
+                return r.returncode == 0
+        print('  请手动安装: https://python.org')
+        return False
+
+
+def install_git():
+    """安装 git。"""
+    print('\n--- 安装 git ---')
+    if IS_WIN:
+        if has_winget():
+            print('  用 winget 安装 Git...')
+            r = run(['winget', 'install', '--id', 'Git.Git', '-e',
+                     '--source', 'winget', '--accept-source-agreements',
+                     '--accept-package-agreements'])
+            if r.returncode == 0:
+                print('  [OK] git 安装成功 (可能需要新终端生效)')
+                return True
+        print('  自动安装失败。手动下载: https://git-scm.com/download/win')
+        return False
+    elif IS_MAC:
+        # Mac 上 git 通常自带 (装了 Xcode Command Line Tools)
+        r = run(['xcode-select', '--install'])
+        print('  通过 Xcode Command Line Tools 安装...')
+        return True
+    else:
+        for mgr, cmd in [('apt', ['sudo', 'apt-get', 'install', '-y', 'git']),
+                         ('dnf', ['sudo', 'dnf', 'install', '-y', 'git']),
+                         ('yum', ['sudo', 'yum', 'install', '-y', 'git'])]:
+            if check(mgr)[0]:
+                print(f'  用 {mgr} 安装...')
+                r = run(cmd)
+                return r.returncode == 0
+        print('  请手动安装: https://git-scm.com')
+        return False
+
+
+# ============================================================
+# 主逻辑
+# ============================================================
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='一键安装前置环境 (Node.js + Python + git)',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''安装完后跑:
+  npx @hupan56/wlkj init
+
+如果连 Python 都没有 (无法跑本脚本):
+  Windows: winget install Python.Python.3.12
+  Mac:     brew install python
+''')
+    parser.add_argument('--check', action='store_true', help='只检测, 不安装')
+    args = parser.parse_args()
+
+    print('=' * 50)
+    print('  环境检测' + (' (仅检测)' if args.check else ' + 自动安装'))
+    print('=' * 50)
+
+    # 检测当前状态
+    print('\n--- 当前状态 ---')
+    node_ok, node_ver = check('node')
+    py_ok, py_ver = check('python') or (sys.version_info >= (3, 9), f'Python {sys.version.split()[0]}')
+    git_ok, git_ver = check('git')
+
+    # Python 特殊: 本脚本在跑说明至少有 python, 但可能版本不够
+    if not py_ok:
+        py_ok = sys.version_info >= (3, 9)
+        py_ver = f'Python {sys.version_info[0]}.{sys.version_info[1]}'
+
+    print(f'  Node.js: {"[OK] " + node_ver if node_ok else "[缺失]"}')
+    print(f'  Python:  {"[OK] " + py_ver if py_ok else "[缺失或版本低]"}')
+    print(f'  git:     {"[OK] " + git_ver if git_ok else "[缺失] (可选, 不装也能用核心功能)"}')
+
+    if args.check:
+        print('\n仅检测模式。缺少的环境手动装, 或去掉 --check 自动安装。')
+        return 0 if (node_ok and py_ok) else 1
+
+    # 按需安装
+    installed = []
+    if not node_ok:
+        if ask('\nNode.js 缺失 (npx 命令需要它), 自动安装?', 'y'):
+            if install_node():
+                installed.append('Node.js')
+    if not py_ok:
+        if ask('\nPython 版本过低或缺失, 自动安装?', 'y'):
+            if install_python():
+                installed.append('Python')
+    if not git_ok:
+        if ask('\ngit 缺失 (团队协作用, 核心功能不依赖), 自动安装?', 'y'):
+            if install_git():
+                installed.append('git')
+
+    # 重新检测
+    print('\n--- 安装后状态 ---')
+    node_ok2, _ = check('node')
+    # Python: 如果新装了, 当前进程还是旧的, 但 PATH 里应该有了
+    git_ok2, _ = check('git')
+
+    all_ok = node_ok or node_ok2
+    print(f'  Node.js: {"[OK]" if all_ok else "[仍缺失, 可能需要新终端]"}')
+    print(f'  Python:  [OK] {py_ver}')
+    print(f'  git:     {"[OK]" if (git_ok or git_ok2) else "[缺失, 可选]"}')
+
+    if installed:
+        print(f'\n本次安装: {", ".join(installed)}')
+        print('  ⚠ 新装的环境可能需要**重新打开终端**才能生效')
+
+    if all_ok:
+        print('\n' + '=' * 50)
+        print('  环境就绪! 下一步:')
+        print('=' * 50)
+        print('\n  mkdir 我的项目 && cd 我的项目')
+        print('  npx @hupan56/wlkj init')
+        print('')
+        return 0
+    else:
+        print('\n  Node.js 仍缺失, 请手动安装: https://nodejs.org')
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": { "wlkj": "./bin/cli.js" },
   "files": ["bin/", "templates/"],
@@ -9,3 +9,4 @@
   "publishConfig": { "access": "public" },
   "engines": { "node": ">=16" }
 }
+

package/templates/qoder/scripts/install_qoderwork.py

@@ -2,8 +2,11 @@
 """
 install_qoderwork.py - 把 .qoder/skills/ 安装到 QoderWork 桌面端可识别的位置
 
-QoderWork 从 %USERPROFILE%\\.qoderworkcn\\skills\\ 加载技能（每个子目录一个 skill）。
-本项目源在 <repo>/.qoder/skills/，QoderWork 不会读项目目录，必须软链/拷过去。
+QoderWork 从 %USERPROFILE%\\.qoderwork\\skills\\ 加载技能（每个子目录一个 skill），
+从 %USERPROFILE%\\.qoderwork\\commands\\ 加载斜杠命令。
+本项目源在 <repo>/.qoder/skills/ 和 <repo>/.qoder/commands/，QoderWork 不会读项目
+目录，必须软链/拷过去。
+（注: 旧版本误用 ~/.qoderworkcn/，已废弃，官方路径为 ~/.qoderwork/）
 
 为什么用 junction（mklink /J）而不是 symlink（mklink /D）：
   - junction 不需要管理员权限，普通用户可建

package/templates/qoder/scripts/search_index.py

@@ -15,7 +15,7 @@ Usage:
   python search_index.py --list
   python search_index.py --vben
 """
-import os, json, sys
+import os, json, sys, time
 
 # UTF-8 stdio (防御性: stdout 被捕获时不崩溃)
 try:
@@ -69,7 +69,53 @@ def _match_keyword(query_word, kw):
     return False
 
 
+def _search_cache_key(query, platform):
+    """缓存 key: query|platform|keyword-index mtime。"""
+    import hashlib
+    ki_path = os.path.join(BASE, 'data', 'index', 'keyword-index.json') if os.path.isdir(os.path.join(BASE, 'data', 'index')) else None
+    mtime = '%d' % os.path.getmtime(ki_path) if ki_path and os.path.isfile(ki_path) else '0'
+    raw = '{}|{}|{}'.format(query.lower(), platform or '', mtime)
+    return hashlib.md5(raw.encode('utf-8')).hexdigest()[:16]
+
+
 def search_keywords(query, platform=None):
+    # 结果缓存: 同 query+platform+索引未变 → 直接返回缓存输出
+    cache_key = _search_cache_key(query, platform)
+    cache_path = os.path.join(BASE, '.qoder', '.runtime', 'search-cache-%s.txt' % cache_key)
+    if os.path.isfile(cache_path):
+        try:
+            age = time.time() - os.path.getmtime(cache_path)
+            if age < 86400:  # 24h 有效
+                with open(cache_path, encoding='utf-8') as f:
+                    sys.stdout.write(f.read())
+                return
+        except OSError:
+            pass
+
+    # 缓存未命中, 正常计算并写入缓存
+    import io
+    old_stdout = sys.stdout
+    sys.stdout = buf = io.StringIO()
+    try:
+        _search_keywords_impl(query, platform)
+    finally:
+        sys.stdout = old_stdout
+    output = buf.getvalue()
+    sys.stdout.write(output)
+    # 写缓存 (best-effort)
+    try:
+        cache_dir = os.path.join(BASE, '.qoder', '.runtime')
+        os.makedirs(cache_dir, exist_ok=True)
+        tmp = cache_path + '.tmp'
+        with open(tmp, 'w', encoding='utf-8') as f:
+            f.write(output)
+        os.replace(tmp, cache_path)
+    except OSError:
+        pass
+
+
+def _search_keywords_impl(query, platform=None):
+    """实际的搜索逻辑 (原 search_keywords 内容)。"""
     ki = load_index('keyword-index.json', hint='Run: python git_sync.py')
     if ki is None:
         return

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

@@ -0,0 +1,36 @@
+---
+name: wl-code
+description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. 用户说'开始写代码''按规格实现''实现这个接口''把这个需求做出来'或输入 /wl-code 时触发。需用户确认（DANGEROUS）。"
+trigger: "Spec 已确认待实现；用户说'开始写代码''按spec实现''/wl-code'"
+---
+
+# wl-code — 按 Spec 实现代码（/wl-code 命令入口）
+
+> 这是 `/wl-code` 命令的 skill 入口。让 QoderWork 的 `/` 列表也能用 `/wl-code`。
+> ⚠️ DANGEROUS 操作（写代码），执行前向用户确认范围。
+> 完整规则见功能型 skill `.qoder/skills/spec-coder/SKILL.md`
+> 和命令 `.qoder/commands/wl-code.md`。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前活动任务（找对应的 spec）
+- 活动任务的 spec：`workspace/specs/` 或 `workspace/tasks/{id}/spec.md`
+
+## 执行
+
+1. **加载 Spec**：按 REQ-ID 找 spec；没参数就读 `.qoder/.current-task`
+2. **搜相关代码**：
+   ```bash
+   python .qoder/scripts/search_index.py <关键词>
+   ```
+   读相关文件了解现有模式。
+3. **按 spec-coder skill 实现**：严格按 spec，遵循 data/code/ 的团队约定
+4. **自检**：
+   - [ ] Spec 所有需求都覆盖
+   - [ ] 无 TODO/FIXME
+   - [ ] 风格跟周围代码一致
+   - [ ] 有错误处理
+5. **报告**：告诉用户实现了什么，建议下一步 `/wl-test`
+
+详细编码规范见 `.qoder/skills/spec-coder/SKILL.md`。

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

@@ -0,0 +1,73 @@
+---
+name: wl-prd
+description: "生成 PRD + 平台匹配的原型（/wl-prd 命令入口）。Generate PRD with platform-aware prototype. 用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'或输入 /wl-prd 时触发。先问平台！"
+trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-prd"
+---
+
+# wl-prd — PRD + 原型生成（/wl-prd 命令入口）
+
+> 这是 `/wl-prd` 命令的 skill 入口。QoderWork 的 `/` 列表读 skills，
+> 所以本 skill 让 QoderWork 也能用 `/wl-prd`，与 Qoder IDE 保持一致。
+> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd.md` 和
+> 功能型 skill `.qoder/skills/prd-generator/SKILL.md`。
+
+## ⚠️ STEP 0: 必须先问平台（任何分析前）
+
+```
+这个需求是针对哪个平台？
+
+1. Web 管理端 (fywl-ui) - Ant Design Vue + VxeGrid 风格
+2. APP 移动端 (Carmg-H5) - Vant 风格
+3. 两端都要
+
+请选择 (1/2/3):
+```
+
+**绝不自动判断。绝不假设。绝不跳过。永远先问。等用户回答。**
+
+| 回答 | 平台 | 项目 | 搜索 flag | 原型模板 |
+|------|------|------|-----------|----------|
+| 1 / Web / PC / 管理端 | Web | fywl-ui | `--platform web` | prototype-web.html |
+| 2 / APP / H5 / 移动端 | APP | Carmg-H5 | `--platform app` | prototype-app.html |
+| 3 / 都要 / 两端 | Both | Both | 都跑 | 两个模板，两份原型 |
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+会话开始先读（不存在就跳过，不要报错中断）：
+- `.qoder/.developer` — 当前开发者名（产出存到 `workspace/members/{dev}/drafts/`）
+- `.qoder/.current-task` — 当前活动任务
+- `data/index/.index-meta.json` — 知识图谱新鲜度（过期提示先 `/wl-init`，不阻塞）
+
+## 完整流程
+
+按 `.qoder/commands/wl-prd.md` 执行（含 Reference/Brainstorm/Planning/Quick
+四种模式）。核心步骤：
+
+1. **一次取全上下文**（fast path）：
+   ```bash
+   python .qoder/scripts/context_pack.py <业务关键词> --platform <web|app>
+   ```
+2. 读历史 PRD、业务草稿、风格 token
+3. 一次性确认发现（不要一条一条问）
+4. 生成 PRD + 原型（从平台模板开始，填真实字段，diff 高亮）
+5. **EVA 质量门禁**：
+   ```bash
+   python .qoder/scripts/eval_prd.py <draft-prd.md> <prototype.html>
+   ```
+   <80% 就修到 PASS。
+6. 发布 + 自动同步：
+   ```bash
+   python .qoder/scripts/team_sync.py push
+   ```
+
+详细生成规则、样式 token、原型规则见：
+- 功能型 skill：`.qoder/skills/prd-generator/SKILL.md`
+- 原型规则：`.qoder/skills/prototype-generator/SKILL.md`
+- 命令完整定义：`.qoder/commands/wl-prd.md`
+
+## REQ-ID 分配（并发安全）
+
+**必须**用原子分配器，禁止手动扫描最大值：
+```bash
+python -c "import sys; sys.path.insert(0,'.qoder/scripts'); from common.reqid import allocate_req_id; n=allocate_req_id(); print('REQ-%d-%03d' % (__import__('datetime').date.today().year, n))"
+```

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

@@ -0,0 +1,39 @@
+---
+name: wl-spec
+description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. 用户说'生成规格''写spec''出技术方案''把PRD转开发文档'或输入 /wl-spec 时触发。"
+trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-spec'"
+---
+
+# wl-spec — 生成开发 Spec（/wl-spec 命令入口）
+
+> 这是 `/wl-spec` 命令的 skill 入口。让 QoderWork 的 `/` 列表也能用 `/wl-spec`。
+> 完整规则见功能型 skill `.qoder/skills/spec-generator/SKILL.md`
+> 和命令 `.qoder/commands/wl-spec.md`。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前任务（决定 spec 存哪个 task 目录）
+- 扫描 PRD 来源：`data/docs/prd/`（已发布）+
+  `workspace/members/{dev}/drafts/REQ-*.md`（草稿），找出还没 Spec 的 PRD
+- 字段命名约定：`python .qoder/scripts/search_index.py --field <字段名>`
+- 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）见
+  `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
+
+## 执行
+
+1. 定位 PRD（按 REQ-ID 或最新发布的）
+2. 读 PRD + 相关代码（用 search_index.py 找现有实现模式）
+3. 按 spec-generator skill 生成 spec.md（接口/字段/数据模型/验收标准）
+4. 存到 `workspace/specs/spec-{REQ-ID}-{desc}.md`
+5. 通知开发评审
+6. 发布后自动同步：
+   ```bash
+   python .qoder/scripts/team_sync.py push
+   ```
+
+## Review 模式
+
+带 `review` 参数 → 读现有 spec 做评审，给出改进建议，不重新生成。
+
+详细生成规则见 `.qoder/skills/spec-generator/SKILL.md`。

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

@@ -0,0 +1,40 @@
+---
+name: wl-test
+description: "为已实现代码生成单元测试（/wl-test 命令入口）。Generate unit tests for implemented code. 用户说'写单元测试''补测试''覆盖一下''写个test'或输入 /wl-test 时触发。需用户确认（DANGEROUS）。"
+trigger: "代码实现完成；用户说'写测试''补单测''生成test''/wl-test'"
+---
+
+# wl-test — 生成单元测试（/wl-test 命令入口）
+
+> 这是 `/wl-test` 命令的 skill 入口。让 QoderWork 的 `/` 列表也能用 `/wl-test`。
+> ⚠️ DANGEROUS 操作（写测试文件），执行前向用户确认。
+> 完整规则见功能型 skill `.qoder/skills/test-generator/SKILL.md`
+> 和命令 `.qoder/commands/wl-test.md`。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前活动任务（找刚实现的代码）
+- 活动 task 的实现代码 + 对应 spec
+
+## 执行
+
+1. **找目标代码**：
+   ```bash
+   python .qoder/scripts/search_index.py <类名或关键词>
+   ```
+   没参数就用当前 task 的实现代码。
+2. **读代码 + spec**：理解要测什么
+3. **按 test-generator skill 生成**，覆盖：
+   - 每个函数的 happy path
+   - 边界值（null/空/边界）
+   - 错误处理
+   - 集成点
+4. **自检**：
+   - [ ] 测试能跑
+   - [ ] 覆盖主场景
+   - [ ] 断言正确
+   - [ ] 遵循团队测试约定
+5. **报告**：告诉用户生成了哪些测试，建议下一步 `/wl-commit`
+
+详细测试规范见 `.qoder/skills/test-generator/SKILL.md`。

package/templates/root//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -0,0 +1,259 @@
+# 完整使用说明
+
+> 从零开始，一步一步来。连 Python 都没有也能跟着做。
+
+---
+
+## 第一步：装前置环境（10 分钟）
+
+### 1.1 装 Node.js（必须）
+
+Node.js 用来跑 `npx` 安装命令。
+
+**Windows：**
+1. 打开 https://nodejs.org
+2. 下载 **LTS 版**（左边那个绿色按钮）
+3. 双击安装，一路点"下一步"，全部默认
+4. 装完按 `Win + R`，输 `cmd` 回车，在黑窗口里输：
+   ```
+   node --version
+   ```
+   看到 `v20.x.x` 之类的就成功了
+
+**Mac：**
+1. 打开终端（Launchpad → 其他 → 终端）
+2. 输：`brew install node`（没装 brew 的先去 brew.sh 装）
+3. 验证：`node --version`
+
+### 1.2 装 Python（必须）
+
+Python 用来跑工作流的脚本引擎。
+
+**Windows：**
+1. 打开 https://www.python.org/downloads/
+2. 点黄色大按钮 "Download Python 3.x.x"
+3. 双击安装包，**重要：勾选底部 "Add Python to PATH"**，再点 "Install Now"
+4. 装完在 cmd 里输：
+   ```
+   python --version
+   ```
+   看到 `Python 3.9.x` 或更高就成功了
+
+**Mac：**
+1. 终端输：`brew install python`
+2. 验证：`python3 --version`
+
+### 1.3 装 git（推荐，不装也能用大部分功能）
+
+git 用来团队协作和拉取源码。**没有 git 不影响写 PRD、建任务、出报告。**
+
+**Windows：**
+1. 打开 https://git-scm.com/download/win
+2. 下载自动安装包，双击安装，全部默认
+3. 验证：`git --version`
+
+**Mac：**
+- 打开终端，第一次输 `git` 时 Mac 会提示安装，点"安装"即可
+- 或手动：`brew install git`
+
+---
+
+## 第二步：创建项目并安装工作流（2 分钟）
+
+### 2.1 建项目文件夹
+
+**Windows：**
+```
+mkdir D:\我的项目
+cd D:\我的项目
+```
+
+**Mac：**
+```
+mkdir ~/我的项目
+cd ~/我的项目
+```
+
+### 2.2 一键安装
+
+```
+npx @hupan56/wlkj init
+```
+
+它会自动：
+- 下载并安装完整工作流引擎
+- 问你叫什么名字（或从 git 配置读）
+- 注册你的身份
+- 如果有 git，自动配置
+- 如果配了源码地址，自动拉取源码并建索引
+
+看到这个就成功了：
+```
+✓ 开发者: 你的名字
+安装完成! 现在可以开始了
+```
+
+> 也可以指定名字：`npx @hupan56/wlkj init 小王`
+
+---
+
+## 第三步：开始使用
+
+### 方式 A：用 Qoder 客户端（推荐）
+
+如果你装了 **Qoder IDE / Quest / QoderWork**：
+
+1. 用 Qoder 打开你刚创建的项目文件夹
+2. 在对话框里直接说中文：
+   - "写个保险异常筛选的需求"
+   - "查一下考勤代码在哪"
+   - "建个任务：登录优化"
+3. 或输入 `/` 看所有命令（`/wl-prd` `/wl-search` 等）
+
+**看不到 `/` 命令？**
+- Quest 模式：新建一个对话
+- QoderWork：跑 `python .qoder/scripts/install_qoderwork.py`，然后重启 QoderWork
+
+### 方式 B：用命令行（无 Qoder 时）
+
+```
+python .qoder/scripts/search_index.py 保险
+python .qoder/scripts/task.py create "登录优化"
+python .qoder/scripts/report.py daily
+```
+
+---
+
+## 全部功能速查
+
+### 写需求 + 原型
+
+| 做什么 | 说什么 / 命令 |
+|--------|-------------|
+| 写完整需求 | "写个 XXX 的需求" 或 `/wl-prd` |
+| 写小改动 | "快速写个 XXX" |
+| 头脑风暴 | "脑暴一下 XXX" |
+| 画原型 | 随需求自动生成 |
+| 评审 PRD | "评审这个 PRD" |
+
+### 查代码（不懂代码也能查）
+
+| 做什么 | 说什么 / 命令 |
+|--------|-------------|
+| 找业务代码 | "保险的代码在哪" 或 `/wl-search 保险` |
+| 找 API | `/wl-search --api 考勤` |
+| 找字段用法 | `/wl-search --field nickName` |
+| 找同类页面 | `/wl-search --style table` |
+| 一键全上下文 | `python .qoder/scripts/context_pack.py 保险 --platform web` |
+
+### 管任务
+
+| 做什么 | 说什么 / 命令 |
+|--------|-------------|
+| 建任务 | "建个任务：登录优化" |
+| 设截止日期 | `python .qoder/scripts/task.py set-due 任务名 2026-07-15` |
+| 标记依赖 | `python .qoder/scripts/task.py block A B`（A 被 B 阻塞） |
+| 看能开始的 | `python .qoder/scripts/task.py list --ready` |
+| 看被卡住的 | `python .qoder/scripts/task.py list --blocked` |
+| 看甘特图 | `python .qoder/scripts/task.py gantt` |
+| 完成任务 | "这个任务做完了" |
+
+### 看进度 + 出报告
+
+| 做什么 | 说什么 / 命令 |
+|--------|-------------|
+| 看项目健康度 | "项目怎么样" 或 `python .qoder/scripts/status.py` |
+| 出日报 | "今天干了啥" 或 `python .qoder/scripts/report.py daily` |
+| 出周报 | `python .qoder/scripts/report.py weekly` |
+
+### 导出
+
+| 做什么 | 命令 |
+|--------|------|
+| 导 Jira CSV | `python .qoder/scripts/export.py jira` |
+| 导 OpenAPI | `python .qoder/scripts/export.py openapi --project 你的项目` |
+| 查调用图 | `python .qoder/scripts/export.py callgraph --class ClassName` |
+
+### 团队协作
+
+| 做什么 | 说什么 / 命令 |
+|--------|-------------|
+| 同步给团队 | "同步" 或 `python .qoder/scripts/team_sync.py push` |
+| 拉取队友最新 | "拉取最新" 或 `python .qoder/scripts/team_sync.py pull` |
+| 看同步状态 | `python .qoder/scripts/team_sync.py status` |
+
+---
+
+## 团队配置（团队负责人做一次）
+
+### 填源码仓库地址
+
+打开 `.qoder/config.yaml`，找到这段，改成你们的 git 地址：
+
+```yaml
+git_sync:
+  projects:
+    你的项目名:                              # ← 改成你的项目名
+      url: http://你的git服务器/你的项目.git  # ← 改成你的
+      branch: main                           # ← 改成你的主分支
+```
+
+> 不知道填什么？注释掉整段，手动把代码放到 `data/code/项目名/` 也行。
+
+### 注册周五自动更新（全队只需一台机器）
+
+```
+python .qoder/scripts/setup_weekly_cron.bat
+```
+
+### 配飞书通知（可选）
+
+`.qoder/config.yaml` 里：
+
+```yaml
+feishu:
+  enabled: true
+  webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/你的token"
+```
+
+---
+
+## 常见问题
+
+### 安装时
+
+| 问题 | 解决 |
+|------|------|
+| `npx` 命令找不到 | 先装 Node.js（见第一步） |
+| `python` 命令找不到 | 先装 Python（见第一步），**勾选 Add to PATH** |
+| setup.py 报错 | 跑 `python .qoder/scripts/init_doctor.py --fix` 自动修复 |
+
+### 使用时
+
+| 问题 | 解决 |
+|------|------|
+| 搜索没结果 | 先跑 `python .qoder/scripts/setup.py` 建索引 |
+| Qoder 里看不到 `/` 命令 | 新建对话 / 重启 QoderWork |
+| 命令报错 | `python .qoder/scripts/init_doctor.py --fix` |
+| 索引过期 | `python .qoder/scripts/git_sync.py --index-only` |
+
+### 速查
+
+```
+安装         → npx @hupan56/wlkj init
+环境修复     → python .qoder/scripts/init_doctor.py --fix
+重新初始化   → python .qoder/scripts/setup.py
+性能测试     → python .qoder/scripts/benchmark.py
+```
+
+---
+
+## 环境要求总结
+
+| 环境 | 必须？ | 版本 |
+|------|--------|------|
+| **Node.js** | 必须（装工作流用） | 16+ |
+| **Python** | 必须（跑引擎） | 3.9+ |
+| **git** | 推荐（团队协作用，不装也能用核心功能） | 任意 |
+| **Qoder 客户端** | 推荐（AI 对话驱动，不装也能用命令行） | IDE/Quest/QoderWork 任一 |
+| **飞书** | 可选（通知推送） | 有群机器人即可 |

package/templates/qoder/config.toml

@@ -1,5 +0,0 @@
-# Qoder CLI 项目级配置
-# 文档: https://docs.qoder.com/zh/cli/permissions
-
-# 权限模式: auto = 自动批准 (不弹确认)
-approval_mode = "auto"