@hupan56/wlkj 2.7.2 → 2.7.4

package/templates/qoder/scripts/platform_doctor.py

@@ -0,0 +1,259 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+platform_doctor.py - 跨平台环境自诊断 (任何 OS 跑, 输出环境真相)
+
+为什么需要它:
+  MAC-VERIFY.md 是人工清单, mac 同事跑完如果失败, 反馈信息往往不够定位。
+  本脚本自动收集所有跨平台关键信息, 一次跑完输出结构化报告,
+  同事直接把输出贴回来即可 —— 无需懂代码。
+
+  它在任何 OS (Windows/macOS/Linux) 上行为一致, 显式报告:
+  - 平台 + 架构
+  - python/python3/node/git 是否可用 + 真实路径
+  - 工作流引擎是否完整 (关键脚本在不在)
+  - MCP 各组件就绪状态
+  - 角色配置
+  - 发现的问题 + 修复建议
+
+Usage:
+    python3 .qoder/scripts/platform_doctor.py
+    # 或 mac 上: python3 platform_doctor.py (从包目录跑也行)
+Exit: 0 = 健康, 1 = 有问题
+"""
+import json
+import os
+import platform
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except (AttributeError, IOError):
+        pass
+
+# 定位仓库根 (和 mcp_launcher 同样的多级回退)
+HERE = Path(__file__).resolve().parent
+BASE = None
+for candidate in [HERE.parent.parent, HERE.parent, HERE]:
+    if (candidate / '.qoder' / 'scripts').is_dir():
+        BASE = candidate
+        break
+if BASE is None:
+    BASE = HERE.parent.parent  # 最佳猜测
+
+report = {'platform': {}, 'tools': {}, 'engine': {}, 'mcp': {},
+          'role': {}, 'issues': [], 'verdict': 'UNKNOWN'}
+
+
+def add_issue(level, msg, fix=None):
+    report['issues'].append({'level': level, 'msg': msg, 'fix': fix or ''})
+
+
+def which(cmd):
+    """找命令路径, 返回字符串或 None。"""
+    return shutil.which(cmd)
+
+
+def run(cmd, timeout=8):
+    """跑命令, 返回 (rc, output)。"""
+    try:
+        r = subprocess.run(cmd, capture_output=True, text=True,
+                           encoding='utf-8', errors='replace', timeout=timeout)
+        return r.returncode, (r.stdout or '').strip()
+    except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
+        return 1, ''
+
+
+# ============================================================
+# 1. 平台信息
+# ============================================================
+report['platform'] = {
+    'sys_platform': sys.platform,
+    'platform_system': platform.system(),
+    'machine': platform.machine(),
+    'python_version': sys.version.split()[0],
+    'python_executable': sys.executable,
+}
+plat_name = platform.system()
+is_mac = sys.platform == 'darwin'
+is_win = sys.platform == 'win32'
+print('【平台】 %s %s (sys.platform=%s)' % (
+    plat_name, platform.machine(), sys.platform))
+print('  Python: %s @ %s' % (sys.version.split()[0], sys.executable))
+
+# ============================================================
+# 2. 工具探测 (python/python3/node/git/brew)
+# ============================================================
+print('\n【工具探测】')
+for tool in ['python', 'python3', 'node', 'npm', 'npx', 'git']:
+    if is_mac and tool == 'python':
+        # mac 上 python 通常不存在, 这是正常的
+        pass
+    p = which(tool)
+    ver = ''
+    if p:
+        if tool in ('python', 'python3'):
+            rc, v = run([tool, '--version'])
+            ver = v or '(版本未知)'
+        elif tool in ('node',):
+            rc, v = run([tool, '--version'])
+            ver = v
+        elif tool == 'git':
+            rc, v = run([tool, '--version'])
+            ver = v
+    report['tools'][tool] = {'path': p, 'version': ver}
+    status = '✓ %s' % ver if p else '✗ 未找到'
+    print('  %-8s %s' % (tool, status))
+
+# 关键: python/python3 关系 (mac 验证核心)
+py = which('python')
+py3 = which('python3')
+if is_mac and not py and py3:
+    print('  [mac 正常] python 不存在, python3 可用 (cli.js detectPyCmd 会选 python3)')
+elif not py and not py3:
+    add_issue('CRITICAL', 'python 和 python3 都没找到',
+              'mac: brew install python@3.12; win: 装 Python 勾 Add to PATH')
+elif not py3 and py:
+    add_issue('WARN', '只有 python 没有 python3 (罕见, 一般不影响)')
+
+if is_mac:
+    brew = which('brew')
+    print('  brew:    %s' % (brew or '✗ (装包用: https://brew.sh)'))
+
+# ============================================================
+# 3. 引擎完整性
+# ============================================================
+print('\n【工作流引擎】')
+scripts_dir = BASE / '.qoder' / 'scripts'
+key_scripts = [
+    'setup.py', 'kg.py', 'context_pack.py', 'search_index.py',
+    'mcp_launcher.py', 'install_qoderwork.py', 'role.py',
+    'common/pip_install.py', 'common/events.py', 'common/platform_guard.py',
+    'check_mcp.py', 'check_carriers.py',
+]
+missing_scripts = []
+for s in key_scripts:
+    exists = (scripts_dir / s).is_file()
+    if not exists:
+        missing_scripts.append(s)
+    report['engine'][s] = exists
+
+if missing_scripts:
+    add_issue('CRITICAL', '引擎脚本缺失: %s' % ', '.join(missing_scripts),
+              '跑: npx @hupan56/wlkj update')
+    print('  ✗ 缺失: %s' % ', '.join(missing_scripts))
+else:
+    print('  ✓ %d 个关键脚本齐全' % len(key_scripts))
+
+# 引擎版本
+ver_file = BASE / '.qoder' / '.engine-version'
+if ver_file.is_file():
+    ver = ver_file.read_text(encoding='utf-8').strip()
+    report['engine']['version'] = ver
+    print('  引擎版本: %s' % ver)
+
+# ============================================================
+# 4. MCP 组件
+# ============================================================
+print('\n【MCP 组件】')
+# 4.1 mcp.json
+HOME = Path(os.environ.get('USERPROFILE') or os.path.expanduser('~'))
+mcp_file = HOME / '.qoderwork' / 'mcp.json'
+if mcp_file.is_file():
+    try:
+        cfg = json.loads(mcp_file.read_text(encoding='utf-8'))
+        servers = list(cfg.get('mcpServers', {}).keys())
+        report['mcp']['servers'] = servers
+        print('  mcp.json: %d 个 server (%s)' % (len(servers), ', '.join(servers)))
+    except (ValueError, OSError):
+        add_issue('WARN', 'mcp.json 解析失败', '重跑 install_qoderwork.py --mcp-only')
+        print('  mcp.json: 解析失败')
+else:
+    add_issue('WARN', 'mcp.json 不存在 (QoderWork 未配 MCP)',
+              '跑: python .qoder/scripts/install_qoderwork.py --mcp-only')
+    print('  mcp.json: 不存在')
+
+# 4.2 .repo-root 锚点
+anchor = HOME / '.qoderwork' / '.repo-root'
+if anchor.is_file():
+    root_val = anchor.read_text(encoding='utf-8').strip()
+    is_correct = (Path(root_val) / '.qoder' / 'scripts').is_dir()
+    report['mcp']['repo_root'] = root_val
+    if is_correct:
+        print('  .repo-root: ✓ 指向 %s' % root_val)
+    else:
+        add_issue('CRITICAL', '.repo-root 指向错误目录: %s' % root_val,
+                  '跑: python install_qoderwork.py --mcp-only (会用 PROJECT_ROOT 修复)')
+        print('  .repo-root: ✗ 指向错误 %s' % root_val)
+else:
+    add_issue('WARN', '.repo-root 锚点不存在',
+              '跑: install_qoderwork.py --mcp-only')
+    print('  .repo-root: 不存在')
+
+# 4.3 duckdb (kg MCP 依赖)
+try:
+    import duckdb
+    print('  duckdb: ✓ 已装 (kg MCP 可用)')
+    report['mcp']['duckdb'] = True
+except ImportError:
+    add_issue('CRITICAL', 'duckdb 未装 (kg MCP 会崩)',
+              'pip install duckdb 或 npx wlkj install-env')
+    print('  duckdb: ✗ 未装')
+
+# ============================================================
+# 5. 角色配置
+# ============================================================
+print('\n【角色配置】')
+dev_file = BASE / '.qoder' / '.developer'
+if dev_file.is_file():
+    lines = dev_file.read_text(encoding='utf-8').split('\n')
+    name_l = next((l for l in lines if l.startswith('name=')), '')
+    role_l = next((l for l in lines if l.startswith('role=')), '')
+    name = name_l.split('=', 1)[1].strip() if name_l else '?'
+    role = role_l.split('=', 1)[1].strip() if role_l else 'pm(默认)'
+    report['role'] = {'name': name, 'role': role}
+    print('  开发者: %s' % name)
+    print('  角色: %s' % role)
+    if not role_l:
+        add_issue('INFO', '角色未显式设置 (默认 pm)',
+                  '重跑 init 选角色: npx wlkj init %s <pm|design|dev|test|admin>' % name)
+else:
+    add_issue('CRITICAL', '.developer 不存在 (未初始化)',
+              '跑: npx @hupan56/wlkj init <名字> <角色>')
+    print('  未初始化!')
+
+# ============================================================
+# 6. 总结
+# ============================================================
+criticals = [i for i in report['issues'] if i['level'] == 'CRITICAL']
+warns = [i for i in report['issues'] if i['level'] == 'WARN']
+
+print('\n' + '=' * 56)
+if criticals:
+    print('发现 %d 个严重问题:' % len(criticals))
+    for i in criticals:
+        print('  🔴 %s' % i['msg'])
+        if i['fix']:
+            print('     修复: %s' % i['fix'])
+    report['verdict'] = 'BROKEN'
+elif warns:
+    print('发现 %d 个警告 (非阻塞, 但建议处理):' % len(warns))
+    for i in warns:
+        print('  🟡 %s' % i['msg'])
+        if i['fix']:
+            print('     建议: %s' % i['fix'])
+    report['verdict'] = 'OK_WITH_WARNINGS'
+else:
+    print('✓ 环境健康, 工作流可用。')
+    report['verdict'] = 'HEALTHY'
+print('=' * 56)
+
+# 机器可读报告 (便于同事贴回来)
+print('\n--- 可粘贴报告 (JSON) ---')
+print(json.dumps(report, ensure_ascii=False, indent=2))
+
+sys.exit(1 if criticals else 0)

package/templates/qoder/commands/wl-design-draw.md

@@ -1,78 +0,0 @@
----
-name: wl-design-draw
-description: "画界面/原型。说你要什么，AI 画出来。新页面、改页面、参考竞品都行。"
-argument-hint: "<你要画什么>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu]
----
-
-# /wl-design-draw - 画界面
-
-User input: $ARGUMENTS
-
-> 用户说"画什么"，AI 画出来。就这么简单。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## Step 1: 平台（问了就停）
-
-```
-这个界面是针对哪个平台？
-1. Web 管理端 (fywl-ui)
-2. APP 移动端 (Carmg-H5)
-3. 两端都要
-请选择 (1/2/3):
-```
-
-## Step 2: 如果输入是大板块，先缩小到具体页面
-
-"资产"有 38 个页面，不能直接画。调 `mcp__qoder-knowledge-graph__feature_overview(feature='资产')`，
-列出页面问用户选哪个（**问了就停**）。
-
-具体功能（如"营业外合同筛选"）跳过这步。
-
-## Step 3: 画
-
-**先拿设计约束 + 真实数据（不许跳过，不许手写 HTML）：**
-
-```
-mcp__qoder-knowledge-graph__get_design_system(platform='web')                         → 颜色/布局/按钮/组件
-mcp__qoder-knowledge-graph__fill_prototype(keyword='营业外合同', platform='web')        → 80% 草稿
-```
-
-FALLBACK（无 MCP 时）：
-```bash
-python "$R/.qoder/scripts/gen_design_doc.py"
-python "$R/.qoder/scripts/fill_prototype.py" 营业外合同 --platform web
-```
-
-**拿到草稿后微调：**
-- 按钮用真实文案（数据清单里的，不是编的"新增/编辑"）
-- 补交互细节（弹窗/Tab/折叠）
-- 画完整状态（有数据 + 空状态 + 加载中）
-- **颜色/宽度/间距不许改**（来自真实系统，AI 猜的一定不对）
-
-## 铁律
-
-1. **必须先调 get_design_system + fill_prototype**，不许跳过直接手写
-2. **若设计师录入了蓝湖 spec，fill_prototype 会自动注入**——先确认 `data/style/{关键词}-design-spec.json` 是否存在。若有，fill_prototype 会把蓝湖的真实 `design_tokens`（如 `rgba(255,115,10,1)`）原样注入原型 `:root`，**这一步全自动，不用手动调蓝湖**。验证：看输出原型 `:root` 里有没有 `/* design-import spec tokens (优先级最高) */`
-3. **颜色只用真源**（蓝湖 spec 注入值 > get_design_system 的 HSL，不是 #1890ff）
-4. **按钮用真实文案**（entity-registry 的，不是编的）
-5. **布局参数不猜**（蓝湖 spec 的 width 或 layout_fingerprint 的 160px）
-6. **图标禁 emoji**（Web 用 Ant Design SVG，APP 用 Vant 字体图标）
-7. **画完整状态**（不只画"有数据"，还要画空状态/加载中/错误）
-
-> 蓝湖与画图的关系：**蓝湖在录入环节（/wl-design-spec）发力**，读出的 CSS 值存进 spec.json；
-> 画图时 fill_prototype 自动消费 spec.json，不需要 draw 再调蓝湖。蓝湖没起/没录入？不影响 draw，
-> fill_prototype 降级用 layout_fingerprint + 代码风格，照样出原型（只是不如蓝湖精确）。
-
-## 存储与 Figma
-
-存到 `workspace/members/{developer}/drafts/prototype-{feature}.html`。
-设计师可在 Figma 用 html.to.design 插件导入精修。

package/templates/qoder/commands/wl-design-scan.md

@@ -1,108 +0,0 @@
----
-name: wl-design-scan
-description: "扫描/审视系统现状。看功能模块有哪些页面/按钮/流程/风格/测试覆盖。画原型前必做。"
-argument-hint: "<功能模块名或关键词>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, mcp__qoder-knowledge-graph]
----
-
-# /wl-design-scan - 审视系统现状
-
-User input: $ARGUMENTS
-
-> 画之前先看。设计师/PM 需要理解"系统现在长什么样"才能动手。
-> 这是业界 Discover 阶段的工具——understand before you design。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## 第一步：判断用户想看什么
-
-| 用户说什么 | 调什么 | 返回什么 |
-|-----------|--------|---------|
-| "XX 有哪些页面""XX 功能模块" | `feature_overview(feature='XX')` | 页面列表 + 端点数 + 按钮数 + 测试数 |
-| "XX 的操作流程""XX 业务流程" | `get_workflow(module='XX')` | 操作链（查询→新增→审批→...） |
-| "XX 用什么风格""系统主色" | `get_design_system(platform='web')` | token + 布局指纹 + 组件表 + 真实按钮 |
-| "XX 有没有测试""XX 测试覆盖" | `coverage_matrix()` | 17 个功能的测试覆盖红黄绿 |
-| "改 XX 影响什么" | `get_impact(endpoint='XX')` | 影响页面数 + 操作数 + 可回归测试 |
-| "XX 按钮 调什么接口" | `context_360(symbol='handleXX')` | 按钮关联的 API + Controller + 调用链 |
-| 模糊 | 先问 | "你想看功能模块、操作流程、设计风格、测试覆盖、还是影响分析？" |
-
-## 第二步：执行查询
-
-**PREFERRED: MCP 工具**（QoderWork 有 MCP 时直接调）
-```
-mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')
-mcp__qoder-knowledge-graph__get_workflow(module='资产')
-mcp__qoder-knowledge-graph__get_design_system(platform='web')
-```
-
-**FALLBACK: Python 脚本**
-```bash
-python "$R/.qoder/scripts/search_index.py" 资产 --platform web
-python "$R/.qoder/scripts/search_index.py" --style table --platform web
-python "$R/.qoder/scripts/search_index.py" --field assetName
-```
-
-## 第三步：结构化输出
-
-不是简单返回数据，而是**帮用户理解**：
-
-### 功能模块视图（用户说"XX 有哪些页面"时）
-```
-📊 资产管理 (assets) 模块全景
-   页面: 38 个
-   API: 12 个端点
-   按钮: 108 个操作
-   测试: 3 个测试用例 (覆盖率偏低 ⚠️)
-
-   主要页面类型:
-   - table-page: 20 个 (异常申请/记录/分析...)
-   - form-page: 12 个 (新增/编辑/审批...)
-   - dashboard: 3 个 (资产看板)
-   - detail-page: 3 个
-
-   标杆页面 (最适合做参考的):
-   1. assets/abnormal/apply/index.vue (异常申请, 19个字段)
-   2. assets/abnormalManage/abnormalAnalysis/index.vue (分析看板)
-```
-
-### 操作流程视图（用户说"XX 流程"时）
-```
-🔄 资产管理操作链 (7 步)
-   查询 → 新增 → 提交 → 审批 → 归档 → 导出 → 删除
-
-   ⚠️ 步骤较多 (7步), 考虑优化:
-   - 第3步"提交"和第4步"审批"可能合并
-   - 第6步"导出"可放到工具栏, 不算独立步骤
-```
-
-### 设计风格视图（用户说"XX 风格"时）
-```
-🎨 fywl-ui 设计指纹
-   主色: hsl(214.58, 86.34%, 59.8%) (Vben 蓝)
-   侧边栏: 160px, 浅色, mixed-nav 布局
-   顶栏: 深色, 含 logo + 通知 + 头像
-   圆角: 0.25rem
-   字体: -apple-system, BlinkMacSystemFont, ...
-
-   真实按钮文案示例: 添加反馈资产, 导出Excel, 批量导入, ...
-   常用组件: Modal(273次), Input(135次), FormItem(95次), ...
-```
-
-## 使用示例
-
-```
-/wl-design-scan 资产管理         → 功能模块全景
-/wl-design-scan 资产的操作流程    → 操作链分析
-/wl-design-scan 系统设计风格      → 设计 token + 布局指纹
-/wl-design-scan 哪些功能没测试    → 覆盖矩阵
-/wl-design-scan 改 /asset 影响    → 影响分析
-```
-
-> scan 不产出文件，只返回结构化分析。帮设计师/PM"看清楚"再动手。

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

@@ -1,154 +0,0 @@
----
-name: wl-design-spec
-description: "设计交付。录入设计稿→spec.json + 评审原型合规性。设计师和系统对接的唯一入口。"
-argument-hint: "<录入|评审> <描述>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu]
----
-
-# /wl-design-spec - 设计交付
-
-User input: $ARGUMENTS
-
-> 设计的终点：把设计意图"规格化"让前端能实现，并评审原型是否合规。
-> 包含两个动作：**录入**（设计师→系统）和**评审**（系统→设计师）。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## 第一步：判断用户要做哪个动作
-
-| 用户说什么 | 动作 | 跳到 |
-|-----------|------|------|
-| "录入""这是 Figma 稿""把这个设计录进去""设计稿录入" | **录入** | 录入段 |
-| "评审""检查""看看这个原型""合规吗" | **评审** | 评审段 |
-| 模糊 | 先问 | "你是要录入设计稿，还是评审现有原型？" |
-
----
-
-## 录入（设计师把 Figma 稿变成 spec.json）
-
-**铁律：平台必须先问。** 问完就停。
-
-### 流程
-
-完整执行见 `.qoder/skills/design-import/SKILL.md`：
-
-1. **录入前先看现状**（让 spec 不是凭空设计，是基于系统增量改进）：
-   ```
-   mcp__qoder-knowledge-graph__feature_overview(feature='资产')     → 这个模块现有页面/按钮
-   mcp__qoder-knowledge-graph__get_workflow(module='资产')           → 现有操作流程
-   mcp__qoder-knowledge-graph__get_design_system(platform='web')     → 现有 token/布局/组件
-   ```
-   设计师据此知道"系统现在有什么、我的设计改了什么"。
-
-2. **收集设计信息**（按精度从高到低）：
-   - **蓝湖链接（最推荐）**：设计师发 `https://lanhuapp.com/web/#/item/...`，走 4 步直读
-     （详见 design-import/SKILL.md 方式 A）：
-       ① `mcp__lanhu__get_designs(url)` 探测+列图（失败就降级截图口述，不报错）
-       ② 让设计师选哪张图（**问了就停**）
-       ③ `mcp__lanhu__get_ai_analyze_design_result(url, design_names)` 读 CSS 标注+切图
-       ④ AI 语义映射进 spec.json（出现最多的色→主色，width→侧边栏...）
-     - **铁律：蓝湖 CSS 值原样填**。`rgba(255,115,10,1)` 不写成 `#FF730A`，`200px` 不四舍五入
-     - STDIO 自动开关（开 QoderWork 自动起/关自动停，无需手动 start）；cookie 按角色在 `workspace/members/{当前用户}/.secrets/lanhu.env`
-   - **截图 + 口述**（蓝湖不可用时降级）：设计师发一张 Figma 截图，口述关键决策
-   - **导出标注**（CSS / JSON / PDF）
-   - **参照现有页面改**（"类似 XX 页面，但侧边栏改成手风琴"）
-
-3. **生成 spec.json**，结构包含：
-   ```json
-   {
-     "platform": "web",
-     "requirement": "异常资产申请页改版",
-     "design_tokens": { "--primary-color": "rgba(255,115,10,1)", "--sidebar-width": "160px" },
-     "layout": { "description": "...", "sidebar": "...", "content": "..." },
-     "components": [{ "name": "...", "spec": "..." }],
-     "behaviors": { "sidebar_collapse": "click", "form_mode": "wizard" },
-     "source": "蓝湖直读 (设计师: XXX)",
-     "lanhu_source": { "url": "...", "image_names": ["..."] }
-   }
-   ```
-   > ⚠️ `requirement` 必须跟未来 `/wl-design-draw` 关键词一致（fill_prototype 靠它匹配）。
-   > 蓝湖来源填 `"source": "蓝湖直读 (...)"` + `lanhu_source`；截图口述只填 `source`。
-
-4. **存储到** `data/style/{需求名}-{平台}-design-spec.json`（平台=web/app，避免同功能多端冲突；同需求同平台重录=覆盖更新）
-   > `requirement` 用"功能名+同义词"（如 `待办 我的待办 设置待办`），让 PM 搜各种词都能命中。
-
-5. **优先级声明**：spec.json > 代码风格 > PDF 规范
-   一旦录入，同需求的 `/wl-design-draw` 必须锚定它。
-
-### 铁律
-
-- **绝不编造 token**：设计师没说的值，留空或标"待确认"
-- **图标必须来自真源**：即使设计师用 emoji 示意，录入时替换成系统真源
-  （Web: `data/index/ref-icon.json` Ant Design SVG；APP: Vant 字体图标）
-- **录入后同需求原型必须锚定它**
-
-### 完成提示
-
-```
-✅ 设计规范已录入: data/style/{需求名}-design-spec.json
-   下次 /wl-design-draw 同关键词时，会自动优先用这份 spec。
-   设计师可随时 /wl-design-spec 录入 更新它。
-```
-
-### Figma 协作流程
-
-设计师在 Figma 精修完设计稿后，导出/截图，用 `/wl-design-spec 录入` 录入。
-完整 Figma 协作指南见 `.qoder/skills/design-import/figma-workflow.md`。
-
----
-
-## 评审（检查原型是否合规）
-
-完整执行见 `.qoder/skills/design-review/SKILL.md`。
-
-读最新的 `workspace/members/{dev}/drafts/prototype-*.html`，按 checklist 评审：
-
-### 评审 checklist
-
-**视觉合规：**
-- [ ] 颜色来自真源（get_design_system 的 HSL token，不是 #1890ff）
-- [ ] 图标来自真源（ref-icon.json 的 SVG，无 emoji）
-- [ ] 侧边栏宽度 = layout_fingerprint 值（fywl-ui 是 160px）
-- [ ] 字体/圆角/间距跟系统一致
-
-**内容合规：**
-- [ ] 按钮文案用了系统真实文案（entity-registry，非编的"新增/编辑"）
-- [ ] 表格列/表单字段来自真实代码（fill_prototype 数据清单）
-- [ ] 若设计师 spec 存在：原型匹配 spec 的布局/配色/组件
-
-**交互合规：**
-- [ ] 交互流程闭环（对照 get_workflow 的操作链，原型覆盖了全部步骤）
-- [ ] 包含完整状态（有数据/空状态/加载中/错误）
-- [ ] 布局跟同功能模块标杆页面一致（对照 feature_overview）
-
-**测试影响：**
-- [ ] 若改动页面有测试覆盖（coverage_matrix），提醒"改动后需回归测试"
-
-### 评审时可调 MCP 工具
-
-- `mcp__qoder-knowledge-graph__feature_overview(feature='XX')` → 功能画像，对比原型是否遗漏
-- `mcp__qoder-knowledge-graph__get_workflow(module='XX')` → 操作链，检查原型是否覆盖完整流程
-- `mcp__coverage_matrix()` → 测试覆盖，判断改动是否需回归
-- `mcp__qoder-knowledge-graph__get_design_system(platform='web')` → 真实 token/按钮做对照
-
-### 输出
-
-报告：PASS 或 🔴/🟡 问题清单（不产文件，只出报告）。
-若不通过，附上修复建议和参考文件路径。
-
----
-
-## 使用示例
-
-```
-/wl-design-spec 录入 这个 Figma 稿        → 录入设计稿
-/wl-design-spec 评审 最新原型              → 评审原型
-/wl-design-spec 这个按钮文案对不对         → 评审（按钮文案检查）
-```