@hupan56/wlkj 3.2.0 → 3.3.1

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

@@ -1,6 +1,6 @@
 ---
 name: wl-test
-description: "测试: quick(意图式用例,默认) / browser(Playwright浏览器) / unit(单元) / coverage(覆盖矩阵)。"
+description: "测试: quick(意图式用例,默认) / browser(Playwright浏览器) / unit(单元) / coverage(测试覆盖矩阵)。"
 argument-hint: "[quick|browser|unit|coverage] <描述或任务>"
 auto-approve: false
 allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
@@ -91,6 +91,10 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick --record '{"Q-1":"pass","Q-2":"fail"}'
 ```
 
+### 下一步
+- 用例全过 → `/wl-commit <[#REQ-xxx] message>` 提交回流（双通飞轮：quick 测 → commit 回流 → `/wl-task finish <REQ-ID>` 收尾）
+- 有失败 → 列原因，修复后重跑 quick，再 commit
+
 ---
 
 ## browser 基于任务的浏览器测试（需先有任务）
@@ -124,10 +128,25 @@ python -c "import json; d=json.load(open('$R/data/index/test-pages.json')); prin
 输出：哪些功能/页面有测试用例（test-pages.json + test-assertions.json），哪些是空白。
 AI 据此建议"优先补 XX 功能的测试"。
 
+🎨 **富展示**（覆盖热力图 HTML）：`$PY "$R/.qoder/scripts/validation/metrics/present_board.py" coverage --project-id <UUID>`（功能×测试 有/无 热力图，QoderWork 嵌入对话 / CLI 落盘 journal）
+
+### 改动驱动的必跑测试（提交前门禁 · S4 覆盖推理）
+
+改完代码要确定"必跑哪些测试"时，用覆盖推理四件套（已注册 MCP）：
+```python
+cap.mcp.call("impact_coverage", {"entity_ids": ["<改动实体id1>", "<id2>"]})  # 改动集→必跑测试
+cap.mcp.call("find_tests_of", {"entity_id": "<某实体id>"})          # 查某实体的测试
+cap.mcp.call("find_coverage_of", {"req_id": "<REQ-ID>"})            # 查某需求的覆盖
+```
+- `impact_coverage` 拿"这次改动必须跑哪些测试"——提交前用它圈定回归范围，不漏不改崩。
+- 改动实体 id 从 `rag_search`/`search_code` 命中里取。
+
 ---
 
 ## unit 单元测试
 
+> **宿主 sub-agent 激活**：QoderWork 支持 sub-agent 时，dispatch 到 **`qoder-test-gen`** agent（`.qoder/agents/qoder-test-gen.toml`）——自动定位实现代码 + 读 Spec → 生成 JUnit（Service 层 Mock 全依赖 Given-When-Then / Controller 层 MockMvc / @DisplayName / AssertJ / Builder 测试数据），输出 `tests/{包路径}/{类名}Test.java`。dispatch prompt 首行传 `Active Code: <实现文件路径>`。不支持则按下文 skill 手动生成。
+
 读 `.qoder/skills/test-generator/SKILL.md`：定位实现代码 → 读 spec → 生成
 JUnit 测试（Mock + MockMvc，Given-When-Then）→ 输出 `tests/{package}/{Class}Test.java`。
 （只有这条线才需要 search_index 找代码。）

package/templates/qoder/contracts/spec.md

@@ -50,12 +50,16 @@ module: policy
 endpoints: [POST /api/policy/amend, GET /api/policy/amend/{id}]
 status: draft
 zentao: task=1453 story=761
+zentao_id: 761
+platform_spec_id:
 -->
 ```
 
 **字段说明**：
 - `status`：状态机见下表，/wl-code spec gate 的判据。
 - `zentao`：禅道 task 来的必须填（task+story）；本地来的留空，待回填时补。回填 task 后 spec 摘要写入该 task 的 `desc`。
+- `zentao_id`：禅道 story 号（关联键，= zentao 的 story）。spec_upload 据此让平台反查 Requirement 挂载；缺失则上传暂存待产品推禅道后回填。
+- `platform_spec_id`：平台 spec id（幂等锚）。spec_upload 首次 create 后自动回写，**勿手填**；有值则下次上传走 update_spec（新增版本不重复建）。
 
 **`status` 状态机**（/wl-code spec gate 的判据）：
 

package/templates/qoder/hooks/post-tool-use.py

@@ -107,6 +107,68 @@ def _dev():
     return None
 
 
+def _auto_learn_from_prd(prd_path):
+    """PRD 写完后自动调 MCP learn 沉淀业务规则（宿主能力接入）。
+
+    读 PRD 标题 → 调工作台 MCP learn → 知识层自动积累。
+    失败静默（铁律：hook 崩溃不阻塞会话）。
+    """
+    try:
+        title = os.path.basename(prd_path).replace('.md', '')
+        # 读 mcp_config 拿 token
+        cfg_path = os.path.join(BASE, '.qoder', 'mcp_config.json')
+        if not os.path.isfile(cfg_path):
+            return
+        import json as _j
+        cfg = _j.load(open(cfg_path, encoding='utf-8'))
+        srv = cfg.get('mcpServers', {}).get('wlinkj-knowledge', {})
+        token = srv.get('token', '')
+        url = srv.get('url', '').replace('/mcp', '/mcp')  # 保持 /mcp
+        pid = srv.get('env', {}).get('WLKJ_PROJECT_ID', '')
+        if not token or not url or not pid:
+            return
+        # 调 MCP learn（POST /mcp JSON-RPC）
+        import urllib.request
+        rpc = {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+               "params": {"name": "learn",
+                          "arguments": {"project_id": pid, "category": "decision",
+                                        "pattern": "PRD更新: " + title,
+                                        "source": "qoder-hook-auto"}}}
+        req = urllib.request.Request(
+            url, data=_j.dumps(rpc).encode(),
+            headers={"Content-Type": "application/json", "X-MCP-Token": token},
+            method="POST")
+        urllib.request.urlopen(req, timeout=5).read()  # 5s 超时，不阻塞
+    except Exception:
+        pass  # 铁律：静默
+
+
+def _emit_ask_before_return(kind, path):
+    """PRD/原型写完 → 注入"先问用户再回流"指令（用户硬要求：上传前必须先问）。
+
+    hook 无法弹窗等 Y/n（工具执行后跑、输出即退），但能**确定性注入指令**让 AI
+    每次必问、默认不上传。stdout 注入会话上下文，AI 看到后必须先问用户。
+    """
+    name = os.path.basename(path)
+    if kind == 'prd':
+        cmd = '$PY "$R/.qoder/scripts/orchestration/wlkj.py" return prd "%s" "<标题>"' % path
+        what = 'PRD'
+    else:
+        cmd = '$PY "$R/.qoder/scripts/orchestration/wlkj.py" return prototype "%s" "<功能>"' % path
+        what = '原型(HTML)'
+    msg = (
+        "\n⚠️ 【回流前必须先问用户】刚写了 %s：%s\n"
+        "  → 必须先问用户：「要把这份 %s 回流到平台吗？」\n"
+        "  → 用户【明确同意】（说「回流 / 上传 / 确认」）才执行：%s\n"
+        "  → 用户拒绝 / 未明确同意 → 只留本地，绝不默认上传。\n"
+        "  （宿主确定性要求：不问就传 = 违规；这是用户明确要的确认环节）\n"
+    ) % (what, name, what, cmd)
+    try:
+        sys.stdout.write(msg)
+    except Exception:
+        pass
+
+
 def _append_event(event, data):
     """best-effort append 一条事件到当前 dev 的 feedback.jsonl。避开 learn import 断链, 直接写文件。"""
     try:
@@ -160,10 +222,19 @@ def main():
                 plow = p.lower().replace('\\', '/')
                 if 'prd' in os.path.basename(plow).lower() and plow.endswith('.md'):
                     _append_event('prd_written', {'prd': os.path.basename(p), 'tool': tool_name})
+                    # ★ 宿主能力接入：PRD 写完 → 自动调 MCP learn 沉淀业务规则
+                    _auto_learn_from_prd(p)
+                    # ★ 用户硬要求：PRD 回流平台前必须先问（不问就传=违规）
+                    _emit_ask_before_return('prd', p)
                 if plow.endswith('task.json'):
                     _append_event('task_touched', {'task_json': os.path.basename(os.path.dirname(p)), 'tool': tool_name})
+                # ★ 宿主能力接入：代码文件改完 → 自动记 code_changed（知识层下次检测过时用）
+                if any(plow.endswith(ext) for ext in ('.java', '.vue', '.ts', '.js', '.py')):
+                    _append_event('code_changed', {'file': os.path.basename(p), 'path': plow[:200]})
                 # v3.1 软提示: prototype HTML 写完但缺来源锚定 → stderr 提醒(不阻断)
                 if 'prototype' in os.path.basename(plow) and plow.endswith('.html'):
+                    # ★ 用户硬要求：原型回流平台前必须先问（不问就传=违规）
+                    _emit_ask_before_return('prototype', p)
                     try:
                         if os.path.isfile(p):
                             with open(p, encoding='utf-8', errors='ignore') as _f:

package/templates/qoder/hooks/pre-tool-use.py

@@ -0,0 +1,136 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""pre-tool-use.py - PreToolUse hook: 改码前 get_impact 影响面 priming（#16 / CLAUDE.md 铁律#1 宿主级强制）
+
+吸收宿主确定性 hook 能力：把"改代码前必调 get_impact"从"靠 AI 记得（老忘→裸改崩一片）"
+升级为"宿主在 Write/Edit/MultiEdit 落到代码文件前，确定性提取符号 + 强提醒"。
+
+做法（确定性、零外部依赖、不依赖后端在线）：
+  1. 解析 stdin {tool_name, tool_input:{file_path}}
+  2. 只对代码文件(*.py/java/vue/js/ts/go/kt 等，非 .md/.json/.txt)触发
+  3. 正则提取文件里的 class/def/function 名（要改的符号）
+  4. 输出影响面 advisory 到会话：列符号 + 强制提醒改前调 get_impact(entity=<主符号>)
+     实际 get_impact 由工作流 cap.mcp.call 跑（robust，处理 token/SSE）。
+
+铁律：
+  - 永远 exit 0（advisory 不阻断；阻断会卡死工作流）
+  - 失败 try/except 静默（hook 崩绝不阻塞会话）
+  - 非 .py/.java 等代码文件 / 非编辑类工具 → 静默放行（不滥提醒）
+
+stdin 字段名官方未公开，兼容 tool_name/tool_input 等多种写法（同 post-tool-use.py）。
+"""
+import json
+import os
+import re
+import sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+        sys.stderr.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+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')
+
+# 触发的工具 + 代码文件后缀
+_EDIT_TOOLS = {"Write", "Edit", "MultiEdit", "write", "edit", "multi_edit"}
+_CODE_EXT = {".py", ".java", ".vue", ".js", ".ts", ".tsx", ".jsx", ".go", ".kt", ".scala", ".cs", ".c", ".cpp", ".h", ".rs"}
+
+# 符号提取正则（class/def/function/interface）
+_SYM_RE = re.compile(
+    r"^\s*(?:export\s+)?(?:public|private|protected|static|final|abstract|async|\s)*"
+    r"(?:class|def|function|interface|struct|enum|object)\s+([A-Za-z_][A-Za-z0-9_]*)",
+    re.MULTILINE,
+)
+
+
+def _log_err(line):
+    from datetime import datetime
+    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('[{}] pre-tool-use: {}{}'.format(
+                datetime.now().strftime('%Y-%m-%d %H:%M:%S'), str(line)[:200], NL))
+    except Exception:
+        pass
+
+
+def _read_stdin():
+    try:
+        raw = sys.stdin.read()
+        if raw and raw.strip():
+            return json.loads(raw)
+    except Exception as e:
+        _log_err("stdin parse: %s" % str(e)[:120])
+    return {}
+
+
+def _is_code(path):
+    _, ext = os.path.splitext(path.lower())
+    return ext in _CODE_EXT
+
+
+def _extract_symbols(path, limit=8):
+    """从文件提取 class/def/function 名（要改的符号）。best-effort，读不到返空。"""
+    try:
+        if not os.path.isfile(path):
+            # 相对路径 → 试 BASE 下定位
+            cand = path
+            if not os.path.isabs(path):
+                for root in (BASE, os.getcwd()):
+                    c = os.path.join(root, path)
+                    if os.path.isfile(c):
+                        cand = c
+                        break
+            if not os.path.isfile(cand):
+                return []
+            path = cand
+        with open(path, 'r', encoding='utf-8', errors='replace') as f:
+            text = f.read()[:200000]  # 限 200K 防超大文件慢
+        return _SYM_RE.findall(text)[:limit]
+    except Exception as e:
+        _log_err("extract %s: %s" % (path, str(e)[:80]))
+        return []
+
+
+def main():
+    data = _read_stdin()
+    tool = data.get("tool_name") or data.get("tool") or ""
+    tinput = data.get("tool_input") or data.get("input") or {}
+    path = tinput.get("file_path") or tinput.get("path") or ""
+
+    # 非编辑类工具 / 非代码文件 → 静默放行
+    if tool not in _EDIT_TOOLS or not path or not _is_code(path):
+        sys.exit(0)
+
+    syms = _extract_symbols(path)
+    rel = path
+    try:
+        rel = os.path.relpath(path, BASE)
+    except Exception:
+        pass
+
+    lines = []
+    lines.append("⚠️ **改码前影响面 priming**（CLAUDE.md 铁律#1：改代码前必调 get_impact）")
+    lines.append("即将编辑代码文件：`%s`" % rel)
+    if syms:
+        lines.append("含符号 %d 个：%s" % (len(syms), ", ".join("`%s`" % s for s in syms)))
+        lines.append("→ **改前必调** `cap.mcp.call('get_impact', {entity: '%s', depth: 2})` 看 upstream(谁依赖我)/downstream(我依赖谁)。" % syms[0])
+        lines.append("  影响面大 / risk level≥high → 先提示风险再动手；高风险裸改须拦停问用户。")
+    else:
+        lines.append("（未提取到已知符号，可能是新文件）→ 仍建议改前 rag_search 找相关实现 + get_impact 看上下游。")
+
+    # advisory 输出到 stdout（注入会话上下文），exit 0 不阻断
+    sys.stdout.write(NL.join(lines) + NL)
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except Exception as e:
+        _log_err("fatal: %s" % str(e)[:150])
+        sys.exit(0)  # 永不阻塞