@hupan56/wlkj 3.3.7 → 3.3.9

package/package.json

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

package/templates/qoder/commands/optional/wl-spec.md

@@ -12,7 +12,7 @@ User input:
 
 ## Auto Generate Spec
 1. Read current task PRD and design artifacts
-2. Load .qoder/agents/spec-generator.md
+2. dispatch 到 `qoder-spec-gen` sub-agent（.qoder/agents/qoder-spec-gen.toml — 它读 spec-generator skill + spec 契约自动生成）
 3. Generate spec.md based on PRD + Design
 4. ★ 契约头**必须**写 `status: draft`（wl-code gate 依据）：
    ```markdown
@@ -26,7 +26,9 @@ User input:
 6. Notify dev to review — 提示用户审阅后回复"确认"，确认后改 `status: confirmed`
 7. ★ 用户确认后，上传 spec 到平台（按 zentao_id 反查需求挂载 → 资产中心随需求可见，无需发布）：
    ```bash
-   python -m domain.integration.spec_upload <spec.md> --zentao-id <禅道story号> [--code-targets CtrlA,SvcB]
+   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" spec-upload <spec.md> --zentao-id <禅道story号> [--code-targets CtrlA,SvcB]
    ```
    - 契约头无 `platform_spec_id` → `create_spec(zentao_id,...)` 新建 + 平台反查 Requirement 挂上 → `confirm_spec` 进 confirmed → 回写 `platform_spec_id`（幂等锚）
    - 契约头有 `platform_spec_id` → 自动走 `update_spec`（version+1，不重复建）
@@ -36,3 +38,11 @@ User input:
 ## 下一步
 - spec 已 confirmed → `/wl-code <REQ-ID>` 按 spec 严格实现（spec gate 放行）
 - 实现完 → `/wl-test` 验证 → `/wl-commit` 提交回流
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/optional/wl-status.md

@@ -89,3 +89,11 @@ $PY "$R/.qoder/scripts/validation/metrics/usability_score.py" --html
 - **CLI/IDE**（NoOp 自动降级）：落盘 `workspace/members/{dev}/journal/dashboard-{时间戳}.html`，输出路径供打开
 
 不用 cap.present 也能跑——上面的 Health Score 维度表本身是纯文本，富展示只是增强可视化（T244 cap.present 接入点）。
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -216,3 +216,11 @@ cap.mcp.call("learn", {
 })
 ```
 - 至少写 1 条最有价值的认知。try/except 不阻塞。
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -22,7 +22,9 @@ User input: $ARGUMENTS (commit message)
 7. Push to remote
 8. 回流平台：提交 + push 后执行回流，把本次 commit 沉淀到平台知识层
    ```bash
-   python -m domain.integration.return_to_platform commit --last
+   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→需求 边
@@ -39,3 +41,11 @@ Before committing, check:
 ## 下一步
 - 提交回流成功后，更新任务状态：`/wl-task finish <REQ-ID>`（标记开发完成，同步禅道）
 - 查看本次提交在需求链路的位置：平台资产中心 → 需求 → 变更史
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -0,0 +1,46 @@
+---
+name: wl-data
+description: "数据分析: 自然语言→语义层声明metric→接地SQL→保形门禁→执行渲染。不裸NL2SQL盲猜。"
+argument-hint: "[自然语言数据问题]  如：统计各公司资产原值"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-data - 数据分析工序站
+
+User input: $ARGUMENTS
+
+> **问库不乱猜，声明 metric 优先于裸 SQL。** 对齐 dbt 语义层 + conformal 保形门禁。
+
+## 🔧 工具优先级（宿主能力 × 知识层分工）
+| 步骤 | 用谁 | 原因 |
+|------|------|------|
+| 选表选列 | **MCP schema_link** | 确定性概念→真表+列（dbt级，非LLM猜） |
+| join 路径 | **MCP semantic/mapper_joins** | Dijkstra 最高置信 join 路径（RAT-SQL对齐） |
+| NL→metric | **MCP nl2ontology** | 语义层路由：NL→声明metric→grounded SQL（非裸NL2SQL） |
+| 保形门禁 | **MCP gate_check** | conformal coverage≥1-α，低置信拒答 |
+| 执行+渲染 | **Qoder AI** | 执行 SQL + 渲染业务答案 |
+
+## 🧠 流程（确定性语义层 + 保形）
+1. **schema linking**：`schema_link(concept=<问题>)` → 真表+列+join候选
+2. **语义层路由**：`nl2ontology(question=<问题>)` → 命中声明 metric（如 asset_total_cost）→ grounded SQL；未命中走 LLM NL2SQL（只用 schema_link 选表列，禁全表 schema_text 注入=负贡献）
+3. **保形门禁**：`gate_check(sql, confidence, risk_strategy=v2, alpha=0.1)` → pass/abstain；abstain 诚实拒答（不硬编）
+4. **执行+渲染**：执行 SQL（只读）→ Qoder AI 渲染业务答案（表/图）
+
+## 🚨 铁律
+1. **声明优先**：NL 命中声明 metric → 用其 grounded SQL（确定性）；未命中才 LLM 生成
+2. **schema_text 禁注入**：全表 schema 注入 prompt 是负贡献（实测 L1 38→63 是禁 schema 后），只用 schema_link 选表列
+3. **保形拒答**：置信度 < 阈值诚实 abstain，不硬编答案（selective 价值：pass 集准 vs abstain 集）
+4. **只读执行**：SQL 只 SELECT，禁 DDL/DML（data/security.py 白名单 + executor READ ONLY）
+
+## 📊 对齐
+- dbt Semantic Layer（声明 metric）/ MetricFlow（多跳 join）/ conformal prediction（保形 coverage）
+- 平台 workflow_sim WL_WL_DATA_GRAPH（schema_link→LINK→ONTO→SQLGEN→GATE→ANSWER）
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -0,0 +1,47 @@
+---
+name: wl-fix
+description: "修bug: 症状→根因(不治标)→爆炸半径(防回归)→最小侵入修复。"
+argument-hint: "[bug症状/报错]  如：保险导出报空指针"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-fix - bug 修复工序站
+
+User input: $ARGUMENTS
+
+> **治根因不治标，先量爆炸半径防回归。**
+
+## 🔧 工具优先级
+| 步骤 | 用谁 | 原因 |
+|------|------|------|
+| 定位缺陷站点 | **MCP search_code** | 精确符号定位（疑似缺陷文件/符号） |
+| 相似bug模式 | **MCP rag_search** | 历史相似缺陷/修复（kind=code） |
+| 变更史 | **MCP code_history** | regression 根因（该文件历史变更） |
+| 爆炸半径 | **MCP get_impact** | 改一处影响谁（upstream/downstream） |
+| 修复方案 | **Qoder AI** | 综合→最小侵入修复 |
+
+## 🧠 流程
+1. **定位**：`search_code(query=<症状>, focus=symbol)` → 疑似缺陷符号（带 repo 前缀，避 CTRL 双格式坑）
+2. **相似模式**：`rag_search(query=<症状>, kind=code)` → 相似 bug/历史修复
+3. **根因假设**：derive → suspected_location + root_cause + evidence + confidence（<0.5 回扩词重搜）
+4. **爆炸半径**：`get_impact(entity=<suspected_location>, depth=2)` → 影响面（防回归）
+5. **修复方案**：Qoder AI 综合 → 最小侵入修复 + 回归防护
+
+## 🚨 铁律
+1. **根因非症状**：区分表面报错点 vs 真根因，不治标
+2. **爆炸半径**：改前必 get_impact，影响大→人工确认
+3. **最小侵入**：修复尽量小，附带回归测试建议
+4. **置信度诚实**：confidence<0.5 标"根因不确定，建议人工核实"
+
+## 📊 对齐
+- 平台 workflow_sim WL_WL_FIX_GRAPH（search_code→rag→derive根因→get_impact→synth修复）
+- _UNDERUTILIZED_PRE 补 code_history 节点（regression 根因）
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -70,7 +70,7 @@ grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑
 
 ### 未绑定或要切换？一行命令：
 ```bash
-$PY "$R/.qoder/scripts/domain/kg/switch_project.py"
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project
 ```
 脚本会：
 1. 问邮箱+密码（或用 --email/--pw 参数）
@@ -80,7 +80,7 @@ $PY "$R/.qoder/scripts/domain/kg/switch_project.py"
 
 非交互模式（CI/自动化）：
 ```bash
-$PY "$R/.qoder/scripts/domain/kg/switch_project.py" --email a@b.c --pw xxx --project-uuid <UUID>
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project --email a@b.c --pw xxx --project-uuid <UUID>
 ```
 
 **之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**

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

@@ -0,0 +1,41 @@
+---
+name: wl-knowledge
+description: "知识问答: 理解一个对象/概念。三支柱接地(代码+流程+字段)+可溯源答案。"
+argument-hint: "[概念/符号/字段]  如：保险单是什么 / vehicle_no 含义"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-knowledge - 知识问答工序站
+
+User input: $ARGUMENTS
+
+> **理解一个对象，三支柱接地（代码实体 + 业务流程 + 字段schema）。** 与 wl-search(定位/路由) 区别：wl-knowledge 聚焦"讲清一个对象是什么"。
+
+## 🔧 工具优先级
+| 步骤 | 用谁 | 原因 |
+|------|------|------|
+| 提炼概念+意图 | **Qoder AI** | 拆四路：concept/search_query/intent/field_candidates |
+| 代码实体 | **MCP rag_search** | 语义召回相关代码/字段/API |
+| 概念画像 | **MCP context_360** | 实体的代码+API+字段+测试全貌 |
+| 业务流程 | **MCP graphrag_ask** | GraphRAG 社区摘要（全局流程） |
+| 字段schema | **MCP schema_link/query_schema** | 真表结构/字段含义 |
+| 综合答案 | **Qoder AI** | 三支柱接地综合 |
+
+## 🧠 流程
+1. **提炼**：derive → concept(核心对象) + search_query(干净检索词) + intent(concept_explain/business_flow/code_locate/field_schema) + field_candidates
+2. **代码召回**：`rag_search(query=<search_query>)` → 相关代码/字段
+3. **概念画像**：`context_360(query=<concept>)` → 实体全貌
+4. **业务流程**：`graphrag_ask(q=<问题>)` → 全局流程（社区摘要支撑）
+5. **字段schema**：`query_schema(field=<candidate>)` → 真表字段含义
+6. **综合答案**：Qoder AI → 三支柱接地的知识答案
+
+## 🚨 铁律
+1. **三支柱接地**：代码实体 + 业务流程 + 字段schema 都基于真实召回
+2. **意图定重心**：intent=concept_explain 讲概念；business_flow 讲流程；code_locate 定位；field_schema 讲字段
+3. **可溯源**：引用真实符号/表/字段，禁编造
+4. **诚实**：召回不足标"知识层未覆盖"
+
+## 📊 对齐
+- 平台 workflow_sim WL_WL_KNOWLEDGE_GRAPH（derive→rag→context_360→graphrag_ask→query_schema→synth）
+- graphrag_ask 依赖社区摘要（FW17-B1 已修：并发+向量化+pgvector解析）

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

@@ -23,28 +23,10 @@ User input: $ARGUMENTS
 | 生成 PRD 正文 | **Qoder AI** | 宿主 AI 比我们调 qwen-plus 更强 |
 | 写文件 | **Qoder Write** | 原生文件操作 |
 
-## 🚨 工具接口铁律（防思考链跑飞，先读）
-
-**① 一个门面，名字随便叫都对。** 知识查询统一走 `wlkj.py` 或 `kg.py`，**三套名字已互通**（引擎层别名）：
-| 你想干 | wlkj.py | kg.py | MCP 工具名 |
-|---|---|---|---|
-| 搜代码 | `wlkj.py search <词>` | `kg.py search <词>` | search_code |
-| 搜 API | `wlkj.py search <词>` | `kg.py api <词>` | search_api |
-| 语义检索 | `wlkj.py semantic <词>` | `kg.py semantic <词>` | rag_search |
-| 上下文打包 | `wlkj.py context <词>` | `kg.py context <词>` | context_pack |
-> 用哪个名都行（`kg.py search_code` 也认）。**别再因"未知子命令"慌张**。
-
-**② 中文歧义词先提炼再查**（否则 context "保险" 命中的是社保不是车险）：
-- 保险 → 车辆保险 / 商业险 / 交强险 / 保险异常
-- 异常 → 告警 alarmType / 报错 / 校验失败
-- 计划 → 作业计划 / 养护计划 / 计划任务
-- 列表/记录 → 带具体业务对象（车辆保险记录、考勤记录）
-> 拿不准时先 `kg.py search <具体词>` 看返回的控制器/实体名，再用全名 `kg.py context <全名>`。
-
-**③ 禁止跌入手动 grep/find 读源码。** 知识层有就拿知识层；**只有**以下情况才用 Grep/Read 读源码：
-- 知识层确实没建（search 返 0 条，且换词仍 0）
-- 要看某个具体文件的实现细节（已定位到文件）
-> ❌ 不要 `find data/code` / `grep -r` 找模块——那是知识层 search 的活，手动做=思考链跑飞。
+## 🚨 工具接口铁律（见 tool_guide · 会话已注入精简版）
+
+**单一信源** `.qoder/scripts/tool_guide.md`（SessionStart 已注入精简版：repo_root 定位 / 三套名 wlkj·kg·MCP 互通 / 中文歧义词提炼 / 优先级口诀）。需完整三套名映射表或歧义词清单时 Read 它。
+**两条红线常记**：① 三套名字都认（`search`/`semantic`/`context`），别因"未知子命令"慌张；② 禁 `find data/code` / `grep -r` 找模块——那是知识层 search 的活，手动做=思考链跑飞；只有 search 换词仍返 0 或已定位到具体文件时才 Grep/Read。
 
 ## 🧠 Planning Agent（完整模式强制前置 · 非建议）
 
@@ -155,7 +137,12 @@ if schema and schema.get("columns"):
 ```
 等价 CLI（脚本兜底）：
 ```bash
+# ★ 有 REQ-ID 用 ctx-cache：PRD→spec→code 链路同 REQ 复用上下文（T1.3，省 2 次往返）
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" ctx-cache <REQ-ID> <业务词> --platform <web|app>
+# 无 REQ-ID / 首次取：普通 context
 $PY "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <web|app>
+# PRD/spec 改动后失效该 REQ 缓存重来：
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" ctx-cache <REQ-ID> --clear
 ```
 - 第 4 段 = 历史 PRD（防重复）
 - 第 5 段 = 相关 API
@@ -194,6 +181,20 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" eval <prd.md> [原型.html]
 ```
 ≥ 80% 才 PASS。完整模板见 `.qoder/templates/prd-full-template.md`。
 
+### 业务保真打分（接真命令产物 · BF1/BF2）
+
+> EVA 结构分(章齐)≠业务保真。PRD 出来后打业务保真分：产物是不是真 ICS 业务（真表/真写法）。
+```python
+from capability import resolve
+cap = resolve()
+# BF1 schema保真(提的表是真 ICS 业务表) + BF2 内容保真(LLM-judge vs 真 PRD, 是不是 ICS 写法非通用文)
+r = cap.mcp.call("bf_score", {"kind": "prd", "content": "<PRD 正文>", "feature": "<业务主题如 保险>"})
+# → BF1_schema.score(目标≥0.85) + BF2_content.score(目标≥4/5)
+```
+- BF1 低 → PRD 提了编造/非 ICS 表 → 补真表（query_schema/db_tables）。
+- BF2 低 → 内容是通用产品文非 ICS 写法 → 参考 rag_search(kind=prd) 真 PRD 范本重写。
+- 原型保真（BF3 组件/BF4 颜色）：`cap.mcp.call("bf_score", {"kind":"proto","content":"<原型 HTML>"})` → 用真 fywl-ui 设计系统核。
+
 ---
 
 ## 快速模式（6 章 Mini-PRD）

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

@@ -0,0 +1,49 @@
+---
+name: wl-review
+description: "代码审查: 改动影响半径+需求对齐+安全/质量/业务多维审查报告。"
+argument-hint: "[变更实体/diff/分支]  如：CostApplyController"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-review - 代码审查工序站
+
+User input: $ARGUMENTS
+
+> **影响半径 + 需求对齐 + 多维审查，给通过/打回结论。**
+
+## 🔧 工具优先级
+| 步骤 | 用谁 | 原因 |
+|------|------|------|
+| 变更实体 | **Qoder AI 解析** | 从 diff/分支/文件集解析变更符号 |
+| 影响半径 | **MCP get_impact** | 改动影响谁（upstream/downstream） |
+| 全上下文 | **MCP context_360** | 变更实体的代码/API/字段画像 |
+| 需求对齐 | **MCP aggregate_requirement** | 关联需求的 PRD/AC（业务覆盖） |
+| 安全门禁 | **MCP gate_check** | conformal/risk 裁决 |
+| 审查报告 | **Qoder AI** | 多维综合→通过/打回 |
+
+## 🧠 流程
+1. **提取变更**：derive → changed_entities + change_intent + req_key
+2. **影响半径**：`get_impact(entity=<changed>, depth=3)` → 影响面
+3. **全上下文**：`context_360(query=<changed>)` → 实体画像
+4. **需求对齐**：`aggregate_requirement(req_key=<req>)` → PRD/AC（业务覆盖）
+5. **相似实现**：`rag_search(query=<intent>)` → 相似/缺陷模式
+6. **审查焦点**：derive → risk_areas + security + quality + business_gaps + regression_scope
+7. **审查报告**：Qoder AI 综合 → ① 变更范围 ② 安全 ③ 精准度 ④ 需求覆盖 ⑤ 通过/打回
+
+## 🚨 铁律
+1. **只评真实**：变更范围只评 get_impact 命中的真实实体
+2. **PascalCase 引用**：审查实体用原名（CostApplyController），非中文描述（溯源）
+3. **门禁量化**：gate_check 裁决 block/warn/pass
+4. **结论明确**：通过/打回二选一 + 理由
+
+## 📊 对齐
+- 平台 workflow_sim WL_WL_REVIEW_GRAPH（extract→impact→context→requirement→search→focus→report）
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -20,39 +20,27 @@ result = cap.mcp.call("rag_search", {"query": "车辆保养", "top_k": 8})
 
 自动路由：有 MCP 走 MCP（直连平台知识层，快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
 
-## 🚨 接口铁律（防混名/防歧义，先读）
+## 🚨 接口铁律（见 tool_guide · 会话已注入精简版）
 
-**① 三套名字已互通**（引擎层别名，AI 猜哪个都对，别因"未知子命令"慌）：
-| 干啥 | wlkj.py / kg.py 子命令 | MCP 工具名 |
-|---|---|---|
-| 搜代码 | `search <词>` | search_code |
-| 搜 API | `api <词>`（kg.py）/ `search <词>`（wlkj.py）| search_api |
-| 语义检索 | `semantic <词>` | rag_search |
-| 上下文 | `context <词>` | context_pack |
-| 影响分析 | `impact <实体>` | get_impact |
-> `kg.py search_code 保险` = `kg.py search 保险`，都认。
-
-**② 中文歧义词先提炼**（否则"保险"命中社保不是车险）：
-保险→车辆保险/商业险/交强险 · 异常→告警alarmType/报错 · 计划→作业/养护计划 · 列表→带业务对象（车辆保险记录）。
-拿不准先 `search <具体词>` 看返回的控制器名，再用全名 `context <全名>`。
+**单一信源** `.qoder/scripts/tool_guide.md`（SessionStart 已注入精简版：repo_root 定位 / 三套名 wlkj·kg·MCP 互通 / 中文歧义词提炼 / 优先级口诀）。需完整三套名映射表或歧义词清单时 Read 它。
+**两条红线常记**：① 三套名字都认（`search`/`semantic`/`context`/`impact`），别因"未知子命令"慌；② 禁 `find`/`grep -r`/`findstr /s` 全盘扫 `data/code`——那是 search 的活，手动做=思考链跑飞。
 
-**③ 禁止 find/grep 手动找模块**——那是 search 的活。只有 search 换词仍返 0 或要看具体文件实现时，才用 Grep/Read。
 
+## ⚡ 第一步：确定性路由（按顺序匹配第一个命中信号，零猜测）
 
-## ⚡ 第一步：先判断问题类型，选对检索通道（3 路检索）
+**差模型也走得对：逐条检查 `$ARGUMENTS`，第一个命中的信号决定检索通道——不要"判断问题类型"，按表查。**
 
-**核心升级：本命令有 3 路检索，按问题类型选最合适的一路（不是无脑 search_code）。**
-
-| 问题类型 | 首选检索通道 | 为什么 |
-|---------|-------------|--------|
-| **"车辆保养"相关的代码/字段/API**（语义找相关，词不必一样） | `rag_search` 语义召回 | 能找到"维修记录"即使没共享词，召回最全 |
-| **"这个功能的业务流程是什么 / 整体怎么运转"**（全局问答） | `ask_corpus` GraphRAG 问答 | 用社区摘要直接答，不是堆代码片段 |
-| **"handleExport 这个符号在哪定义/调用"**（精确符号定位） | `search_code` 关键词 | 精确命中，找特定符号最快 |
-| **"XX怎么实现的/怎么做的"**（一次取全代码+API+字段） | `context_pack` | 一条命令拿全 8 段上下文 |
-| **"改 XX 影响谁"** | `get_impact` | 影响分析专用 |
+| # | 信号（`$ARGUMENTS` 含这些词） | 走这个通道（直达，先调一次） |
+|---|---|---|
+| 1 | "影响谁" / "改 XX 影响" / "波及" | `get_impact`（影响分析） |
+| 2 | "表结构" / "字段" / "枚举" / "真实数据" / "查库" | DB 通道：**先 `list_envs` 问环境**（见下「数据库查询」） |
+| 3 | "哪些没测" / "覆盖" / "盲区" / "测试矩阵" | `coverage_matrix` |
+| 4 | "业务流程" / "整体怎么运转" / "是干嘛的" | `ask_corpus`（GraphRAG 问答），再叠 `rag_search` 补事实 |
+| 5 | "盘点" / "有哪些代码" / "一次取全" | `context_pack`（8 段一次拿全） |
+| 6 | 精确符号（camelCase / 下划线 / 路径，如 `handleExport`、`/asset`） | `search_code`（精确关键词） |
+| 7 | **（以上都没命中）默认** | **`rag_search`（语义召回最全，top_k=8）** |
 
-> **顺序铁律**：理解/盘点类问题，**先 rag_search（语义召回最全）**；有"整体流程/业务怎么运转"的全局问题，**再补 ask_corpus（GraphRAG 答案级）**；只在精确找某个符号/特定字符串时才用 search_code。
-> Glob 找不到文件时用 search_code 兜底，**不准跑 find/findstr/dir /s**。
+> **铁律**：理解/盘点类问题默认 `rag_search`（语义召回最全，能找到没共享词的相关代码，如"车辆保养"→"维修记录"）；只在精确找符号时用 `search_code`；Glob 找不到文件用 `search_code` 兜底，**不准 find/findstr/dir /s 全盘扫**。
 
 ### 三路检索详解（RAG 升级核心）
 
@@ -225,3 +213,11 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" kg grep-text 车辆不存在 --ext
 - `/wl-search t_quality_case 表结构` → 先 `list_envs()` 问环境 → `query_schema`
 - `/wl-search 资产管理功能画像` → `cap.mcp.call("feature_overview", {"feature": "资产管理"})`
 - `/wl-search 车辆不存在报错从哪来` → `wlkj.py kg grep-text 车辆不存在 --ext java`
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -35,7 +35,9 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 
 禅道是**每人一个账号**（凭据在 `workspace/members/{我}/.private/secrets/zentao.env`，gitignore），归属靠 member.json 的 `zentao_account` 映射 + 工具默认行为兜底：
 
-- **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。
+- **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。本地流最快，优先走它。
+- **看我的活**：本地 `qw_mcp_call("my_workbench")` **优先**（快）；本地不可得（无凭据/进程没起）再降级平台 `cap.mcp.call("get_my_zentao_panel")`（凭据走平台 per-user 配置，云防火墙时 `get_zentao_creds` 取凭据本机直连）。
+- **Bug→需求反查**：`cap.mcp.call("bug_trace", {"bug_id": X})` 查"这个 Bug 是哪个需求引入的"。
 - **空账号直接拒绝**：member.json 没配 `zentao_account` 时，"看我的"工具返回 `🚫 未识别禅道身份`（不再静默降级返回全队）。原样转述，引导 `/wl-init`。
 - **改任务前必校验**：start/finish/assign/update 拿到 task_id 后，**先 `get_task(id)` 看 assignedTo**：
   - `assignedTo == 我` → 正常执行；
@@ -615,3 +617,11 @@ prd ──create(带REQ-ID)──→ task ──start──→ code/test ──f
 ```
 
 > 完整执行规则见 `.qoder/skills/wl-task/SKILL.md`（Quest/QoderWork 自然语言入口）。
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

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

@@ -154,3 +154,11 @@ JUnit 测试（Mock + MockMvc，Given-When-Then）→ 输出 `tests/{package}/{C
 ## 报告
 - quick：用例表 + 执行结果（pass/fail），全过建议继续别的，失败列原因
 - browser：同上 + 建议修复重跑或 `/wl-commit`
+
+
+## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
+
+1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
+2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
+3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
+4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/contracts/insight.md

@@ -0,0 +1,55 @@
+# 模块契约：insight（需求探索）
+
+> 需求上游探索站。在写 PRD 之前把"该做什么、为什么做"想清楚。
+> 四模式：clarify（默认，产品听不懂时对焦）/ discover（发现机会）/ research（调研竞品）/ plan（规划 roadmap）。
+> 与 prd 的分工：insight 想清楚方向，prd 落地怎么做。
+
+---
+
+## Input（吃什么）
+
+| 优先级 | 输入 | 怎么用 |
+|--------|------|--------|
+| **完整** | 一个模糊需求/产品想法 | 先 clarify 对焦，再按需 discover/research/plan |
+| 参考 | 现状代码/业务 | `context_pack` / `feature_overview` 锚定现状，禁止编造 |
+| 参考 | 竞品/外部信息 | research 模式走 WebSearch + 多 agent 调研 |
+
+**第一性原理**：看未来，不编造。结论必须锚定现状（context_pack）。
+
+---
+
+## Output（吐什么）
+
+### 探索产物
+
+```
+路径：data/docs/drafts/
+内含（按模式产出）：
+  insight-plan-{topic}-{date}.md      ← plan 模式：OST/Gap 分析 + MVP + Roadmap
+  research-agent-{N}-{视角}.md        ← research 模式：多视角调研中间产物
+  insight-research-{topic}-{date}.md  ← research 模式：汇总报告
+  clarify-prototype-*.html            ← clarify 模式：帮产品理解的原型（可选）
+```
+
+### 核心方法
+
+- **OST**（Objective-Strategy-Tactic）：目标→策略→战术拆解
+- **JTBD**（Jobs-to-be-done）：用户要完成的"任务"
+- **Gap 分析**：现状 vs 目标的差距 → 机会
+
+---
+
+## 校验（合格标准）
+
+- [ ] 结论锚定现状（引用了 context_pack / 真实代码），非空中楼阁
+- [ ] 全中文输出（语言锁）
+- [ ] 有明确"转 PRD"或"放弃"的建议，不悬空
+- [ ] research 模式：调研有来源，不是泛泛而谈
+
+---
+
+## 不做（边界）
+
+- 不写实现级 PRD（那是 prd 模块的活）
+- 不直接改代码（那是 code 模块的活）
+- discover/research 是辅助决策，**最终是否落地由人决定**