@hupan56/wlkj 3.4.2 → 3.4.4

package/package.json

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

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

@@ -1,218 +1,34 @@
----
-name: wl-code
-description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. "
-argument-hint: "[REQ-ID or spec-filename]"
-auto-approve: false
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
----
-
-# /wl-code - Implement Code
-
-User input: $ARGUMENTS
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
-```
-> 后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
-
-## 🔧 工具优先级（宿主能力 × 知识层分工）
-| 步骤 | 用谁 | 原因 |
-|------|------|------|
-| 精确找符号 handleExport | **Qoder Grep** | 原生正则搜，零延迟 |
-| 读文件看实现 | **Qoder Read** | 原生全量读，MCP 只有预览 |
-| 语义找"导出功能" | **MCP rag_search** | 跨仓库语义召回 |
-| 改代码前看影响 | **MCP get_impact** | 跨3端影响分析，Qoder 做不到 |
-| 文件知识标注 | **MCP code_context** | 实体/调用/影响1次拿 |
-| 写代码 | **Qoder Write/Edit** | 原生编辑，精确行号 |
-
-## 🔍 Ultra Review（强制门禁 · 非建议）
-
-> ⚠️ **代码写完必须过 Ultra Review 才能回流**（不再是"建议"）。
-> 这是 Step 4 自检之后的硬门禁：过→回流；不过→列问题修，重跑；无 Ultra Review→手动 checklist 降级。
-
-### 强制流程（Step 4 自检后执行）
-1. 自检 4 项全 ✓ 后，**立即调 Ultra Review Agent**（宿主原生能力）审查本次改动
-2. **分支裁决**：
-   - ✅ **过** → 调 `submit_return` 回流 + `learn` 沉淀（见 Step 5 / 学习沉淀段）
-   - ❌ **不过** → 列出 Review 指出的问题（边界/性能/安全/规范），逐条修，**重跑 Ultra Review**，不过不回流
-3. **降级**（宿主无 Ultra Review Agent）：按下方手动 checklist 逐条过，全 ✓ 视同通过
-
-### 手动 checklist 降级（无 Ultra Review 时）
-- [ ] 边界条件：空值/越界/并发/大数量都处理了
-- [ ] 性能：无 N+1 查询、无循环里调 DB、大数据量分页
-- [ ] 安全：入参校验、权限校验、SQL 无拼接注入
-- [ ] 异常路径：Spec 定义的异常场景都有对应处理
-- [ ] 规范：与周围代码风格一致（命名/注释/分层）
-
-## Step 1: Spec Gate（强制前置 · 非侵入式）
-
-> ⚠️ **核心门禁**：没有 `status: confirmed` 的 spec，**绝不动手写代码**。
-> 本 gate 只在走 `/wl-code` 命令时生效；用户不调 `/wl-code` 时完全无感。
-
-### 1.1 定位 spec（确定性检测）
-
-```bash
-# 用 paths.find_spec 确定性查找 (查 .qoder/workspace/specs/ + 当前任务目录, 读 status)
-SPEC=$($PY -c "
-import sys, json; sys.path.insert(0,'$R/.qoder/scripts')
-from foundation.bootstrap import setup; setup()
-from foundation.core.paths import find_spec, get_spec_status
-hits = find_spec('$ARGUMENTS') if '$ARGUMENTS' else find_spec()
-if hits:
-    # 优先输出 confirmed 的; 都不是 confirmed 就输出第一个(draft)
-    confirmed = [h for h in hits if h['status']=='confirmed']
-    chosen = confirmed[0] if confirmed else hits[0]
-    print(json.dumps(chosen, ensure_ascii=False))
-")
-```
-- 有 `$ARGUMENTS`（REQ-ID）→ `find_spec('REQ-ID')` 查全局 specs/
-- 无参数 → `find_spec()` 读当前任务目录的 spec.md
-
-### 1.2 检查 status 字段 → 三分支
-
-读 spec 文件契约头的 `status:`：
-
-| 情况 | 处理 |
-|------|------|
-| **无 spec** | → 调 **spec-generator** 生成（读 `templates/spec-template.md`，产出 `status: draft`）→ 进入 1.3 确认环节 |
-| **status: draft**（或非 confirmed） | → 展示 spec 全文 + 关键决策点（接口/表结构/异常枚举/AI边界）→ 进入 1.3 确认环节 |
-| **status: confirmed** | ✅ 放行，进入 Step 2 |
-
-### 1.3 确认环节（停在写码之前）
-
-向用户展示 spec 后，明确询问：
-
-> 📋 spec 已就绪（`status: draft`）：`{spec路径}`
-> 你可以：① 直接说哪里要改 ② 自己打开文件改后告诉我 ③ 回复「确认」开始写代码
->
-> **确认前不会写任何代码。**
-
-- 用户提修改 → 按反馈改 spec（或重读用户改过的文件）→ 再次展示 → 再问确认
-- 用户回复「确认」→ AI 把 spec 契约头 `status: draft` 改为 `status: confirmed` → **先做 1.4 回填禅道** → 才进入 Step 2
-- ❌ 用户未确认时，**禁止推进到 Step 2，禁止写任何代码**（哪怕催促）
-
-> 向后兼容：老 spec 无 `status` 字段 → 视同 `draft`，走确认环节（不直接写码）。
-
-### 1.4 确认后回填禅道 task（仅禅道来源的 spec）
-
-spec 契约头有 `zentao: task=X` 时，确认后把 spec 摘要回填到该 task（让禅道里能看到开发规格要点）：
-
-```python
-# 组装摘要：接口清单 + 关键表 + 异常条数 + AC 映射 + 本地 spec 路径（全量太长，只取要点）
-summary = build_spec_digest(spec_path)   # 第1章接口表 + 第2章表名 + 第3章异常计数 + 第6章AC映射
-cap.mcp.call("update_task", {"task_id": X, "desc": summary + "\n本地spec: " + spec_path})
-```
-
-- **非侵入**：禅道不可达 / spec 无 zentao 字段 → 跳过回填，不阻塞写码（已在 Step 1 拿到 PRD，回填是锦上添花）
-- **失败不阻塞**：update_task 返回 ⚠️（权限/网络）→ 提示用户但继续写码
-- **不重复回填**：契约头已标 `回填=true`（或 task desc 末尾已含本地路径）→ 跳过
-
-> panel 也可调同一个 `update_task` 做回填，两边都行（谁先触发都行，不冲突）。
-
-## Step 2: Search Related Code（RAG 语义召回，不只关键词）
-
-**改代码前用 rag_search 找相关函数/API（语义召回最全），精确符号定位才用 search_code。**
-
-```python
-from capability import resolve
-cap = resolve()
-# ⓪ 有 REQ-ID/禅道号时查这需求的历史代码变更（code_changes 按需求号→改过哪些函数/hunk）
-#    看这需求历史改过啥，避免重复改/沿用历史模式。与 code_history(按文件查) 互补。
-if <有 REQ-ID 或禅道号>:
-    changes = cap.mcp.call("code_changes", {"project_id": "<项目UUID>", "req_key": "<REQ-ID或XQ/WT号>"})
-# ① rag_search 语义召回：找和需求相关的函数/API/字段（词不必一样，召回最全）
-rag = cap.mcp.call("rag_search", {"query": "<需求关键词或功能描述>", "top_k": 10})
-# ② 需要精确找某个已知符号（如 handleExport）才用 search_code
-precise = cap.mcp.call("search_code", {"keyword": "<精确符号名>"})
-# ③ 影响分析（必跑）：改这些符号会影响谁/依赖谁，按项目仓库隔离，避免改一处崩一片
-#    project_id 从 mcp_config.json 的 WLKJ_PROJECT_ID 取（绑当前项目）
-#    get_impact 返回分层 upstream(谁依赖我→改动影响范围)/downstream(我依赖谁)+byType
-impact = cap.mcp.call("get_impact", {
-    "project_id": "<项目UUID>",   # mcp_config.json 的 WLKJ_PROJECT_ID
-    "entity": "<要改的核心符号: 如 handleExport / C:FlowOperationController>",
-    "depth": 2,
-})
-# ③a 改码前风险三件套（get_impact 看影响面 → risk_assessment 看风险等级 → code_history 看历史 → get_confidence 看证据置信）
-#    risk_assessment 返回 score/level(7项多证据：影响面/DB写/覆盖缺口/路径置信缺口/缺需求链路/历史不稳定/Agent变更)；
-#    code_history 返回这文件/函数被哪些需求(XQ/WT)改过、改了什么（反向：代码→需求）；
-#    get_confidence 返回路径置信度(0-1)+证据路径链。
-#    level=high/critical 或 confidence 低 → 先在回复里提示风险再动手。
-risk = cap.mcp.call("risk_assessment", {"project_id": "<项目UUID>", "entity": "<核心符号>", "depth": 2})
-history = cap.mcp.call("code_history", {"project_id": "<项目UUID>", "file_path": "<文件名或路径片段>"})
-conf = cap.mcp.call("get_confidence", {"project_id": "<项目UUID>", "entity": "<核心符号>"})
-# ③c 终极门禁裁决（合成 risk+coverage → block/warn/pass + 保形策略/alpha）
-#    gate.decision=block 须拦停问用户(高风险+裸改)；warn 可放行带提示；pass 放心改
-gate = cap.mcp.call("gate_check", {"project_id": "<项目UUID>", "entity": "<核心符号>"})
-# 影响面大 / risk level≥high / confidence 低 / gate=block 时，先提示风险再动手（block 须拦停问用户）
-# ③d 影响面大时多层并行审改动风险（宿主支持 Agent 并行 → 派 3 个 subagent 各审一层，合并风险清单）：
-#    - 前端层：谁调用这个接口/符号？改动会不会破坏调用方？
-#    - 后端层：实现逻辑/事务/调用链是否自洽？
-#    - DB层：涉及表/字段改动是否波及别处（trace_dataflow 已追全链）？
-#    不支持 Agent 并行 → 上面 risk_assessment 单点结果已够（串行降级）。
-# ③e 门禁前知识新鲜度（改码前看知识层是否过期，过期数据不可信）：
-#    check_freshness 返回模块 avg_age_days + 是否过期；过期(>threshold)→提示 refresh_knowledge 再动手
-fresh = cap.mcp.call("check_freshness", {"module": "<核心模块>", "threshold_days": 30})
-# fresh.verdict 含"过期" → 提示用户知识层陈旧，建议先 refresh_knowledge（跑构建脚本）再改码
-# ③b 涉及字段改动（加列/改类型/表单字段）：追字段全链路（表单→接口→Java字段→DB列），改一处看全链
-if <涉及字段层>:
-    cap.mcp.call("trace_dataflow", {"field": "<字段名>"})  # 防"改了DB列没改对应Java字段/前端表单"
-# ④ 涉及数据库改动的，查真表结构（引擎自己的 MySQL MCP，别猜列名）
-if <涉及数据库层>:
-    schema = cap.mcp.call("query_schema", {"table": "<表名>"})  # qoder-mysql 工具
-    # 真表结构回流平台
-    cap.mcp.call("learn", {"project_id":"<项目UUID>","category":"rule",
-        "pattern": f"真表结构<表名>: {json.dumps(schema.get('columns',[]),ensure_ascii=False)[:400]}",
-        "source":"wlkj/wl-code+mysql"})
-```
-等价 CLI（脚本兜底）：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" search <keyword>
-```
-Find existing code that this implementation relates to.
-Read relevant files for context.
-
-**接地铁律**：实现时调用的函数名/字段名/API 路径必须来自 rag_search 召回结果（系统里真有的），不编造不存在的 API。改码前用 get_impact 拿分层影响范围（谁依赖我/我依赖谁），影响面大先提示风险再动手，避免改一处崩一片。
-
-## Step 3: Implement
-
-Follow the spec strictly:
-1. Read spec-coder skill for coding workflow
-2. Implement each requirement from spec
-3. Follow team conventions from data/code/ patterns
-4. Write clean, commented code
-
-> **宿主 sub-agent 激活**：QoderWork 支持 sub-agent 时，dispatch 到 **`qoder-coder`** agent（`.qoder/agents/qoder-coder.toml`）——它内置 Spec 契约实现规范（数据层 Entity→Mapper→Service→Controller / 接口层 RESTful+校验+统一返回 / 异常按 Spec），递归守卫不二次 spawn。dispatch prompt 首行传 `Active Spec: <spec路径>`。不支持 sub-agent 时按上面 4 步手动实现。
-
-## Step 4: Self-Check
-
-After implementation:
-- [ ] All spec requirements covered
-- [ ] No TODO/FIXME left
-- [ ] Code follows project conventions
-- [ ] Error handling in place
-
-## Step 5: Report
-
-Tell user what was implemented and suggest next:
-- `/wl-test <描述>` — 跑测试验证（改动大时先 `impact_coverage` 圈必跑范围）
-- 验过后 `/wl-commit <message>` — 提交+push+回流平台（自动 record_commit）
-
-## 下一步
-- 实现 → `/wl-test` 验证 → `/wl-commit` 提交回流 → `/wl-task finish <REQ-ID>` 收尾（双通飞轮）
-
-## 🧠 学习沉淀（改完代码即执行，反哺下次）
-
-改代码过程中发现的业务规则/架构约定/踩坑经验，调 learn 写回平台：
-```python
-cap.mcp.call("learn", {
-    "project_id": "<项目UUID>",
-    "category": "pitfall",       # pitfall=踩坑 / rule=业务规则 / decision=架构决策
-    "pattern": "<学到的，如：VehicleController 的 save 方法必须先校验驾驶员是否存在>",
-    "source": "wlkj/wl-code",
-})
-```
-- 至少写 1 条最有价值的认知。try/except 不阻塞。
+---
+name: wl-code
+description: "改码方案：影响分析+风险评估。MCP工具优先，禁跑本地脚本。"
+argument-hint: "[要改的实体/功能]"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-code - 改码方案
+
+User input: $ARGUMENTS
+
+## 🚨 MCP工具优先，禁止跑本地脚本
+
+| 要什么 | 工具 |
+|---|---|
+| 改XX影响谁 | get_impact |
+| 全上下文 | context_pack |
+| 代码搜索 | search_code |
+| 功能画像 | feature_overview |
+
+> QoderWork: mcp__qoder-knowledge-graph__<工具名>
+
+## 流程
+
+1. 调 get_impact 查影响面（upstream谁依赖我/downstream我依赖谁）
+2. 调 context_pack 取上下文（代码+API+字段）
+3. 输出：改动范围/影响面/风险/必跑测试/改前注意
+
+## 🚨 接地铁律
+1. 溯源：引用符号用真实原名
+2. 禁编：不编造未召回实体
+3. 接地：涉及表结构先调search_field
+4. 完整：方案详尽

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

@@ -1,46 +1,49 @@
----
-name: wl-commit
-description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. "
-argument-hint: "[commit message]"
-auto-approve: false
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
----
-
-# /wl-commit - Git Commit + Push + Sync
-
-User input: $ARGUMENTS (commit message)
-
-## Flow
-1. Check git status for uncommitted changes
-2. Auto-stage changed files
-3. Generate commit message if not provided:
-   - Format: [ai-generated] {type}: {description}
-   - Types: feat/fix/docs/refactor/test
-4. Ask user to confirm commit message
-5. Commit with message
-6. Pull latest from remote (sync)
-7. Push to remote
-8. 回流平台：提交 + push 后执行回流，把本次 commit 沉淀到平台知识层
-   ```bash
-   R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-   PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
-   $PY "$R/.qoder/scripts/orchestration/wlkj.py" return commit --last
-   ```
-   - 自动取 HEAD commit（sha/message/author/时间）→ POST 平台 `/api/git/commits/record`
-   - message 里的 `[#REQ-xxx]` / `[#<禅道号>]` 平台自动解析，建 commit→需求 边
-   - 失败只告警不阻塞（回流是增强，主流程 commit 已落地）
-
-## Pre-commit Quality Gate
-Before committing, check:
-- [ ] All tests pass (if /wl-test was run)
-- [ ] No TODO/FIXME left in code
-- [ ] Commit tagged [ai-generated] or [ai-assisted]
-- [ ] Commit message 含需求标记 `[#REQ-xxx]` 或 `[#<禅道号>]`（关联平台需求，回流自动建边；多需求 `[#REQ-aaa][#REQ-bbb]`）
-- [ ] Amount fields use BigDecimal (if applicable)
-
-## 下一步
-- 提交回流成功后，更新任务状态：`/wl-task finish <REQ-ID>`（标记开发完成，同步禅道）
-- 查看本次提交在需求链路的位置：平台资产中心 → 需求 → 变更史
+---
+n## 🚨 MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台），绝不跑 wlkj.py kg（本地kg空）。
+
+name: wl-commit
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. "
+argument-hint: "[commit message]"
+auto-approve: false
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-commit - Git Commit + Push + Sync
+
+User input: $ARGUMENTS (commit message)
+
+## Flow
+1. Check git status for uncommitted changes
+2. Auto-stage changed files
+3. Generate commit message if not provided:
+   - Format: [ai-generated] {type}: {description}
+   - Types: feat/fix/docs/refactor/test
+4. Ask user to confirm commit message
+5. Commit with message
+6. Pull latest from remote (sync)
+7. Push to remote
+8. 回流平台：提交 + push 后执行回流，把本次 commit 沉淀到平台知识层
+   ```bash
+   R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+   PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+   $PY "$R/.qoder/scripts/orchestration/wlkj.py" return commit --last
+   ```
+   - 自动取 HEAD commit（sha/message/author/时间）→ POST 平台 `/api/git/commits/record`
+   - message 里的 `[#REQ-xxx]` / `[#<禅道号>]` 平台自动解析，建 commit→需求 边
+   - 失败只告警不阻塞（回流是增强，主流程 commit 已落地）
+
+## Pre-commit Quality Gate
+Before committing, check:
+- [ ] All tests pass (if /wl-test was run)
+- [ ] No TODO/FIXME left in code
+- [ ] Commit tagged [ai-generated] or [ai-assisted]
+- [ ] Commit message 含需求标记 `[#REQ-xxx]` 或 `[#<禅道号>]`（关联平台需求，回流自动建边；多需求 `[#REQ-aaa][#REQ-bbb]`）
+- [ ] Amount fields use BigDecimal (if applicable)
+
+## 下一步
+- 提交回流成功后，更新任务状态：`/wl-task finish <REQ-ID>`（标记开发完成，同步禅道）
+- 查看本次提交在需求链路的位置：平台资产中心 → 需求 → 变更史
 
 
 ## 🚨 接地铁律（防幻觉/保真）