@hupan56/wlkj 2.5.0 → 2.6.0

package/bin/cli.js

@@ -131,7 +131,7 @@ function doInit(name) {
       execSync(cmd, { cwd, stdio: "inherit", timeout: 300000 });
     } catch (e) {
       console.log(`  setup 部分失败 (不阻塞): ${(e.message || "").slice(0, 100)}`);
-      console.log(`  可手动重跑: python .qoder/scripts/setup.py`);
+      console.log(`  可重新运行: npx @hupan56/wlkj init ${name || "<你的名字>"}`);
     }
   } else {
     console.log(`  setup.py 未找到, 跳过自动初始化`);
@@ -386,6 +386,33 @@ function doUpdate() {
   console.log(`\n  生效方式:`);
   console.log(`    Qoder IDE / Quest: 新建对话即可`);
   console.log(`    QoderWork: 重启应用或新建对话`);
+
+  // 检查 git 身份是否需要配置 (只检测不引导, update 保持轻量)
+  // 老用户如果之前 init 时塞了假账号, 这里提示重跑 init 修正
+  let gitWarn = false;
+  try {
+    const devFile = path.join(cwd, ".qoder", ".developer");
+    if (fs.existsSync(devFile)) {
+      const devName = fs.readFileSync(devFile, "utf-8").trim();
+      const mj = path.join(cwd, "workspace", "members", devName, "member.json");
+      if (fs.existsSync(mj)) {
+        const m = JSON.parse(fs.readFileSync(mj, "utf-8"));
+        const ga = m.git_author || "";
+        if (!ga || ga.includes("@local") || ga.includes("@unknown")) {
+          gitWarn = true;
+        }
+      }
+    }
+  } catch { /* 检测失败不阻塞 */ }
+
+  if (gitWarn) {
+    console.log(`\n  ⚠ git 账号未配置或为假账号 (push/同步会失败)`);
+    console.log(`    重跑初始化可修复: npx @hupan56/wlkj init <你的名字>`);
+    console.log(`    (init 会交互式引导你配置团队 git 账号和团队仓库)`);
+  } else {
+    console.log(`\n  如果还没配过 git 账号或团队仓库, 重跑: npx @hupan56/wlkj init <你的名字>`);
+  }
+
   if (protectedN > 0) {
     console.log(`\n  ⚠ 有配置文件新版有变化, 生成 .new 文件:`);
     console.log(`    确认无需合并后可直接删除, 或手动合并后删除`);

package/package.json

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

package/templates/qoder/agents/prd-planning.md

@@ -53,4 +53,5 @@ with the user's latest answers (do not loop indefinitely).
 ## Output
 1. Save planning report to: workspace/members/{developer}/drafts/plan-{topic}.md
 2. If the user wants to proceed with the MVP, also generate
-   PRD + prototype (per /wl-prd Step 6, platform template applies)
+   PRD + prototype (per /wl-prd Step 6, platform template applies)
+   **PRD 第一行必须是 `<!-- mode: planning -->`** (syncgate/eval_prd 靠此识别模式).

package/templates/qoder/agents/prd-quick.md

@@ -36,6 +36,7 @@ python .qoder/scripts/context_pack.py <关键词> --platform <web|app>
 
 ## Mini-PRD 极简格式
 ```markdown
+<!-- mode: quick -->
 # Mini-PRD: {标题}
 
 REQ-ID: {分配的ID}

package/templates/qoder/agents/prd-reference.md

@@ -28,6 +28,8 @@ Generate PRD + prototype by referencing existing project data.
    genuinely ambiguous points.
 6. After confirmation, generate:
    a. PRD (product-type template + 10-point quality check)
+      **PRD 第一行必须是 `<!-- mode: reference -->`** (从模板继承, 别删/改).
+      syncgate/eval_prd 靠这个标记识别模式; 缺失会按 full 模板检查 (此处正确).
    b. Interactive HTML prototype from the platform template
       (.qoder/templates/prototype-web.html or prototype-app.html;
       Both -> two files with -web/-app suffix)

package/templates/qoder/agents/prd-research.md

@@ -24,6 +24,7 @@ Your specific perspective is defined in the dispatch prompt.
 
 Note: your report is an intermediate artifact - the caller merges all
 agent reports into the PRD and then deletes brainstorm-agent*.md files.
+合并生成的最终 PRD 第一行必须是 `<!-- mode: brainstorm -->` (syncgate/eval_prd 靠此识别模式).
 
 ## Output Format
 # Brainstorm Report: {perspective}

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

@@ -81,16 +81,27 @@ Discuss 结束、用户说"出PRD"时，AI 必须输出：
 ```
 然后按 Reference 模式流程生成。
 
-### Quick 模式的特殊处理
+### 全模式标记规则（生成 PRD 时必须遵守）
 
-Quick 模式生成的 PRD **头部必须标注 `mode: quick`**：
+**每种模式生成的 PRD，第一行必须是 `<!-- mode: <模式名> -->` 标记**：
 ```markdown
-<!-- mode: quick -->
-# Mini-PRD: {标题}
+<!-- mode: reference -->   (或 brainstorm / planning / quick)
+# 标题...
 ```
-syncgate 的 EVA 门禁检查到 `mode: quick` 时**跳过 A3（字段引用检查）**，
-因为 Mini-PRD 格式精简，A3 的表格字段检查不适用。
-其他检查（平台/REQ-ID/秘密）仍然生效。
+
+各模式标记值与 EVA 门禁行为：
+
+| 模式 | mode 标记 | EVA 处理 | 说明 |
+|------|----------|---------|------|
+| Reference | `<!-- mode: reference -->` | 全跑 (A1+A3) | 默认完整 PRD |
+| Brainstorm | `<!-- mode: brainstorm -->` | 全跑 | 创新方案 PRD |
+| Planning | `<!-- mode: planning -->` | 全跑 | 规划路线图 PRD |
+| Quick | `<!-- mode: quick -->` | **跳过 EVA** | Mini-PRD 精简, A3 字段检查不适用 |
+| Discuss | （不出文件, 无标记） | — | 纯讨论 |
+
+> 标记从模板继承（模板已有正确默认值）。生成时**只改 mode 值，别删标记**。
+> syncgate 和 eval_prd 都靠这个标记识别模式；缺失标记会按 full 模板检查（对 Quick 会误杀）。
+> 向后兼容：旧 PRD 无标记时，eval_prd 回退到内容识别（看 Mini-PRD/零星需求字样）。
 
 ### Brainstorm 中间文件清理
 
@@ -108,10 +119,22 @@ For simple requirements you may run the mode workflow inline instead of
 dispatching — the steps are the same.
 
 ### 模式不确定时的兜底（必须遵守）
-- 若用户意图跟 ≥2 个模式都沾边（如既像"分析"又像"规划"）→ **先问用户**：
-  "这个需求我理解为 [X 模式]，对吗？还是你想要 [Y/Z]？"
-- 默认走 Reference 仅当用户明确给出需求描述且无探讨/创新/规划信号时。
-- **宁可多问一句，不要错模式**（错模式的 PRD 是废纸，EVA 门禁只管格式不管方向）。
+
+**推断流程（每次必走）**：
+1. AI 根据用户关键词推断出一个候选模式
+2. **置信度自检**：问自己"这个需求是否可能属于另一个模式？"
+   - 若可能（≥2 模式沾边，如既像"分析"又像"规划"）→ **必须问用户**
+   - 若无明显歧义 → 直接用候选模式
+3. 默认走 Reference 仅当用户明确给出需求描述且无探讨/创新/规划信号时
+
+**歧义确认话术（统一问法，降低不一致）**：
+```
+这个需求我理解为 [X 模式]（会：[X 的产出]）。
+也可以走 [Y 模式]（会：[Y 的产出]）。
+你要哪种？
+```
+
+**铁律**：宁可多问一句，不要错模式。错模式的 PRD 是废纸——EVA 门禁只管格式不管方向，格式过了的废 PRD 照样能发布。
 
 ## Storage
 

package/templates/qoder/config.yaml

@@ -35,6 +35,14 @@ platforms:
     ui_stack: "Vant 3"
     prototype_template: .qoder/templates/prototype-app.html
 
+# ── 团队协作仓库 (workspace/ 产出 push 到这里) ──
+# 这是团队共享 PRD/任务/原型的仓库, 跟 data/code/ 的源码仓库不同。
+# setup.py init 时会交互式配置 git remote add origin <url>。
+# 不配也能本地工作, 但 push/同步功能不可用。
+team_remote:
+  url: ""  # 留空则 setup.py 会问; 填了团队所有人 init 时自动用这个地址
+  branch: master  # 团队主分支
+
 # ── Git Sync (Weekly) ──
 # 每个项目在 data/code/ 下有自己的 git 仓库
 # 运行: python .qoder/scripts/git_sync.py

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

@@ -15,6 +15,31 @@ BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)
 _CACHE = {}
 
 
+def _append_hook_error(log_path, line):
+    """写一行错误到 hook-errors.log, 超 100KB 截断保留最后 50KB (防无限膨胀)。
+
+    best-effort: 任何 IO 失败都静默 (不能让日志写入失败导致 hook 二次崩溃)。
+    """
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(log_path), exist_ok=True)
+        # 轮转: 文件过大则截断
+        if os.path.isfile(log_path):
+            try:
+                if os.path.getsize(log_path) > 100 * 1024:
+                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                        tail = f.read()[-50 * 1024:]
+                    with open(log_path, 'w', encoding='utf-8') as f:
+                        f.write(tail)
+            except OSError:
+                pass
+        with open(log_path, 'a', encoding='utf-8') as f:
+            f.write('[{}] inject-workflow-state: {}\n'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200]))
+    except Exception:
+        pass
+
+
 def _read_developer():
     """读当前开发者名 (容错: UTF-8/GBK)."""
     df = os.path.join(BASE, '.qoder', '.developer')
@@ -106,7 +131,10 @@ def main():
         if os.path.isfile(state_file):
             last_sig = open(state_file, 'r', encoding='utf-8').read().strip()
             if last_sig == current_sig:
-                return  # 状态没变, 不重复注入 (省 token)
+                # 状态没变, 不重复注入 (省 token), 但仍输出健康标记
+                # QoderWork 看不到任何输出时分不清"缓存跳过"还是"hook 没跑"
+                print('<!-- [hook-ok] inject-workflow-state: state unchanged (cached) -->')
+                return
         open(state_file, 'w', encoding='utf-8').write(current_sig)
     except OSError:
         pass
@@ -119,6 +147,8 @@ def main():
     parts.append('Status: ' + str(st))
     parts.append('Do: ' + g)
     parts.append('</qoder-workflow>')
+    # Hook-1: 健康标记 — 与 session-start 一致, QoderWork 看不到说明 hook 没生效
+    parts.append('<!-- [hook-ok] inject-workflow-state hook ran -->')
     print(NL.join(parts))
 
 
@@ -129,12 +159,8 @@ if __name__ == '__main__':
         # 落盘到日志 (stdout 一次性, 追溯用)
         try:
             from pathlib import Path
-            from datetime import datetime
-            log_path = Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log'
-            log_path.parent.mkdir(parents=True, exist_ok=True)
-            with open(log_path, 'a', encoding='utf-8') as f:
-                f.write('[{}] inject-workflow-state: {}\n'.format(
-                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
+            log_path = str(Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log')
+            _append_hook_error(log_path, str(e)[:200])
         except Exception:
             pass
         print('<qoder-workflow>')

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

@@ -10,6 +10,58 @@ if sys.platform == 'win32':
 NL = chr(10)
 BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 
+HOOK_ERRORS_LOG = os.path.join(BASE, '.qoder', '.runtime', 'hook-errors.log')
+
+
+def _append_hook_error(log_path, line):
+    """写一行错误到 hook-errors.log, 超 100KB 截断保留最后 50KB (防无限膨胀)。best-effort。"""
+    from datetime import datetime
+    try:
+        os.makedirs(os.path.dirname(log_path), exist_ok=True)
+        if os.path.isfile(log_path):
+            try:
+                if os.path.getsize(log_path) > 100 * 1024:
+                    with open(log_path, 'r', encoding='utf-8', errors='replace') as f:
+                        tail = f.read()[-50 * 1024:]
+                    with open(log_path, 'w', encoding='utf-8') as f:
+                        f.write(tail)
+            except OSError:
+                pass
+        with open(log_path, 'a', encoding='utf-8') as f:
+            f.write('[{}] session-start: {}\n'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200]))
+    except Exception:
+        pass
+
+
+def _recent_hook_errors(hours=24, limit=3):
+    """读最近 N 小时的 hook 错误, 返回最多 limit 条 (供会话注入告警)。
+
+    错误之前只落盘到 .runtime/hook-errors.log, PM 永远看不到 → hook 坏了无感知。
+    改后每次开会话把最近错误摘要注入上下文。
+    """
+    try:
+        from datetime import datetime, timedelta
+        if not os.path.isfile(HOOK_ERRORS_LOG):
+            return []
+        cutoff = datetime.now() - timedelta(hours=hours)
+        recent = []
+        with open(HOOK_ERRORS_LOG, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                line = line.strip()
+                if not line or '[' not in line or ']' not in line:
+                    continue
+                try:
+                    ts = line.split(']')[0].lstrip('[')
+                    dt = datetime.strptime(ts, '%Y-%m-%d %H:%M:%S')
+                    if dt >= cutoff:
+                        recent.append(line)
+                except (ValueError, IndexError):
+                    continue
+        return recent[-limit:] if recent else []
+    except Exception:
+        return []
+
 # Injected as REAL OUTPUT below (a comment here would never reach the AI)
 CRITICAL_RULE = NL.join([
     '## CRITICAL RULE',
@@ -174,6 +226,14 @@ def get_style_info():
 def main():
     parts = []
     parts.append('<qoder-context>')
+    # Hook-3: 上次会话以来的 hook 错误告警 (不只落盘, 要让用户/AI 看到)
+    # hook 坏了会导致上下文注入失败 (任务状态/平台规则缺失), 必须可见
+    recent_errors = _recent_hook_errors(hours=24, limit=3)
+    if recent_errors:
+        parts.append('⚠️ [HOOK-WARN] 过去 24h 有 hook 错误 (上下文注入可能失效):')
+        for err in recent_errors:
+            parts.append('  ' + err)
+        parts.append('  详情见 .qoder/.runtime/hook-errors.log; 检查 Python 环境或跑 init_doctor --fix')
     dev = get_developer()
     if dev:
         name = dev.get('name', 'unknown')
@@ -216,17 +276,8 @@ if __name__ == '__main__':
         main()
     except Exception as e:
         # A broken hook must never kill the session - emit minimal context
-        # 同时落盘到日志, 方便后续排查 (stdout 一次性, AI 看完就没了)
-        try:
-            from pathlib import Path
-            log_path = Path(__file__).resolve().parents[1] / '.runtime' / 'hook-errors.log'
-            log_path.parent.mkdir(parents=True, exist_ok=True)
-            from datetime import datetime
-            with open(log_path, 'a', encoding='utf-8') as f:
-                f.write('[{}] session-start: {}\n'.format(
-                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
-        except Exception:
-            pass  # 日志写失败不影响降级
+        # 同时落盘到日志 (带轮转), 方便下次会话告警
+        _append_hook_error(HOOK_ERRORS_LOG, str(e)[:200])
         print('<qoder-context>')
         print('session-start hook error: ' + str(e)[:200])
         print('  (详情见 .qoder/.runtime/hook-errors.log)')

package/templates/qoder/scripts/common/developer.py

@@ -73,9 +73,11 @@ def _detect_git_author() -> str | None:
 
 
 def _ensure_git_config(name: str, repo_root: Path) -> None:
-    """确保 git user.name/email 已配置。未配则用 --local 设为 init 的名字。
+    """确认 git user.name/email 已配置。未配则提示 (绝不自动造假账号)。
 
-    检测顺序: 全局 > local。都没有就提示用户。
+    旧逻辑会塞 name@local 假账号, 与零信任 push 门禁冲突, 已废弃。
+    真正的 git 配置由 setup.py configure_git_identity() 在 init 前完成。
+    这里只做兜底检测: 如果走到这还没配, 提示用户去配。
     """
     import subprocess
     # 先看 git 是否可用
@@ -87,23 +89,20 @@ def _ensure_git_config(name: str, repo_root: Path) -> None:
 
     author = _detect_git_author()
     if author:
-        print(f"  [OK] git 作者: {author}")
+        # 检测到疑似假账号也要提示 (虽然配了, 但 push 会被门禁拒)
+        if "@local" in author:
+            print(f"  [WARN] git 作者疑似假账号: {author} (push 门禁会拒绝)")
+            print(f"       请重跑 'wlkj init' 配置真实团队 git 账号")
+        else:
+            print(f"  [OK] git 作者: {author}")
         return
 
-    # git 未配 user.name/email: 用 init 名字设 local config (不影响全局)
-    print(f"  [设置] git 未配置 user.name/email, 用你的名字设为 local:")
-    fake_email = f"{name}@local"
-    try:
-        subprocess.run(["git", "config", "--local", "user.name", name],
-                       cwd=str(repo_root), capture_output=True, timeout=5)
-        subprocess.run(["git", "config", "--local", "user.email", fake_email],
-                       cwd=str(repo_root), capture_output=True, timeout=5)
-        print(f"    user.name = {name}")
-        print(f"    user.email = {fake_email}")
-        print(f"    (仅本仓库生效。如有团队 git 账号, 自行改: git config --local user.email 你的邮箱)")
-    except (FileNotFoundError, OSError, subprocess.SubprocessError) as e:
-        print(f"  [WARN] 设置 git config 失败 (不阻塞): {e}")
-        print(f"    请手动跑: git config user.name {name} && git config user.email 你的邮箱")
+    # git 未配: 不造假, 只提示
+    print(f"  [WARN] git 未配置 user.name/email")
+    print(f"       push/commit 会失败。请配置团队 git 账号:")
+    print(f"       git config --global user.name '你的名字'")
+    print(f"       git config --global user.email '你的团队邮箱'")
+    print(f"       或重跑: wlkj init <你的名字>")
 
 
 def init_developer(name: str, role: str | None = None,
@@ -173,7 +172,15 @@ def init_developer(name: str, role: str | None = None,
     #    这是 push 门禁的前提: 没 member.json → syncgate 拒绝 push
     git_author = _detect_git_author()
     try:
-        from common.identity import register_member, IdentityError
+        from common.identity import register_member, IdentityError, get_member
+        # 修正: 旧 member.json 若是假账号(@local), 且现在 git 配了真账号 → 用真账号覆盖
+        # register_member 已有"已注册则只更新 git_author, 密钥不动"的逻辑, 这里只加提示
+        existing_member = get_member(name, repo_root)
+        if existing_member:
+            old_author = existing_member.get("git_author", "")
+            if (old_author and "@local" in old_author
+                    and git_author and "@local" not in git_author):
+                print(f"  [修正] member.json git_author 从假账号更新为真账号: {git_author}")
         try:
             register_member(name, role or "pm", git_author, repo_root)
             print(f"  [OK] 身份注册: member.json + 签名密钥已生成")
@@ -182,7 +189,7 @@ def init_developer(name: str, role: str | None = None,
     except ImportError:
         pass  # identity 模块不可用, 跳过 (向后兼容)
 
-    # 5. 确保 git 配置 (检测 + 自动设 local)
+    # 5. 确保 git 配置 (只检测+提示, 不造假; 真账号由 setup.py 在 init 前配好)
     _ensure_git_config(name, repo_root)
 
     print(f"Developer initialized: {name}" + (f" ({role})" if role else ""))

package/templates/qoder/scripts/common/identity.py

@@ -185,7 +185,12 @@ def register_member(
         "name": name,
         "member_id": member_id,
         "role": role,
-        "git_author": git_author or existing.get("git_author") or "%s <unknown@local>" % name,
+        # existing 可能为 None (全新安装, member.json 尚不存在), 判空防 NPE
+        "git_author": (
+            git_author
+            or (existing.get("git_author") if existing else None)
+            or "%s <unknown@local>" % name
+        ),
         "joined_at": joined_at,
     }
     atomic_write_json(mj, record)

package/templates/qoder/scripts/eval_prd.py

@@ -162,8 +162,14 @@ def score_style(html_text):
 # ============================================================
 
 def score_template(prd_text):
-    is_quick = ('Mini-PRD' in prd_text or '零星需求' in prd_text
-                or len(prd_text) < 3000)
+    # 优先看 mode 标记 (HTML 注释, 头部 2KB 内); 无标记回退到内容自识别 (旧 PRD 兼容)
+    # 注意: 去掉了旧的 len<3000 启发式 —— 它会把短的 full PRD 误判为 quick
+    _m = re.search(r'<!--\s*mode:\s*(\w+)\s*-->', prd_text[:2048], re.IGNORECASE)
+    if _m:
+        is_quick = _m.group(1).lower() == 'quick'
+    else:
+        _low = prd_text.lower()
+        is_quick = ('mini-prd' in _low or '零星需求' in prd_text)
     sections = QUICK_SECTIONS if is_quick else FULL_SECTIONS
     kind = '零星模板' if is_quick else '完整模板'
     missing = [s for s in sections if s not in prd_text]

package/templates/qoder/scripts/init_doctor.py

@@ -133,7 +133,7 @@ def check_developer(fix, name=None, role=None):
     current = get_developer()
     if not current and not name:
         say(WARN, '未设置开发者身份, 也探测不到 git user.name')
-        print('       -> 建议: python .qoder/scripts/setup.py <你的名字>')
+        print('       -> 建议: wlkj init <你的名字>')
         return None
     if name and (not current or current != name):
         if fix:
@@ -159,6 +159,19 @@ def check_developer(fix, name=None, role=None):
                 actions.append('补建个人空间子目录: ' + ', '.join(missing))
             else:
                 problem('个人空间缺少子目录: ' + ', '.join(missing), '加 --fix 自动补建')
+        # member.json 假账号检测 (旧版 init 可能塞了 @local 假账号, push 门禁会拒绝)
+        import json as _json_mj
+        mj_path = os.path.join(BASE, 'workspace', 'members', current, 'member.json')
+        if os.path.isfile(mj_path):
+            try:
+                with open(mj_path, encoding='utf-8') as _f:
+                    _mdata = _json_mj.load(_f)
+                _ga = _mdata.get('git_author', '')
+                if _ga and '@local' in _ga:
+                    say(WARN, 'member.json 的 git_author 是假账号: {} (push 门禁会拒绝)'.format(_ga))
+                    print('       -> 建议重跑 \'wlkj init\' 配置真实团队 git 账号, 会自动修正 member.json')
+            except Exception:
+                pass
         # git author 一致性 (影响 /wl-report 统计 + 零信任 push 门禁)
         # git 未安装时跳过此项
         git_name = ''

package/templates/qoder/scripts/setup.py

@@ -96,7 +96,7 @@ def check_env():
             ok('git 已自动安装')
         else:
             warn('git 未安装 — 团队同步/源码克隆将禁用, 本地 PRD/搜索/任务/报告仍可用')
-            print('       (想启用团队协作: 安装 git 后重跑 setup.py)')
+            print('       (想启用团队协作: 安装 git 后重跑 \'wlkj init\')')
         return True  # 不阻塞, 继续
     ok('git 可用')
     return True
@@ -275,7 +275,189 @@ def guide_config():
         warn('config.yaml 的 git_sync.projects 未填真实 URL')
         print('       打开 .qoder/config.yaml, 找到 git_sync.projects 段,')
         print('       把 url 改成你团队的 git 地址。或手动把代码放到 data/code/。')
-        print('       填完后重跑 setup.py 即可自动克隆+建索引。')
+        print('       填完后重跑 \'wlkj init\' 即可自动克隆+建索引。')
+
+
+# ============================================================
+# Step 2.5: Git 身份配置 (在 init_doctor 之前, 确保下游探测到真账号)
+# ============================================================
+
+def configure_git_identity(name):
+    """配置 git user.name/email。未配或疑似假账号时交互式问用户。
+
+    设计: 绝不自动造假账号。git 没配 → 问用户要真账号; 配了但像假的(@local) → 确认。
+    这样下游 init_developer 探测到的就是真账号, member.json 不会写假 git_author。
+    """
+    print('\n--- Git 身份配置 ---')
+
+    # 1. git 是否可用
+    try:
+        subprocess.run(['git', '--version'], capture_output=True, timeout=5)
+    except (FileNotFoundError, OSError):
+        warn('git 未安装, 跳过 (push/commit 不可用, 但能本地工作)')
+        return False
+
+    # 2. 探测现有 git config (全局 + local 合并视图)
+    existing_name = run(['git', 'config', 'user.name']).stdout.strip()
+    existing_email = run(['git', 'config', 'user.email']).stdout.strip()
+
+    # 3. 判断是否需要配置
+    needs_config = False
+    if not existing_name or not existing_email:
+        needs_config = True
+        warn('git 未配置 user.name/user.email (团队协作必须)')
+    elif '@local' in existing_email:
+        needs_config = True
+        warn(f'检测到疑似假账号: {existing_name} <{existing_email}>')
+        print('       (可能是旧版 init 自动填的, 需要换成你的团队 git 账号)')
+
+    if not needs_config:
+        # 已有真配置, 确认是否用这个
+        if ask(f'用这个 git 账号? {existing_name} <{existing_email}>', 'y'):
+            ok(f'git 账号: {existing_name} <{existing_email}>')
+            return True
+        needs_config = True  # 用户不想用, 重新配
+
+    # 4. 非交互环境: 不能问, 给明确指引后返回 (绝不造假)
+    if not sys.stdin.isatty():
+        warn('非交互环境, 无法询问 git 账号。请手动配置后重跑 \'wlkj init\':')
+        print('       git config --global user.name "你的名字"')
+        print('       git config --global user.email "你的团队邮箱"')
+        return False
+
+    # 5. 交互式收集 git 账号
+    print('\n  配置你的团队 git 账号 (用于提交代码和团队协作):')
+    while True:
+        try:
+            git_name = input(f'  git 用户名 [{existing_name or name}]: ').strip() or existing_name or name
+            git_email = input('  git 邮箱 (团队邮箱): ').strip()
+            if not git_email or '@' not in git_email:
+                print('  邮箱格式不对 (需含 @), 重试。')
+                continue
+            if '@local' in git_email:
+                if not ask('邮箱含 @local, 这通常不是团队邮箱, 确定用这个?', 'n'):
+                    continue
+            break
+        except (EOFError, KeyboardInterrupt):
+            warn('未输入, 跳过 git 配置 (push 会失败, 手动配: git config user.name/user.email)')
+            return False
+
+    # 6. 写入 git config (默认 --global, 用户通常只有一个 git 身份)
+    use_global = ask('设为全局配置 (所有项目通用)? [Y] 还是只本仓库? [n]', 'y')
+    scope = '--global' if use_global else '--local'
+
+    r1 = run(['git', 'config', scope, 'user.name', git_name], cwd=str(BASE))
+    r2 = run(['git', 'config', scope, 'user.email', git_email], cwd=str(BASE))
+    if r1.returncode == 0 and r2.returncode == 0:
+        ok(f'git {scope.replace("--", "")} 配置: {git_name} <{git_email}>')
+        return True
+    warn('git config 设置失败: ' + (r1.stderr or r2.stderr or '').strip()[:100])
+    return False
+
+
+def _read_team_remote_from_config():
+    """从 .qoder/config.yaml 读 team_remote.url (没有返回 None)。"""
+    cfg = BASE / '.qoder' / 'config.yaml'
+    if not cfg.is_file():
+        return None
+    try:
+        content = cfg.read_text(encoding='utf-8')
+    except Exception:
+        return None
+    in_team = False
+    for line in content.splitlines():
+        s = line.strip()
+        if s.startswith('team_remote:'):
+            in_team = True
+            continue
+        if in_team:
+            if s and not s.startswith('#') and not line[0].isspace():
+                break  # 离开 team_remote 段
+            if s.startswith('url:'):
+                url = s.split(':', 1)[1].strip().strip('\'"')
+                if url:
+                    return url
+    return None
+
+
+def _write_team_remote_to_config(url):
+    """把 team_remote.url 写进 config.yaml (best-effort, 不阻塞)。"""
+    cfg = BASE / '.qoder' / 'config.yaml'
+    if not cfg.is_file():
+        return
+    try:
+        content = cfg.read_text(encoding='utf-8')
+        if 'team_remote:' in content:
+            return  # 已有段, 不重复写
+        # 在 git_sync 段之前插入
+        marker = '# ── Git Sync'
+        block = (
+            '# ── 团队协作仓库 (workspace/ 产出 push 到这里) ──\n'
+            '# 团队共享 PRD/任务/原型的仓库, 跟 data/code/ 源码仓库不同。\n'
+            'team_remote:\n'
+            '  url: "%s"  # 团队所有人 init 时自动用这个地址\n'
+            '  branch: master\n\n' % url
+        )
+        if marker in content:
+            content = content.replace(marker, block + marker, 1)
+        else:
+            content = block + content
+        cfg.write_text(content, encoding='utf-8')
+    except Exception:
+        pass
+
+
+def configure_team_remote():
+    """配置团队协作仓库的 git remote (workspace/ 产出往这里 push)。
+
+    当前问题: 完全没人配 remote, 用户不知道往哪 push。
+    检测 origin 是否存在, 不存在则问用户要团队仓库地址。
+    """
+    print('\n--- 团队协作仓库 ---')
+
+    # 1. 是否已是 git 仓库
+    if not (BASE / '.git').is_dir():
+        return  # cli.js doInit 已做 git init, 这里兜底
+
+    # 2. 检测是否已有 origin
+    r = run(['git', 'remote'], cwd=str(BASE))
+    remotes = r.stdout.split() if r.returncode == 0 else []
+    if 'origin' in remotes:
+        url_r = run(['git', 'remote', 'get-url', 'origin'], cwd=str(BASE))
+        url = url_r.stdout.strip() if url_r.returncode == 0 else '?'
+        ok(f'团队仓库已配置: origin -> {url}')
+        return
+
+    # 3. 没有 origin — 从 config.yaml 读 team_remote (如果有)
+    team_url = _read_team_remote_from_config()
+    if team_url:
+        if ask(f'用 config.yaml 里的团队仓库地址? {team_url}', 'y'):
+            r = run(['git', 'remote', 'add', 'origin', team_url], cwd=str(BASE))
+            if r.returncode == 0:
+                ok(f'团队仓库已配置: origin -> {team_url}')
+            else:
+                warn('remote add 失败: ' + (r.stderr or '').strip()[:100])
+            return
+
+    # 4. 交互式问用户要团队仓库地址
+    if not sys.stdin.isatty():
+        warn('未配置团队仓库 origin, push 会失败。手动配: git remote add origin <团队仓库URL>')
+        return
+
+    print('\n  配置团队协作仓库 (你的 PRD/任务/产出 push 到这里, 团队共享):')
+    try:
+        url = input('  团队仓库地址 (留空跳过, 之后可配): ').strip()
+    except (EOFError, KeyboardInterrupt):
+        url = ''
+    if not url:
+        warn('跳过团队仓库配置。之后可手动配: git remote add origin <URL>')
+        return
+    r = run(['git', 'remote', 'add', 'origin', url], cwd=str(BASE))
+    if r.returncode == 0:
+        ok(f'团队仓库已配置: origin -> {url}')
+        _write_team_remote_to_config(url)  # 顺手写 config 供团队复用
+    else:
+        warn('remote add 失败: ' + (r.stderr or '').strip()[:100])
 
 
 # ============================================================
@@ -430,6 +612,9 @@ def main():
         fail('未能确定开发者名字')
         return 1
 
+    # Step 1.5: Git 身份配置 (在 init_doctor 之前, 确保下游探测到真账号而非假账号)
+    configure_git_identity(name)
+
     # Step 2
     if not run_doctor(name, args.role):
         warn('init_doctor 未完全成功, 继续 setup 后续步骤...')
@@ -437,6 +622,9 @@ def main():
     # Step 3
     guide_config()
 
+    # Step 3.5: 团队协作仓库 remote (workspace/ 产出 push 到这里)
+    configure_team_remote()
+
     # Step 4
     offer_cron(skip=args.skip_cron)
 

package/templates/qoder/scripts/syncgate.py

@@ -280,8 +280,9 @@ def check_eval_gate(
         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
+            head_lower = head.lower()
+            if 'mode: quick' in head_lower or 'mini-prd' in head_lower or '零星需求' in head:
+                continue  # Quick 模式, 跳过 EVA (mode 标记优先, 兼容旧 Mini-PRD 字样)
         except OSError:
             pass
         # 找同名原型 (可选)

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

@@ -88,10 +88,13 @@ python .qoder/scripts/context_pack.py <关键词> --platform <web|app>
 
 ## PRD 模板
 
-| 模式 | 模板 |
-|------|------|
-| Reference/Brainstorm/Planning | `.qoder/templates/prd-full-template.md` |
-| Quick | `.qoder/templates/prd-quick-template.md` |
+| 模式 | 模板 | mode 标记 |
+|------|------|----------|
+| Reference/Brainstorm/Planning | `.qoder/templates/prd-full-template.md` | `<!-- mode: reference/brainstorm/planning -->` |
+| Quick | `.qoder/templates/prd-quick-template.md` | `<!-- mode: quick -->` |
+
+> 模板头部已含 mode 标记。生成 PRD 时**只改 mode 值，别删标记**——
+> syncgate/eval_prd 靠它识别模式（Quick 跳过 EVA，其他全跑）。
 
 ## 质量自检（10 项，Quick 跳过）
 1. 背景回答"为什么" 2. 目标可量化 3. 用户画像具体

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

@@ -49,6 +49,9 @@ trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-
 
 > **深度模式** = 先做现状+Gap+多角度分析，再出 PRD。适合大需求/新领域/想创新。
 > **探讨模式** = 聊完说"出PRD"→ 自动转默认生成。
+>
+> **mode 标记**：生成的 PRD 第一行写 `<!-- mode: quick/brainstorm/planning/reference -->`，
+> syncgate/eval_prd 靠它识别模式（Quick 跳过 EVA）。模板已带默认值，只改值别删。
 
 ## 完整流程（默认/深度/快速 模式）
 

package/templates/qoder/templates/prd-full-template.md

@@ -7,6 +7,8 @@
 
 ---
 
+<!-- mode: reference -->
+<!-- 生成时按实际模式替换上面的值: reference / brainstorm / planning -->
 # REQ-{YYYY}-{NNN} {需求标题}
 
 ## 前言

package/templates/qoder/templates/prd-quick-template.md

@@ -6,6 +6,7 @@
 
 ---
 
+<!-- mode: quick -->
 # {功能模块} - {改动摘要}
 
 > 标题让读者一眼知道改了什么，避免"XX功能修改"这类模糊表述。