@hupan56/wlkj 2.1.0 → 2.2.1

package/bin/cli.js

@@ -7,6 +7,23 @@ const { execSync } = require("child_process");
 
 const T = path.join(__dirname, "..", "templates");
 
+// 当前 npm 包版本（从 package.json 读，不硬编码）
+const PKG_VERSION = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")
+).version;
+
+// 升级时受保护的用户数据文件（绝不覆盖）
+// 这些文件含团队/机器特定配置，覆盖 = 数据丢失
+const PROTECTED_FILES = new Set([
+  "config.yaml",        // 团队 git 仓库 URL、平台映射
+  "settings.json",      // 本地权限/hook 配置
+]);
+
+// 本地状态文件（升级时也绝不碰，但不算"受保护配置"，不提示合并）
+const LOCAL_STATE_FILES = new Set([
+  ".developer", ".current-task", ".engine-version",
+]);
+
 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); }
@@ -48,10 +65,16 @@ function doInit(name) {
 
   // === 1. 拷贝完整引擎 (镜像 .qoder/ 结构) ===
   // 源: templates/qoder/*  目标: .qoder/*
+  // 注意: init 用 "update" 模式的保护逻辑更安全 —— 新装时目标文件不存在,
+  // 保护逻辑不触发; 重跑 init 时 config.yaml/settings.json 不会被覆盖。
   const qoderSrc = path.join(T, "qoder");
   let copied = 0;
   if (fs.existsSync(qoderSrc)) {
-    copied = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"));
+    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
+    copied = r.copied;
+    if (r.protectedN > 0) {
+      console.log(`  [保护] ${r.protectedN} 个配置文件未覆盖（新版存为 .new）`);
+    }
   }
   console.log(`  引擎: ${copied} 个文件 (${hasExisting ? "更新" : "新建"})`);
 
@@ -86,7 +109,8 @@ function doInit(name) {
     const baseGitignore = [
       "# Source code repos (cloned by git_sync.py)", "data/code/",
       "", "# AI pipeline runtime", ".qoder/.developer", ".qoder/.current-task",
-      ".qoder/.runtime/", "", "# Personal learning", ".qoder/learning/feedback.jsonl",
+      ".qoder/.engine-version", ".qoder/.runtime/", "",
+      "# Personal learning", ".qoder/learning/feedback.jsonl",
       "", "# Machine-local", "data/index/.last-sync", "data/index/.prd-collected.json",
       "data/index/.index-meta.json", "data/index/.sync-lock", "data/index/.file-keys.json",
       "data/index/.inverted-cache.json", "data/index/*.corrupt",
@@ -113,8 +137,11 @@ function doInit(name) {
     console.log(`  setup.py 未找到, 跳过自动初始化`);
   }
 
+  // === 7. 写版本戳 ===
+  writeEngineVersion(cwd);
+
   console.log(`\n${"=".repeat(50)}`);
-  console.log(`  安装完成!`);
+  console.log(`  安装完成!  (v${PKG_VERSION})`);
   console.log(`${"=".repeat(50)}`);
   console.log(`\n  现在可以开始了:`);
   console.log(`    在 Qoder 里说 "写个 XX 的需求"`);
@@ -123,31 +150,98 @@ function doInit(name) {
   console.log(`  环境问题? python .qoder/scripts/init_doctor.py --fix\n`);
 }
 
-// 递归拷贝目录, 返回文件数
-function copyDirRecursive(src, dst) {
-  let count = 0;
-  if (!fs.existsSync(src)) return 0;
+// 递归拷贝目录, 返回 {copied, protected, skipped}
+// mode: "init" (新装, 全拷) | "update" (升级, 保护用户数据)
+function copyDirRecursive(src, dst, mode = "init") {
+  let copied = 0, protectedN = 0, skipped = 0;
+  if (!fs.existsSync(src)) return { copied, protectedN, skipped };
   fs.mkdirSync(dst, { recursive: true });
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     if (entry.name === "__pycache__" || entry.name.endsWith(".pyc")) continue;
     const s = path.join(src, entry.name);
     const d = path.join(dst, entry.name);
     if (entry.isDirectory()) {
-      count += copyDirRecursive(s, d);
+      const r = copyDirRecursive(s, d, mode);
+      copied += r.copied; protectedN += r.protectedN; skipped += r.skipped;
     } else {
-      // 不覆盖已存在的 (增量更新, 保留用户改动)
-      // 但 .py 和 .md / config.yaml / rules 始终更新 (引擎文件)
       const isEngine = entry.name.endsWith(".py") || entry.name.endsWith(".md") ||
                        entry.name.endsWith(".yaml") || entry.name.endsWith(".yml") ||
                        entry.name.endsWith(".toml") || entry.name.endsWith(".json") ||
                        entry.name.endsWith(".html") || entry.name.endsWith(".txt");
-      if (isEngine || !fs.existsSync(d)) {
-        fs.copyFileSync(s, d);
+
+      if (mode === "update") {
+        // 升级模式: 受保护文件绝不覆盖
+        if (PROTECTED_FILES.has(entry.name) && fs.existsSync(d)) {
+          // 新版内容存为 .new 让用户手动合并（仅当内容不同）
+          if (!filesEqual(s, d)) {
+            fs.copyFileSync(s, d + ".new");
+            protectedN++;
+          } else {
+            skipped++;
+          }
+          continue;
+        }
+        // 引擎文件: 无条件刷新（纯引擎, 不含用户数据）
+        // 非引擎文件: 已存在跳过, 不存在才建
+        if (isEngine || !fs.existsSync(d)) {
+          fs.copyFileSync(s, d);
+          copied++;
+        } else {
+          skipped++;
+        }
+      } else {
+        // init 模式: 引擎文件全覆盖, 非引擎已存在跳过 (保留用户改动)
+        if (isEngine || !fs.existsSync(d)) {
+          fs.copyFileSync(s, d);
+        }
+        copied++;
       }
-      count++;
     }
   }
-  return count;
+  return { copied, protectedN, skipped };
+}
+
+// 两文件内容是否相同（先比大小再比内容）
+function filesEqual(a, b) {
+  try {
+    const sa = fs.statSync(a), sb = fs.statSync(b);
+    if (sa.size !== sb.size) return false;
+    return fs.readFileSync(a).equals(fs.readFileSync(b));
+  } catch { return false; }
+}
+
+// 版本戳: .qoder/.engine-version 存当前引擎版本
+function writeEngineVersion(cwd) {
+  try {
+    const p = path.join(cwd, ".qoder", ".engine-version");
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, PKG_VERSION + "\n", "utf-8");
+  } catch { /* 不阻塞 */ }
+}
+
+function readEngineVersion(cwd) {
+  try {
+    const p = path.join(cwd, ".qoder", ".engine-version");
+    if (fs.existsSync(p)) return fs.readFileSync(p, "utf-8").trim();
+  } catch { /* */ }
+  return null;
+}
+
+// 跑 install_qoderwork.py（升级时强制刷新 commands）
+function runQoderWorkInstall(cwd, forceCommands) {
+  const script = path.join(cwd, ".qoder", "scripts", "install_qoderwork.py");
+  if (!fs.existsSync(script)) {
+    console.log("  [跳过] install_qoderwork.py 不存在");
+    return;
+  }
+  const args = ["python", `"${script}"`];
+  if (forceCommands) args.push("--force-commands");
+  try {
+    console.log(`\n--- 刷新 QoderWork ---`);
+    execSync(args.join(" "), { cwd, stdio: "inherit", timeout: 60000 });
+  } catch (e) {
+    console.log(`  QoderWork 刷新失败 (不阻塞): ${(e.message || "").slice(0, 80)}`);
+  }
 }
 
 function doStatus() {
@@ -165,12 +259,80 @@ function doStatus() {
     const n = fs.readdirSync(wsSpecs).filter(f => f.endsWith(".md")).length;
     console.log(`PRDs: ${n}`);
   }
+  const ver = readEngineVersion(process.cwd());
+  console.log(`engine: ${ver || "未知"} (最新: v${PKG_VERSION})${ver === PKG_VERSION ? " [最新]" : ver ? " [可升级: npx @hupan56/wlkj update]" : ""}`);
+  console.log("");
+}
+
+function doUpdate() {
+  const cwd = process.cwd();
+  const oldVer = readEngineVersion(cwd);
+  const qoderSrc = path.join(T, "qoder");
+
+  // 前置检查: 必须已装过
+  if (!fs.existsSync(path.join(cwd, ".qoder", "scripts"))) {
+    console.log("\n  未检测到已安装的引擎。首次安装请用:");
+    console.log("    npx @hupan56/wlkj init [你的名字]\n");
+    return;
+  }
+
+  console.log(`\nwlkj update${oldVer ? " " + oldVer : ""} -> v${PKG_VERSION}\n`);
+
+  // === 1. 刷新引擎文件（保护 config.yaml / settings.json）===
+  let copied = 0, protectedN = 0, skipped = 0;
+  if (fs.existsSync(qoderSrc)) {
+    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
+    copied = r.copied; protectedN = r.protectedN; skipped = r.skipped;
+  }
+  console.log(`  引擎刷新: ${copied} 个文件${skipped ? ` / ${skipped} 无变化` : ""}`);
+
+  // 报告受保护文件
+  if (protectedN > 0) {
+    console.log(`  [保护] ${protectedN} 个配置文件已保留你的本地设置:`);
+    console.log(`         新版模板存为 .new 文件, 如需合并新结构请手动对比:`);
+    // 列出实际生成的 .new 文件
+    try {
+      for (const f of fs.readdirSync(path.join(cwd, ".qoder"))) {
+        if (f.endsWith(".new")) {
+          console.log(`           .qoder/${f}`);
+        }
+      }
+    } catch { /* */ }
+  } else {
+    console.log(`  config.yaml / settings.json: 已保护（未改动）`);
+  }
+
+  // === 2. 根文件（文档类, 安全覆盖）===
+  ["root/AGENTS.md", "root/新手指南.md"].forEach(f => {
+    const src = path.join(T, f);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, path.join(cwd, path.basename(f)));
+    }
+  });
+  console.log(`  根文档: 已更新`);
+
+  // === 3. 刷新 QoderWork commands（强制覆盖已存在的）===
+  runQoderWorkInstall(cwd, true);
+
+  // === 4. 写版本戳 ===
+  writeEngineVersion(cwd);
+
+  console.log(`\n${"=".repeat(50)}`);
+  console.log(`  升级完成!  (v${PKG_VERSION})`);
+  console.log(`${"=".repeat(50)}`);
+  console.log(`\n  生效方式:`);
+  console.log(`    Qoder IDE / Quest: 新建对话即可`);
+  console.log(`    QoderWork: 重启应用或新建对话`);
+  if (protectedN > 0) {
+    console.log(`\n  ⚠ 有配置文件新版有变化, 生成 .new 文件:`);
+    console.log(`    确认无需合并后可直接删除, 或手动合并后删除`);
+  }
   console.log("");
 }
 
 function doHelp() {
   console.log("");
-  console.log("wlkj - AI 产品研发工作流 (v2.0)");
+  console.log(`wlkj - AI 产品研发工作流 (v${PKG_VERSION})`);
   console.log("");
   console.log("=== 环境安装 (什么都没装时先跑这个) ===");
   console.log("  npx @hupan56/wlkj install-env       检测+自动装 Node/Python/git");
@@ -179,23 +341,26 @@ function doHelp() {
   console.log("=== 一键安装 (装好环境后) ===");
   console.log("  npx @hupan56/wlkj init [你的名字]    安装完整引擎 + 自动初始化");
   console.log("");
+  console.log("=== 升级 (已装用户, 新版本发布后) ===");
+  console.log("  npx @hupan56/wlkj update              刷新引擎, 保护你的配置");
+  console.log("");
   console.log("=== 安装后怎么用 ===");
   console.log("  在 Qoder (IDE/Quest/QoderWork) 里:");
   console.log("    说中文: '写个 XX 的需求' '查一下 XX 代码' '建个任务'");
   console.log("    或斜杠: /wl-prd /wl-search /wl-task /wl-status /wl-report");
   console.log("");
   console.log("=== 状态 ===");
-  console.log("  npx wlkj status            查看当前状态");
+  console.log("  npx @hupan56/wlkj status            查看当前状态 + 引擎版本");
   console.log("");
   console.log("=== 环境修复 ===");
   console.log("  python .qoder/scripts/init_doctor.py --fix   自动修复环境");
   console.log("  python .qoder/scripts/setup.py               重新初始化");
   console.log("");
   console.log("=== Git (中文命令) ===");
-  console.log("  npx wlkj 提交PRD           提交 PRD");
-  console.log("  npx wlkj 提交任务           提交任务");
-  console.log("  npx wlkj 提交               全部提交并推送");
-  console.log("  npx wlkj 拉取最新 / 同步    git pull");
+  console.log("  npx @hupan56/wlkj 提交PRD           提交 PRD");
+  console.log("  npx @hupan56/wlkj 提交任务           提交任务");
+  console.log("  npx @hupan56/wlkj 提交               全部提交并推送");
+  console.log("  npx @hupan56/wlkj 拉取最新 / 同步    git pull");
   console.log("");
 }
 
@@ -285,6 +450,7 @@ const mapped = rest.map(a => a === "-p" ? "--priority" : a);
 
 switch (cmd) {
   case "init": doInit(rest[0]); break;
+  case "update": case "upgrade": doUpdate(); break;
   case "install-env": doInstallEnv(rest[0] === "--check"); break;
   case "task": process.stdout.write(py("task.py", mapped)); break;
   case "status": doStatus(); break;

package/package.json

@@ -1,12 +1,28 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
-  "bin": { "wlkj": "./bin/cli.js" },
-  "files": ["bin/", "templates/"],
-  "keywords": ["workflow", "ai", "prd", "pipeline", "qoder", "product", "team"],
+  "bin": {
+    "wlkj": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/"
+  ],
+  "keywords": [
+    "workflow",
+    "ai",
+    "prd",
+    "pipeline",
+    "qoder",
+    "product",
+    "team"
+  ],
   "license": "MIT",
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=16" }
+  "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 不需要管理员权限，普通用户可建
@@ -85,6 +88,16 @@ def find_source_skills() -> list:
     return result
 
 
+def file_equal(a: Path, b: Path) -> bool:
+    """快速判断两文件内容是否相同（先比大小再比内容，避免无谓全读）。"""
+    try:
+        if a.stat().st_size != b.stat().st_size:
+            return False
+        return a.read_bytes() == b.read_bytes()
+    except OSError:
+        return False
+
+
 def create_junction(link: Path, target: Path) -> bool:
     """用 mklink /J 创建 junction。返回是否成功。"""
     # 用 errors="replace" 防止 Windows GBK 输出（如"为...创建的联接"）触发 UnicodeDecodeError
@@ -194,6 +207,8 @@ def main():
                         help="仅检查状态，不改动")
     parser.add_argument("--copy", action="store_true",
                         help="用拷贝代替 junction（非 Windows 或不想软链时用）")
+    parser.add_argument("--force-commands", action="store_true",
+                        help="强制覆盖已存在的 command 文件（升级时用；默认已存在则跳过）")
     args = parser.parse_args()
 
     print("=" * 56)
@@ -292,7 +307,7 @@ def main():
     # 同时安装 commands (让 QoderWork 用户级也能看到 /wl-* 命令)
     if action in ("install", "check") and SOURCE_COMMANDS_DIR.is_dir():
         print("\n--- Commands (/wl-* 斜杠命令) ---")
-        cmd_count = {"ok": 0, "new": 0}
+        cmd_count = {"ok": 0, "new": 0, "upd": 0}
         for cmd_file in sorted(SOURCE_COMMANDS_DIR.glob("wl-*.md")):
             name = cmd_file.name  # e.g. wl-prd.md
             target = QODERWORK_COMMANDS_DIR / name
@@ -302,18 +317,31 @@ def main():
                 else:
                     print(f"  [MISS] {name}")
             else:  # install
-                if target.exists():
-                    cmd_count["ok"] += 1
-                else:
+                need_copy = False
+                if not target.exists():
+                    need_copy = True
+                elif args.force_commands:
+                    # 强制刷新（升级场景）：仅当内容不同才覆盖，避免无谓写
+                    import shutil
+                    if not file_equal(cmd_file, target):
+                        need_copy = True
+                if need_copy:
                     try:
                         QODERWORK_COMMANDS_DIR.mkdir(parents=True, exist_ok=True)
-                        # commands 是单文件, 用拷贝 (不像 skills 是目录用 junction)
                         import shutil
                         shutil.copy2(str(cmd_file), str(target))
-                        cmd_count["new"] += 1
+                        if target.exists() and args.force_commands:
+                            cmd_count["upd"] += 1
+                        else:
+                            cmd_count["new"] += 1
                     except OSError as e:
                         print(f"  [ERR] {name}: {e}")
-        print(f"  commands: {cmd_count['new']} 新建 / {cmd_count['ok']} 已存在")
+                else:
+                    cmd_count["ok"] += 1
+        msg = f"  commands: {cmd_count['new']} 新建 / {cmd_count['ok']} 已存在"
+        if cmd_count["upd"]:
+            msg += f" / {cmd_count['upd']} 刷新"
+        print(msg)
 
     if action == "install" and counts["err"] == 0:
         print("\n✓ 安装完成。重启 QoderWork（或新建对话）后技能生效。")

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/qoder/config.toml

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