@hupan56/wlkj 3.3.12 → 3.3.14

package/bin/cli.js

@@ -1,13 +1,6 @@
 #!/usr/bin/env node
 // wlkj - workflow toolkit
 
-// Windows 中文乱码修复：cmd/PowerShell 默认 GBK，cli.js 输出 UTF-8 → 乱码
-if (process.platform === "win32") {
-  try { execSync("chcp 65001", { stdio: "ignore" }); } catch (e) {}
-  process.stdout.setDefaultEncoding("utf-8");
-  process.stderr.setDefaultEncoding("utf-8");
-}
-
 const path = require("path");
 const fs = require("fs");
 const { execSync } = require("child_process");
@@ -390,7 +383,7 @@ async function doInit(name, roleArg) {
   console.log(`\n--- 自动初始化 ---`);
   const setupPath = path.join(cwd, ".qoder", "scripts", "deployment", "setup", "setup.py");
   if (fs.existsSync(setupPath)) {
-    const setupArgs = [name, role, "--skip-cron", "--skip-qoderwork", "--skip-code"].filter(Boolean);
+    const setupArgs = [name, role, "--skip-cron", "--skip-qoderwork"].filter(Boolean);
     try {
       const cmd = `python "${setupPath}" ${setupArgs.map(a => `"${a}"`).join(" ")}`;
       console.log(`  运行: setup.py ${setupArgs.join(" ")}`);
@@ -450,21 +443,6 @@ async function doInit(name, roleArg) {
     }
   }
 
-  // === 6.6. 连云平台 bind 项目（云模式：KG 在云平台，引擎调云 MCP）===
-  if (pyCmd) {
-    const switchScript = path.join(cwd, ".qoder", "scripts", "domain", "kg", "switch_project.py");
-    if (fs.existsSync(switchScript)) {
-      console.log(`\n--- 连云平台 bind 项目 ---`);
-      console.log(`  问平台邮箱/密码 → 拉项目列表 → 选项目 → 写 mcp_config（连云）`);
-      try {
-        const env = { ...process.env, PYTHONIOENCODING: "utf-8", PYTHONUTF8: "1" };
-        execSync(`${pyCmd} "${switchScript}"`, { cwd, stdio: "inherit", timeout: 180000, env });
-      } catch (e) {
-        console.log(`  [WARN] 云 bind 未完成，可手动: python .qoder/scripts/domain/kg/switch_project.py`);
-      }
-    }
-  }
-
   // === 7. 写版本戳 ===
   writeEngineVersion(cwd);
 

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "@hupan56/wlkj",
-  "version": "3.3.12",
-  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
-  "bin": {
-    "wlkj": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "templates/",
-    "MAC-VERIFY.md"
-  ],
-  "keywords": [
-    "workflow",
-    "ai",
-    "prd",
-    "pipeline",
-    "qoder",
-    "product",
-    "team"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=16"
-  }
-}
+{
+  "name": "@hupan56/wlkj",
+  "version": "3.3.14",
+  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
+  "bin": {
+    "wlkj": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/",
+    "MAC-VERIFY.md"
+  ],
+  "keywords": [
+    "workflow",
+    "ai",
+    "prd",
+    "pipeline",
+    "qoder",
+    "product",
+    "team"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/templates/qoder/agents/design-agent.md

@@ -0,0 +1,20 @@
+# Design Agent
+
+## Required: Load Context First (Pull-Based)
+Load task context yourself. Run: python .qoder/scripts/orchestration/wlkj.py task current --source
+Then read the PRD from the task directory.
+
+## Recursion Guard
+You are the design-agent. Do NOT spawn another design-agent.
+
+## Your Role
+Transform PRD into design artifacts.
+
+## Workflow
+1. Read PRD from task directory
+2. Analyze UI requirements
+3. Generate design artifacts to workspace/tasks/{id}/design/:
+   - components.json: component tree and specs
+   - interaction-flow.md: user flow and state transitions
+4. Review against PRD acceptance criteria
+5. Submit via /handoff to dev

package/templates/qoder/agents/spec-generator.md

@@ -0,0 +1,21 @@
+# Spec Generator Agent
+
+## Required: Load Context First (Pull-Based)
+Load task context yourself.
+
+## Recursion Guard
+You are the spec-generator. Do NOT spawn another spec-generator.
+
+## Your Role
+Generate technical Spec from PRD + Design.
+
+## Workflow
+1. Read PRD — 先找 `workspace/members/{dev}/drafts/REQ-*.md`，再找 `data/docs/prd/REQ-*.md`，最后 `workspace/specs/prd/`
+2. Read design artifacts from `workspace/tasks/{id}/design/` (若存在)
+3. Read team rules from `.qoder/skills/spec-generator/SKILL.md` + `.qoder/contracts/spec.md` (权威源)；`workspace/constitution/` 有则参考
+4. Generate spec covering:
+   - Architecture changes
+   - Data model changes
+   - API changes
+   - Implementation plan
+5. Save to `workspace/specs/REQ-{ID}-{module}.spec.md` (文件名带 `.spec.md` 后缀，与 contracts/spec.md 契约一致，保证 spec→code→test 贯穿检索)

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. dispatch 到 `qoder-spec-gen` sub-agent（.qoder/agents/qoder-spec-gen.toml — 它读 spec-generator skill + spec 契约自动生成）
+2. Load .qoder/agents/spec-generator.md
 3. Generate spec.md based on PRD + Design
 4. ★ 契约头**必须**写 `status: draft`（wl-code gate 依据）：
    ```markdown
@@ -26,9 +26,7 @@ User input:
 6. Notify dev to review — 提示用户审阅后回复"确认"，确认后改 `status: confirmed`
 7. ★ 用户确认后，上传 spec 到平台（按 zentao_id 反查需求挂载 → 资产中心随需求可见，无需发布）：
    ```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" spec-upload <spec.md> --zentao-id <禅道story号> [--code-targets CtrlA,SvcB]
+   python -m domain.integration.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，不重复建）
@@ -38,11 +36,3 @@ 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,11 +89,3 @@ $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,11 +216,3 @@ 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,9 +22,7 @@ User input: $ARGUMENTS (commit message)
 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
+   python -m domain.integration.return_to_platform commit --last
    ```
    - 自动取 HEAD commit（sha/message/author/时间）→ POST 平台 `/api/git/commits/record`
    - message 里的 `[#REQ-xxx]` / `[#<禅道号>]` 平台自动解析，建 commit→需求 边
@@ -41,11 +39,3 @@ 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-init.md

@@ -1,129 +1,129 @@
----
-name: wl-init
-description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
-argument-hint: "[name] [role]"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
----
-
-# /wl-init - One-stop Init (Developer + Environment Doctor)
-
-Usage:
-  /wl-init              - 体检环境 + 显示状态
-  /wl-init 小王          - 切换/注册开发者 + 体检 + 自动修复
-  /wl-init 小王 pm       - 注册新开发者(带角色) + 体检 + 自动修复
-
-## 🔧 环境自检（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)
-```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
-
-## Engine: init_doctor.py (幂等, 增量, 永不重头再来)
-
-> **鲁棒性保证**：doctor 每项检查独立，**单项失败不阻塞其它项**；无 git 时优雅降级（团队同步/克隆禁用，但本地 PRD/搜索/任务/报告仍可用）。
-> **退出码**：`0` = 全部健康，`1` = 有未解决问题（`--fix` 能修的已自动修）。AI 据此判断"是否可直接开工"。
-
-### Case 1: /wl-init (no arguments)
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor
-```
-Report the doctor's findings to the user in friendly language.
-If it found fixable issues, ask: "发现 N 个问题，要我自动修复吗？"
-then run with --fix.
-
-### Case 2/3: /wl-init 小王 [pm]
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 [pm]
-```
-This single command does ALL of:
-1. 注册/切换开发者 (.qoder/.developer, key=value 格式) + 个人空间目录
-2. 拉取团队最新 (team_sync pull - 拿到别人的 PRD 和最新知识图谱)
-3. 克隆缺失的源码仓库 (按 config.yaml git_sync.projects)
-4. 知识图谱: 7天内新鲜->跳过 / 过期->增量同步 / 缺失->全量构建(仅首次)
-5. 校验风格约束文件 + PRD 模板
-6. 检查周五自动构建状态, 给出本系统的设置命令
-
-After doctor finishes:
-- init_developer auto-registers identity (member.json + signing key)
-- No separate "team.py add" needed anymore
-
-## Incremental Guarantee (为什么不会重头再来)
-
-| 状态 | 行为 |
-|------|------|
-| 本周已 init 过 / 周五任务跑过 | 索引新鲜(≤7天) -> 全部跳过, 秒级完成 |
-| 周五任务没跑/失效 | 索引过期 -> git diff 增量更新, 只处理变更文件 |
-
-## 🔗 平台项目绑定（60 人各用各的项目）
-
-**每个开发者绑定自己的项目。** `/wl-init` 时选择 → 拉 token → 写 mcp_config.json。
-**切换项目 = 重跑 `/wl-init` 选另一个。** 60 人各自选自己的项目，token 绑定到项目，知识层自动隔离。
-
-### 已绑定？（探测多宿主路径）
-```bash
-grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑定" || echo "未绑定"
-```
-
-### 未绑定或要切换？一行命令：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project
-```
-脚本会：
-1. 问邮箱+密码（或用 --email/--pw 参数）
-2. 连平台 `POST /api/auth/bind` 拉项目列表
-3. 列出你的所有项目，选一个
-4. 自动写 mcp_config.json（含该项目的 token + project_id）
-
-非交互模式（CI/自动化）：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project --email a@b.c --pw xxx --project-uuid <UUID>
-```
-
-**之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**
-| 全新机器 | 克隆仓库 + 全量构建一次, 之后永远增量 |
-| 团队其他人已更新图谱 | team_sync pull 直接拿到, 本机不用构建 |
-
-## .developer File Format (MANDATORY)
-
-ALWAYS write `.qoder/.developer` in key=value format:
-```
-name=小王
-role=pm
-initialized_at=2026-06-12T10:00:00
-```
-Do NOT use `name: value` style. (Parsers accept both for legacy files,
-but new writes must use `=`.)
-
-## Git Author Check
-
-The doctor reports if `git config user.name` differs from the developer
-name (it breaks /wl-report's commit statistics). If the user agrees,
-run: `git config user.name {name}`. Do not change it without confirmation.
-
-## Status Display
-After any operation, show:
-```
-Developer: 小王 (pm)
-Team: 3 members (1 PM, 2 Dev)
-Active tasks: 2 (1 in progress, 1 draft)
-知识图谱: 2 天前更新 (新鲜)
-```
-
-## Safety Rules
-- NEVER delete workspace/ content
-- NEVER overwrite member.json or task.json
-- Full index build ONLY when index is completely missing (doctor handles this)
-
-## 产品常踩的坑（遇到时这样解释，别让产品卡住）
-
-| 现象 | 原因 | 怎么说 / 怎么办 |
-|------|------|----------------|
-| `/wl-init --fix` 卡在第 4 项几分钟 | 正在 clone 大源码仓库（fywl-ics 8973 文件） | 告诉用户"首次克隆大仓库要几分钟，属正常，耐心等"。clone 失败（网络/权限）只影响"搜索真实代码"，本地 PRD/任务/报告不受影响 |
-| 搜代码总返回 0 结果 / 生成原型字段全空 | `config.yaml` 的 `platforms.{xx}.project` 写的项目名在 `data/code/` 下不存在（管理员改了 git_sync URL 忘改 platforms） | doctor 第 4 项会报 `platforms.X.project = '...' 但无此目录`。让管理员核对 config.yaml 的 platforms 映射 |
-| `git user.name` 与开发者名不一致警告 | 影响后续 /wl-report 统计 + push 门禁 | doctor 已自动用 `--fix` 修正本仓库 git config。用户未带 `--fix` 时提示重跑 |
-| 没装 git | doctor 第 1 项报 WARN | 不阻塞：本地 PRD/搜索/任务/报告仍可用，只有团队同步/克隆禁用 |
-| 搜出来的代码是旧的 | 知识图谱 >7 天未更新 | doctor 第 5 项会增量同步，`--fix` 自动跑 |
+---
+name: wl-init
+description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
+argument-hint: "[name] [role]"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-init - One-stop Init (Developer + Environment Doctor)
+
+Usage:
+  /wl-init              - 体检环境 + 显示状态
+  /wl-init 小王          - 切换/注册开发者 + 体检 + 自动修复
+  /wl-init 小王 pm       - 注册新开发者(带角色) + 体检 + 自动修复
+
+## 🔧 环境自检（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)
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
+
+## Engine: init_doctor.py (幂等, 增量, 永不重头再来)
+
+> **鲁棒性保证**：doctor 每项检查独立，**单项失败不阻塞其它项**；无 git 时优雅降级（团队同步/克隆禁用，但本地 PRD/搜索/任务/报告仍可用）。
+> **退出码**：`0` = 全部健康，`1` = 有未解决问题（`--fix` 能修的已自动修）。AI 据此判断"是否可直接开工"。
+
+### Case 1: /wl-init (no arguments)
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor
+```
+Report the doctor's findings to the user in friendly language.
+If it found fixable issues, ask: "发现 N 个问题，要我自动修复吗？"
+then run with --fix.
+
+### Case 2/3: /wl-init 小王 [pm]
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 [pm]
+```
+This single command does ALL of:
+1. 注册/切换开发者 (.qoder/.developer, key=value 格式) + 个人空间目录
+2. 拉取团队最新 (team_sync pull - 拿到别人的 PRD 和最新知识图谱)
+3. 克隆缺失的源码仓库 (按 config.yaml git_sync.projects)
+4. 知识图谱: 7天内新鲜->跳过 / 过期->增量同步 / 缺失->全量构建(仅首次)
+5. 校验风格约束文件 + PRD 模板
+6. 检查周五自动构建状态, 给出本系统的设置命令
+
+After doctor finishes:
+- init_developer auto-registers identity (member.json + signing key)
+- No separate "team.py add" needed anymore
+
+## Incremental Guarantee (为什么不会重头再来)
+
+| 状态 | 行为 |
+|------|------|
+| 本周已 init 过 / 周五任务跑过 | 索引新鲜(≤7天) -> 全部跳过, 秒级完成 |
+| 周五任务没跑/失效 | 索引过期 -> git diff 增量更新, 只处理变更文件 |
+
+## 🔗 平台项目绑定（60 人各用各的项目）
+
+**每个开发者绑定自己的项目。** `/wl-init` 时选择 → 拉 token → 写 mcp_config.json。
+**切换项目 = 重跑 `/wl-init` 选另一个。** 60 人各自选自己的项目，token 绑定到项目，知识层自动隔离。
+
+### 已绑定？（探测多宿主路径）
+```bash
+grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑定" || echo "未绑定"
+```
+
+### 未绑定或要切换？一行命令：
+```bash
+$PY "$R/.qoder/scripts/domain/kg/switch_project.py"
+```
+脚本会：
+1. 问邮箱+密码（或用 --email/--pw 参数）
+2. 连平台 `POST /api/auth/bind` 拉项目列表
+3. 列出你的所有项目，选一个
+4. 自动写 mcp_config.json（含该项目的 token + project_id）
+
+非交互模式（CI/自动化）：
+```bash
+$PY "$R/.qoder/scripts/domain/kg/switch_project.py" --email a@b.c --pw xxx --project-uuid <UUID>
+```
+
+**之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**
+| 全新机器 | 克隆仓库 + 全量构建一次, 之后永远增量 |
+| 团队其他人已更新图谱 | team_sync pull 直接拿到, 本机不用构建 |
+
+## .developer File Format (MANDATORY)
+
+ALWAYS write `.qoder/.developer` in key=value format:
+```
+name=小王
+role=pm
+initialized_at=2026-06-12T10:00:00
+```
+Do NOT use `name: value` style. (Parsers accept both for legacy files,
+but new writes must use `=`.)
+
+## Git Author Check
+
+The doctor reports if `git config user.name` differs from the developer
+name (it breaks /wl-report's commit statistics). If the user agrees,
+run: `git config user.name {name}`. Do not change it without confirmation.
+
+## Status Display
+After any operation, show:
+```
+Developer: 小王 (pm)
+Team: 3 members (1 PM, 2 Dev)
+Active tasks: 2 (1 in progress, 1 draft)
+知识图谱: 2 天前更新 (新鲜)
+```
+
+## Safety Rules
+- NEVER delete workspace/ content
+- NEVER overwrite member.json or task.json
+- Full index build ONLY when index is completely missing (doctor handles this)
+
+## 产品常踩的坑（遇到时这样解释，别让产品卡住）
+
+| 现象 | 原因 | 怎么说 / 怎么办 |
+|------|------|----------------|
+| `/wl-init --fix` 卡在第 4 项几分钟 | 正在 clone 大源码仓库（fywl-ics 8973 文件） | 告诉用户"首次克隆大仓库要几分钟，属正常，耐心等"。clone 失败（网络/权限）只影响"搜索真实代码"，本地 PRD/任务/报告不受影响 |
+| 搜代码总返回 0 结果 / 生成原型字段全空 | `config.yaml` 的 `platforms.{xx}.project` 写的项目名在 `data/code/` 下不存在（管理员改了 git_sync URL 忘改 platforms） | doctor 第 4 项会报 `platforms.X.project = '...' 但无此目录`。让管理员核对 config.yaml 的 platforms 映射 |
+| `git user.name` 与开发者名不一致警告 | 影响后续 /wl-report 统计 + push 门禁 | doctor 已自动用 `--fix` 修正本仓库 git config。用户未带 `--fix` 时提示重跑 |
+| 没装 git | doctor 第 1 项报 WARN | 不阻塞：本地 PRD/搜索/任务/报告仍可用，只有团队同步/克隆禁用 |
+| 搜出来的代码是旧的 | 知识图谱 >7 天未更新 | doctor 第 5 项会增量同步，`--fix` 自动跑 |

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

@@ -23,11 +23,6 @@ User input: $ARGUMENTS
 | 生成 PRD 正文 | **Qoder AI** | 宿主 AI 比我们调 qwen-plus 更强 |
 | 写文件 | **Qoder Write** | 原生文件操作 |
 
-## 🚨 工具接口铁律（见 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（完整模式强制前置 · 非建议）
 
 > ⚠️ **完整模式必须先 Planning 再生成**（不再是"建议"）。
@@ -137,12 +132,7 @@ 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
@@ -181,20 +171,6 @@ $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-search.md

@@ -20,27 +20,20 @@ result = cap.mcp.call("rag_search", {"query": "车辆保养", "top_k": 8})
 
 自动路由：有 MCP 走 MCP（直连平台知识层，快），无 MCP 走 wlkj.py（CLI 降级）。零宿主感知。
 
-## 🚨 接口铁律（见 tool_guide · 会话已注入精简版）
+## ⚡ 第一步：先判断问题类型，选对检索通道（3 路检索）
 
-**单一信源** `.qoder/scripts/tool_guide.md`（SessionStart 已注入精简版：repo_root 定位 / 三套名 wlkj·kg·MCP 互通 / 中文歧义词提炼 / 优先级口诀）。需完整三套名映射表或歧义词清单时 Read 它。
-**两条红线常记**：① 三套名字都认（`search`/`semantic`/`context`/`impact`），别因"未知子命令"慌；② 禁 `find`/`grep -r`/`findstr /s` 全盘扫 `data/code`——那是 search 的活，手动做=思考链跑飞。
+**核心升级：本命令有 3 路检索，按问题类型选最合适的一路（不是无脑 search_code）。**
 
+| 问题类型 | 首选检索通道 | 为什么 |
+|---------|-------------|--------|
+| **"车辆保养"相关的代码/字段/API**（语义找相关，词不必一样） | `rag_search` 语义召回 | 能找到"维修记录"即使没共享词，召回最全 |
+| **"这个功能的业务流程是什么 / 整体怎么运转"**（全局问答） | `ask_corpus` GraphRAG 问答 | 用社区摘要直接答，不是堆代码片段 |
+| **"handleExport 这个符号在哪定义/调用"**（精确符号定位） | `search_code` 关键词 | 精确命中，找特定符号最快 |
+| **"XX怎么实现的/怎么做的"**（一次取全代码+API+字段） | `context_pack` | 一条命令拿全 8 段上下文 |
+| **"改 XX 影响谁"** | `get_impact` | 影响分析专用 |
 
-## ⚡ 第一步：确定性路由（按顺序匹配第一个命中信号，零猜测）
-
-**差模型也走得对：逐条检查 `$ARGUMENTS`，第一个命中的信号决定检索通道——不要"判断问题类型"，按表查。**
-
-| # | 信号（`$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`（语义召回最全，能找到没共享词的相关代码，如"车辆保养"→"维修记录"）；只在精确找符号时用 `search_code`；Glob 找不到文件用 `search_code` 兜底，**不准 find/findstr/dir /s 全盘扫**。
+> **顺序铁律**：理解/盘点类问题，**先 rag_search（语义召回最全）**；有"整体流程/业务怎么运转"的全局问题，**再补 ask_corpus（GraphRAG 答案级）**；只在精确找某个符号/特定字符串时才用 search_code。
+> Glob 找不到文件时用 search_code 兜底，**不准跑 find/findstr/dir /s**。
 
 ### 三路检索详解（RAG 升级核心）
 
@@ -213,11 +206,3 @@ $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,9 +35,7 @@ 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`。本地流最快，优先走它。
-- **看我的活**：本地 `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 是哪个需求引入的"。
+- **看任务**：`my_workbench` / `list_my_tasks` / `list_execution_tasks` **默认只返回指派给我的**（assignedTo=我），不会看到队友。要看全队排期才传 `all=true`。
 - **空账号直接拒绝**：member.json 没配 `zentao_account` 时，"看我的"工具返回 `🚫 未识别禅道身份`（不再静默降级返回全队）。原样转述，引导 `/wl-init`。
 - **改任务前必校验**：start/finish/assign/update 拿到 task_id 后，**先 `get_task(id)` 看 assignedTo**：
   - `assignedTo == 我` → 正常执行；
@@ -617,11 +615,3 @@ 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,11 +154,3 @@ 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. **完整**：产物详尽展开（每节实质内容，不一行带过）