@hupan56/wlkj 3.3.12 → 3.3.14

package/templates/qoder/hooks/stop-eval.py

@@ -1,383 +1,254 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""stop-eval.py - Stop hook: Agent 说"完成"时强制 eval 门禁 (治"说做完了没真评测")
-
-吸收宿主确定性 hook 能力: 把 EVA 门禁 (PRD 发布前 eval≥80%) 从"靠 AI 自觉跑"
-升级为"Agent 准备结束回复时宿主拦住"。AI 说"PRD 做完了"但没跑 eval → 被拦回继续。
-
-阻断契约: exit 0 放行; exit 2 阻断(stderr 反馈, 强制 Agent 续修)。
-
-防递归 (关键!): Stop hook 被 exit 2 阻断后, Agent 续修完再次 Stop 会再次触发本 hook →
-死循环。必须检查 stdin 的 stop_hook_active: 为 true 时直接 exit 0 放行 (Agent 已在本轮
-被拦过一次, 不再二次拦)。
-
-判断逻辑 (保守, 只拦明确场景):
-  - 本会话最近产出过 PRD 文件 (扫描 workspace/members/*/drafts + tasks/*/prd.md,
-    找近 10 分钟内 mtime 的 prd*.md)
-  - 且该 PRD 没有对应的 eval 记录 (eval-history.jsonl 里查不到该 prd 名)
-  → exit 2 强制 eval
-  其它情况一律 exit 0 (绝不误拦普通对话/非 PRD 工作)。
-
-stdin 字段名官方未公开, 兼容 stop_hook_active / hook_active 等多种写法。
-"""
-import json
-import os
-import sys
-import time
-from datetime import datetime
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-        sys.stderr.reconfigure(encoding='utf-8')
-    except Exception:
-        pass
-
-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')
-EVAL_HISTORY = os.path.join(BASE, 'data', 'learning', 'eval-history.jsonl')
-RECENT_WINDOW = 600  # 10 分钟内产出的 PRD 视为本轮产物
-
-
-def _is_reentry(stdin_data):
-    """是否二次进入 (防递归)。兼容多字段名。"""
-    if not isinstance(stdin_data, dict):
-        return False
-    for k in ('stop_hook_active', 'hook_active', 'is_reentry'):
-        v = stdin_data.get(k)
-        if v in (True, 'true', 'True', 1, '1'):
-            return True
-    return False
-
-
-def _read_stdin():
-    try:
-        if sys.stdin.isatty():
-            return {}
-        raw = sys.stdin.read().strip()
-        if not raw:
-            return {}
-        return json.loads(raw)
-    except Exception:
-        return {}
-
-
-def _is_prd_filename(fn):
-    """判断文件名是否是 PRD 产物。
-
-    真实 PRD 有两类命名 (与 eval-history.jsonl 记录的 'prd' 字段对齐):
-      1. workspace/tasks/<task>/prd.md              (任务级 PRD, 文件名含 prd)
-      2. workspace/members/<dev>/drafts/REQ-2026-XXX-<feature>.md
-         (AI 产出的 PRD 草稿, 命名 REQ-<id>-<feature>.md, 不含 'prd' 字样)
-    只匹配 'prd' 会漏掉第 2 类 (绝大多数真实产出) → 门禁形同虚设。
-    这里两类都认: 文件名含 'prd' 或 以 'REQ-' 开头 (eval-history 的真实记录格式)。
-    """
-    low = fn.lower()
-    if not low.endswith('.md'):
-        return False
-    return 'prd' in low or low.startswith('req-')
-
-
-def _recent_prd_files():
-    """找近 RECENT_WINDOW 秒内产出的 PRD 文件 (绝对路径)。扫描 drafts + tasks。"""
-    now = time.time()
-    candidates = []
-    search_roots = [
-        os.path.join(BASE, 'workspace', 'members'),
-        os.path.join(BASE, 'workspace', 'tasks'),
-        os.path.join(BASE, 'data', 'docs', 'prd'),
-    ]
-    for root in search_roots:
-        if not os.path.isdir(root):
-            continue
-        for dirpath, dirs, files in os.walk(root):
-            # 跳过无关大目录
-            dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', '__pycache__', '.secrets')]
-            for fn in files:
-                if not _is_prd_filename(fn):
-                    continue
-                fp = os.path.join(dirpath, fn)
-                try:
-                    if now - os.path.getmtime(fp) <= RECENT_WINDOW:
-                        candidates.append(fp)
-                except OSError:
-                    continue
-    return candidates
-
-
-# 快速模式 6 章必需标题 (与 prd-quick-template.md 对齐)
-QUICK_REQUIRED_SECTIONS = [
-    '功能入口', '需求背景', '需求说明', '影响范围', '验收标准', '不在本次范围',
-]
-
-
-def _check_quick_prd_complete(prd_path):
-    """检测 quick 模式 PRD 是否缺章。返回缺失章节列表 (空=完整)。
-
-    判定 quick 模式: @contract 头含 mode: quick。
-    必需 6 章: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。
-    治"残废品" (真实案例: 海外考勤 PRD 只写"功能入口"一段, 6 章缺 5 章)。
-    """
-    try:
-        text = open(prd_path, encoding='utf-8', errors='replace').read()
-    except Exception:
-        return []  # 读不到不拦 (误拦比放过更糟)
-    # 只检 quick 模式 (完整档 13 章另算, 不在此 hook 范围)
-    if 'mode: quick' not in text[:500]:
-        return []
-    missing = []
-    for sec in QUICK_REQUIRED_SECTIONS:
-        # 章节标题: ## 功能入口 / ## 需求背景 等 (允许前后空格)
-        import re
-        if not re.search(r'^#{1,3}\s*' + sec, text, re.MULTILINE):
-            missing.append(sec)
-    return missing
-
-
-def _evald_prds():
-    """读 eval-history.jsonl, 返回【已通过门禁】的 prd 文件名集合。
-
-    门禁定义 (与消息承诺一致): 该 PRD 最近一次 eval 记录 passed=True 或 score_pct>=80。
-    只"跑过 eval 但没过线"的不算通过 → 仍需拦回去重测。
-    eval-history.jsonl 是 append-only, 同一 PRD 可能有多条 → 取最后一条为准。
-    """
-    last = _last_record_by_prd()
-    done = set()
-    for key, r in last.items():
-        passed = r.get('passed')
-        score = r.get('score_pct')
-        is_ok = (passed is True) or (isinstance(score, (int, float)) and score >= 80)
-        if is_ok:
-            done.add(key)
-    return done
-
-
-def _last_record_by_prd():
-    """读 eval-history.jsonl, 返回 {prd_basename: 最后一条记录}。
-
-    append-only 文件, 后出现的记录覆盖前面的 → 取每个 PRD 的最新 eval。
-    被门禁诊断复用 (区分"没跑过 eval" vs "跑了但没过线")。
-    """
-    last_by_prd = {}
-    if not os.path.isfile(EVAL_HISTORY):
-        return last_by_prd
-    try:
-        with open(EVAL_HISTORY, encoding='utf-8', errors='replace') as f:
-            for line in f:
-                line = line.strip()
-                if not line:
-                    continue
-                try:
-                    r = json.loads(line)
-                    p = r.get('prd')
-                    if p:
-                        last_by_prd[os.path.basename(str(p))] = r
-                except Exception:
-                    continue
-    except Exception:
-        pass
-    return last_by_prd
-
-
-def _enforce_code_ac_gate():
-    """P0-3: wl-code spec AC 门禁。找近 spec + eval_code_ac.py 对账, AC<100% 阻断。
-
-    治"代码漏实现 spec AC"（wl-code 自检全打勾反例）。无 spec / 脚本缺失 / 崩溃 → 放行(不阻塞)。
-    """
-    import subprocess
-    qoder_script = os.path.join(BASE, '.qoder', 'scripts', 'validation', 'metrics', 'eval_code_ac.py')
-    pkg_script = os.path.join(BASE, 'packages', 'wlkj', 'templates', 'qoder',
-                              'scripts', 'validation', 'metrics', 'eval_code_ac.py')
-    script = qoder_script if os.path.isfile(qoder_script) else pkg_script
-    if not os.path.isfile(script):
-        return  # 脚本不在, 放行
-    try:
-        r = subprocess.run([sys.executable, script], cwd=BASE,
-                           capture_output=True, text=True, timeout=30)
-    except Exception:
-        return  # 崩溃绝不阻塞
-    if r.returncode != 2:
-        return  # exit 0 = 无 spec / AC 全覆盖, 放行
-    out_lines = [l for l in (r.stdout or '').split('\n') if l.strip()]
-    try:
-        data = json.loads(out_lines[-1]) if out_lines else {}
-    except Exception:
-        data = {}
-    missed = data.get('missed', []) or []
-    rate = data.get('rate', 0)
-    miss_str = '\n'.join('  - ' + str(m)[:80] for m in missed[:5])
-    sys.stderr.write(
-        '【wl-code AC 门禁】检测到 spec 验收标准未被代码覆盖 (覆盖率 %s%%):\n%s\n'
-        '修复: 对照 spec 第6章 PRD 验收标准映射表, 把未实现的 AC 补进代码, 重跑至 100%%。\n'
-        % (int(rate * 100), miss_str))
-    sys.exit(2)
-
-
-def _enforce_cases_lint_gate():
-    """P0-3 w2: wl-test cases 格式门禁。扫近 10min cases 文件(含 intent/action/anchor 键的 json),
-    跑 lint_cases.py，旧格式(action+CSS selector) → exit 2。无 cases/脚本缺/崩溃 → 放行(不阻塞)。"""
-    import subprocess
-    qoder_script = os.path.join(BASE, '.qoder', 'scripts', 'validation', 'metrics', 'lint_cases.py')
-    pkg_script = os.path.join(BASE, 'packages', 'wlkj', 'templates', 'qoder',
-                              'scripts', 'validation', 'metrics', 'lint_cases.py')
-    script = qoder_script if os.path.isfile(qoder_script) else pkg_script
-    if not os.path.isfile(script):
-        return
-    now = time.time()
-    cases_files = []
-    for root in (os.path.join(BASE, 'workspace', 'members'), os.path.join(BASE, 'workspace', 'tasks')):
-        if not os.path.isdir(root):
-            continue
-        for dirpath, dirs, files in os.walk(root):
-            dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', '__pycache__', '.secrets')]
-            for fn in files:
-                if not fn.endswith('.json'):
-                    continue
-                fp = os.path.join(dirpath, fn)
-                try:
-                    if now - os.path.getmtime(fp) > 600:
-                        continue
-                except OSError:
-                    continue
-                try:
-                    head = open(fp, encoding='utf-8', errors='replace').read(2000)
-                except Exception:
-                    continue
-                if '"intent"' in head or '"action"' in head or '"anchor"' in head:
-                    cases_files.append(fp)
-    for fp in cases_files[:5]:
-        try:
-            r = subprocess.run([sys.executable, script, fp, '--json'], cwd=BASE,
-                               capture_output=True, text=True, timeout=15)
-        except Exception:
-            continue
-        if r.returncode != 2:
-            continue
-        out_lines = [l for l in (r.stdout or '').split('\n') if l.strip()]
-        try:
-            data = json.loads(out_lines[-1]) if out_lines else {}
-        except Exception:
-            data = {}
-        blocks = [v for v in (data.get('violations') or []) if v.get('severity') == 'BLOCK']
-        if blocks:
-            detail = '\n'.join('  - case#%s %s' % (v.get('idx'), str(v.get('detail', ''))[:60]) for v in blocks[:5])
-            sys.stderr.write(
-                '【wl-test cases 门禁】%s 检测到旧格式用例(action+CSS selector，新 Playwright 管线不认):\n%s\n'
-                '修复: 改 intent+anchor 格式，anchor={role,name}(来自 recall/snapshot)，凭据用 {{ask:key}}。\n'
-                % (os.path.basename(fp), detail))
-            sys.exit(2)
-
-
-def _enforce_commit_msg_gate():
-    """P0-3 w3: wl-commit msg 门禁。近 30min commit msg 须含 [#REQ-xxx] 或 [#禅道号]。
-
-    治"commit 不关联需求"（F1 闭环数据断）。memory commit-convention-zentao-id:
-    S3 [#REQ-<uuid8>] / S5.1 push 后 [#<禅道号>]。无标记 → exit 2 提示 amend。
-    """
-    import re as _re
-    import subprocess
-    try:
-        r = subprocess.run(['git', 'log', '-1', '--format=%B|||%ct'], cwd=BASE,
-                           capture_output=True, text=True, timeout=10)
-        out = (r.stdout or '').strip()
-    except Exception:
-        return  # 崩溃不阻塞
-    if '|||' not in out:
-        return
-    msg, _, ts_s = out.rpartition('|||')
-    try:
-        ts = int(ts_s)
-    except ValueError:
-        ts = 0
-    if ts and time.time() - ts > 1800:
-        return  # 非本轮 commit
-    if _re.search(r'\[#REQ-[\w-]+\]|\[#\d+\]', msg):
-        return  # 含需求标记, 放行
-    sys.stderr.write(
-        '【wl-commit msg 门禁】最近 commit msg 缺需求关联标记:\n  %s\n'
-        '修复: git commit --amend 补 [#REQ-<uuid>] (S3) 或 [#<禅道号>] (S5.1 push 后)。\n'
-        % msg.replace('\n', ' ')[:120])
-    sys.exit(2)
-
-
-def main():
-    try:
-        data = _read_stdin()
-        # 防递归: 二次进入直接放行
-        if _is_reentry(data):
-            sys.exit(0)
-
-        # ★ P0-3 wl-code spec AC 门禁（代码漏实现 AC 检测, 治自检全打勾）
-        _enforce_code_ac_gate()
-        # P0-3 w2 wl-test cases 格式门禁（旧 action+CSS selector → 拦）
-        _enforce_cases_lint_gate()
-        # w3 wl-commit msg 门禁: 应在 pre-tool-use（git commit 命令前验 msg）而非 stop-eval——
-        # stop-eval 的 git log -1 不分"本轮 wl-commit"vs 其他 commit, 会在平台开发等非 wl-commit
-        # 场景误拦。函数 _enforce_commit_msg_gate 已定义待 pre-tool-use 细化接入。
-
-        # 找近 10 分钟产出的 PRD, 检查是否已【通过】门禁
-        recent = _recent_prd_files()
-        if not recent:
-            sys.exit(0)  # 本轮没产 PRD, 放行
-
-        # ── 先查 quick 模式 PRD 缺章 (残废品门禁, 比 eval 更优先) ──
-        incomplete = []
-        for p in recent:
-            miss = _check_quick_prd_complete(p)
-            if miss:
-                incomplete.append((p, miss))
-        if incomplete:
-            lines = []
-            for p, miss in incomplete[:3]:
-                lines.append('  %s 缺: %s' % (os.path.basename(p), '、'.join(miss)))
-            sys.stderr.write(
-                '【PRD 残废品门禁】检测到快速模式 PRD 缺章 (6 章缺一不可):\n'
-                + '\n'.join(lines) + '\n'
-                '修复: 补齐缺失章节的标题和内容 (不涉及的写一句话说明, 标题必须保留),\n'
-                '      章节顺序: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。\n'
-                '      模板: .qoder/templates/prd-quick-template.md\n')
-            sys.exit(2)
-        evald = _evald_prds()
-        last_records = _last_record_by_prd()
-        # 区分两种未过门禁: 从没跑过 eval / 跑了但没过线
-        not_run = [p for p in recent if os.path.basename(p) not in last_records]
-        failed = [p for p in recent
-                  if os.path.basename(p) in last_records
-                  and os.path.basename(p) not in evald]
-        if not not_run and not failed:
-            sys.exit(0)  # 全部通过门禁, 放行
-
-        # 有未过门禁的近期 PRD → 阻断, 给出可操作指引
-        parts = []
-        if not_run:
-            parts.append('未跑评测: ' + ', '.join(os.path.basename(p) for p in not_run[:3]))
-        if failed:
-            details = []
-            for p in failed[:3]:
-                rec = last_records.get(os.path.basename(p), {})
-                s = rec.get('score_pct')
-                details.append('%s (最近 %s)' % (os.path.basename(p),
-                                                 ('%s%%' % s) if s is not None else '未过'))
-            parts.append('评测未过线: ' + ', '.join(details))
-        sys.stderr.write(
-            '【EVA 门禁】检测到近期产出的 PRD 未通过质量门禁 (要求 eval ≥80%%):\n'
-            '  %s\n'
-            '修复: python .qoder/scripts/orchestration/wlkj.py eval <PRD> [原型]\n'
-            '      针对评测报告的扣分项改 PRD, 重跑 eval 到 ≥80%% 再结束。\n'
-            % '; '.join(parts))
-        sys.exit(2)
-    except SystemExit:
-        raise
-    except Exception as e:
-        try:
-            os.makedirs(os.path.dirname(HOOK_ERRORS_LOG), exist_ok=True)
-            with open(HOOK_ERRORS_LOG, 'a', encoding='utf-8') as f:
-                f.write('[{}] stop-eval: {}\n'.format(
-                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
-        except Exception:
-            pass
-        sys.exit(0)  # 铁律: hook 崩溃绝不阻塞
-
-
-if __name__ == '__main__':
-    main()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""stop-eval.py - Stop hook: Agent 说"完成"时强制 eval 门禁 (治"说做完了没真评测")
+
+吸收宿主确定性 hook 能力: 把 EVA 门禁 (PRD 发布前 eval≥80%) 从"靠 AI 自觉跑"
+升级为"Agent 准备结束回复时宿主拦住"。AI 说"PRD 做完了"但没跑 eval → 被拦回继续。
+
+阻断契约: exit 0 放行; exit 2 阻断(stderr 反馈, 强制 Agent 续修)。
+
+防递归 (关键!): Stop hook 被 exit 2 阻断后, Agent 续修完再次 Stop 会再次触发本 hook →
+死循环。必须检查 stdin 的 stop_hook_active: 为 true 时直接 exit 0 放行 (Agent 已在本轮
+被拦过一次, 不再二次拦)。
+
+判断逻辑 (保守, 只拦明确场景):
+  - 本会话最近产出过 PRD 文件 (扫描 workspace/members/*/drafts + tasks/*/prd.md,
+    找近 10 分钟内 mtime 的 prd*.md)
+  - 且该 PRD 没有对应的 eval 记录 (eval-history.jsonl 里查不到该 prd 名)
+  → exit 2 强制 eval
+  其它情况一律 exit 0 (绝不误拦普通对话/非 PRD 工作)。
+
+stdin 字段名官方未公开, 兼容 stop_hook_active / hook_active 等多种写法。
+"""
+import json
+import os
+import sys
+import time
+from datetime import datetime
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+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')
+EVAL_HISTORY = os.path.join(BASE, 'data', 'learning', 'eval-history.jsonl')
+RECENT_WINDOW = 600  # 10 分钟内产出的 PRD 视为本轮产物
+
+
+def _is_reentry(stdin_data):
+    """是否二次进入 (防递归)。兼容多字段名。"""
+    if not isinstance(stdin_data, dict):
+        return False
+    for k in ('stop_hook_active', 'hook_active', 'is_reentry'):
+        v = stdin_data.get(k)
+        if v in (True, 'true', 'True', 1, '1'):
+            return True
+    return False
+
+
+def _read_stdin():
+    try:
+        if sys.stdin.isatty():
+            return {}
+        raw = sys.stdin.read().strip()
+        if not raw:
+            return {}
+        return json.loads(raw)
+    except Exception:
+        return {}
+
+
+def _is_prd_filename(fn):
+    """判断文件名是否是 PRD 产物。
+
+    真实 PRD 有两类命名 (与 eval-history.jsonl 记录的 'prd' 字段对齐):
+      1. workspace/tasks/<task>/prd.md              (任务级 PRD, 文件名含 prd)
+      2. workspace/members/<dev>/drafts/REQ-2026-XXX-<feature>.md
+         (AI 产出的 PRD 草稿, 命名 REQ-<id>-<feature>.md, 不含 'prd' 字样)
+    只匹配 'prd' 会漏掉第 2 类 (绝大多数真实产出) → 门禁形同虚设。
+    这里两类都认: 文件名含 'prd' 或 以 'REQ-' 开头 (eval-history 的真实记录格式)。
+    """
+    low = fn.lower()
+    if not low.endswith('.md'):
+        return False
+    return 'prd' in low or low.startswith('req-')
+
+
+def _recent_prd_files():
+    """找近 RECENT_WINDOW 秒内产出的 PRD 文件 (绝对路径)。扫描 drafts + tasks。"""
+    now = time.time()
+    candidates = []
+    search_roots = [
+        os.path.join(BASE, 'workspace', 'members'),
+        os.path.join(BASE, 'workspace', 'tasks'),
+        os.path.join(BASE, 'data', 'docs', 'prd'),
+    ]
+    for root in search_roots:
+        if not os.path.isdir(root):
+            continue
+        for dirpath, dirs, files in os.walk(root):
+            # 跳过无关大目录
+            dirs[:] = [d for d in dirs if d not in ('node_modules', '.git', '__pycache__', '.secrets')]
+            for fn in files:
+                if not _is_prd_filename(fn):
+                    continue
+                fp = os.path.join(dirpath, fn)
+                try:
+                    if now - os.path.getmtime(fp) <= RECENT_WINDOW:
+                        candidates.append(fp)
+                except OSError:
+                    continue
+    return candidates
+
+
+# 快速模式 6 章必需标题 (与 prd-quick-template.md 对齐)
+QUICK_REQUIRED_SECTIONS = [
+    '功能入口', '需求背景', '需求说明', '影响范围', '验收标准', '不在本次范围',
+]
+
+
+def _check_quick_prd_complete(prd_path):
+    """检测 quick 模式 PRD 是否缺章。返回缺失章节列表 (空=完整)。
+
+    判定 quick 模式: @contract 头含 mode: quick。
+    必需 6 章: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。
+    治"残废品" (真实案例: 海外考勤 PRD 只写"功能入口"一段, 6 章缺 5 章)。
+    """
+    try:
+        text = open(prd_path, encoding='utf-8', errors='replace').read()
+    except Exception:
+        return []  # 读不到不拦 (误拦比放过更糟)
+    # 只检 quick 模式 (完整档 13 章另算, 不在此 hook 范围)
+    if 'mode: quick' not in text[:500]:
+        return []
+    missing = []
+    for sec in QUICK_REQUIRED_SECTIONS:
+        # 章节标题: ## 功能入口 / ## 需求背景 等 (允许前后空格)
+        import re
+        if not re.search(r'^#{1,3}\s*' + sec, text, re.MULTILINE):
+            missing.append(sec)
+    return missing
+
+
+def _evald_prds():
+    """读 eval-history.jsonl, 返回【已通过门禁】的 prd 文件名集合。
+
+    门禁定义 (与消息承诺一致): 该 PRD 最近一次 eval 记录 passed=True 或 score_pct>=80。
+    只"跑过 eval 但没过线"的不算通过 → 仍需拦回去重测。
+    eval-history.jsonl 是 append-only, 同一 PRD 可能有多条 → 取最后一条为准。
+    """
+    last = _last_record_by_prd()
+    done = set()
+    for key, r in last.items():
+        passed = r.get('passed')
+        score = r.get('score_pct')
+        is_ok = (passed is True) or (isinstance(score, (int, float)) and score >= 80)
+        if is_ok:
+            done.add(key)
+    return done
+
+
+def _last_record_by_prd():
+    """读 eval-history.jsonl, 返回 {prd_basename: 最后一条记录}。
+
+    append-only 文件, 后出现的记录覆盖前面的 → 取每个 PRD 的最新 eval。
+    被门禁诊断复用 (区分"没跑过 eval" vs "跑了但没过线")。
+    """
+    last_by_prd = {}
+    if not os.path.isfile(EVAL_HISTORY):
+        return last_by_prd
+    try:
+        with open(EVAL_HISTORY, encoding='utf-8', errors='replace') as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    r = json.loads(line)
+                    p = r.get('prd')
+                    if p:
+                        last_by_prd[os.path.basename(str(p))] = r
+                except Exception:
+                    continue
+    except Exception:
+        pass
+    return last_by_prd
+
+
+def main():
+    try:
+        data = _read_stdin()
+        # 防递归: 二次进入直接放行
+        if _is_reentry(data):
+            sys.exit(0)
+
+        # 找近 10 分钟产出的 PRD, 检查是否已【通过】门禁
+        recent = _recent_prd_files()
+        if not recent:
+            sys.exit(0)  # 本轮没产 PRD, 放行
+
+        # ── 先查 quick 模式 PRD 缺章 (残废品门禁, 比 eval 更优先) ──
+        incomplete = []
+        for p in recent:
+            miss = _check_quick_prd_complete(p)
+            if miss:
+                incomplete.append((p, miss))
+        if incomplete:
+            lines = []
+            for p, miss in incomplete[:3]:
+                lines.append('  %s 缺: %s' % (os.path.basename(p), '、'.join(miss)))
+            sys.stderr.write(
+                '【PRD 残废品门禁】检测到快速模式 PRD 缺章 (6 章缺一不可):\n'
+                + '\n'.join(lines) + '\n'
+                '修复: 补齐缺失章节的标题和内容 (不涉及的写一句话说明, 标题必须保留),\n'
+                '      章节顺序: 功能入口/需求背景/需求说明/影响范围/验收标准/不在本次范围。\n'
+                '      模板: .qoder/templates/prd-quick-template.md\n')
+            sys.exit(2)
+        evald = _evald_prds()
+        last_records = _last_record_by_prd()
+        # 区分两种未过门禁: 从没跑过 eval / 跑了但没过线
+        not_run = [p for p in recent if os.path.basename(p) not in last_records]
+        failed = [p for p in recent
+                  if os.path.basename(p) in last_records
+                  and os.path.basename(p) not in evald]
+        if not not_run and not failed:
+            sys.exit(0)  # 全部通过门禁, 放行
+
+        # 有未过门禁的近期 PRD → 阻断, 给出可操作指引
+        parts = []
+        if not_run:
+            parts.append('未跑评测: ' + ', '.join(os.path.basename(p) for p in not_run[:3]))
+        if failed:
+            details = []
+            for p in failed[:3]:
+                rec = last_records.get(os.path.basename(p), {})
+                s = rec.get('score_pct')
+                details.append('%s (最近 %s)' % (os.path.basename(p),
+                                                 ('%s%%' % s) if s is not None else '未过'))
+            parts.append('评测未过线: ' + ', '.join(details))
+        sys.stderr.write(
+            '【EVA 门禁】检测到近期产出的 PRD 未通过质量门禁 (要求 eval ≥80%%):\n'
+            '  %s\n'
+            '修复: python .qoder/scripts/orchestration/wlkj.py eval <PRD> [原型]\n'
+            '      针对评测报告的扣分项改 PRD, 重跑 eval 到 ≥80%% 再结束。\n'
+            % '; '.join(parts))
+        sys.exit(2)
+    except SystemExit:
+        raise
+    except Exception as e:
+        try:
+            os.makedirs(os.path.dirname(HOOK_ERRORS_LOG), exist_ok=True)
+            with open(HOOK_ERRORS_LOG, 'a', encoding='utf-8') as f:
+                f.write('[{}] stop-eval: {}\n'.format(
+                    datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(e)[:200]))
+        except Exception:
+            pass
+        sys.exit(0)  # 铁律: hook 崩溃绝不阻塞
+
+
+if __name__ == '__main__':
+    main()