@hupan56/wlkj 3.1.6 → 3.1.8

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "@hupan56/wlkj",
-  "version": "3.1.6",
-  "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.1.8",
+  "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/commands/wl-req.md

@@ -1,4 +1,5 @@
 ---
+name: wl-req
 description: "需求管理: 看需求/看产出/发布"
 argument-hint: "[REQ-ID] [发布]"
 ---

package/templates/qoder/scripts/domain/design/gen_design_doc.py

@@ -10,7 +10,7 @@ for _ in range(10):
         break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
-from foundation.core.paths import get_repo_root
+from foundation.core.paths import get_repo_root
 
 """
 gen_design_doc.py - 自动生成 DESIGN.md (给 AI 的设计系统说明书)
@@ -43,7 +43,7 @@ except (AttributeError, TypeError, OSError, IOError):
     except Exception:
         pass
 
-BASE = get_repo_root()
+BASE = get_repo_root()
 INDEX_DIR = os.path.join(BASE, 'data', 'index')
 OUTPUT_DIR = os.path.join(BASE, 'data', 'design')
 
@@ -269,8 +269,14 @@ def gen_design_doc():
         lines.append(f'- `{field_name}` -> {title} (used {count}x)')
     lines.append('')
 
-    # ========== 4.5 Feature Modules (from prd-features.json) ==========
-    pf = load_json('prd-features.json')
+    # ========== 4.5 Feature Modules (from prd-features.json, DuckDB-backed) ==========
+    # prd-features.json 文件不存在, 真实数据在 DuckDB entities(FEATURE 行)。
+    # 用 search_index.load_index 走 DuckDB (load_json 只读文件, 永远返回 {})。
+    try:
+        from domain.kg.search.search_index import load_index as _load_idx
+        pf = _load_idx('prd-features.json') or {}
+    except Exception:
+        pf = load_json('prd-features.json')
     features = pf.get('features', {}) if isinstance(pf, dict) else {}
     if features:
         lines.append('## 4.5 Feature Modules (系统有哪些功能模块)')
@@ -288,8 +294,14 @@ def gen_design_doc():
                 lines.append(f'  - 标杆页面: {sample_pages}')
         lines.append('')
 
-    # ========== 4.6 Real Buttons (from entity-registry.json) ==========
-    er = load_json('entity-registry.json')
+    # ========== 4.6 Real Buttons (from entity-registry.json, DuckDB-backed) ==========
+    # entity-registry.json 文件不存在, 真实数据在 DuckDB entities(BUTTON 行, 2675 个)。
+    # 用 search_index.load_index 走 DuckDB (load_json 只读文件, 永远返回 {} → 按钮段永远空)。
+    try:
+        from domain.kg.search.search_index import load_index as _load_idx
+        er = _load_idx('entity-registry.json') or {}
+    except Exception:
+        er = load_json('entity-registry.json')
     entities = er.get('entities', {}) if isinstance(er, dict) else {}
     button_samples = []
     for eid, info in list(entities.items())[:500]:

package/templates/qoder/scripts/domain/kg/build/learn_aggregate.py

@@ -1,17 +1,6 @@
 # -*- coding: utf-8 -*-
 """learn_aggregate.py - 团队学习聚合 (同构 kg_build.py)
 
-# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
-import os as _o, sys as _s
-_f = _o.path.abspath(__file__)
-for _ in range(10):
-    _f = _o.path.dirname(_f)
-    _cp = _o.path.join(_f, 'foundation')
-    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
-        break
-if _cp not in _s.path: _s.path.insert(0, _cp)
-from bootstrap import setup; setup()
-
 扫所有人的 workspace/members/{dev}/journal/feedback.jsonl
 → 增量写入 kg.duckdb 的 learning_events 表 (团队单一真源)
 
@@ -26,6 +15,19 @@ from bootstrap import setup; setup()
   python learn_aggregate.py            # 增量
   python learn_aggregate.py --rebuild  # 全量重建
 """
+# v3.0 路径自举: 引导到 foundation/bootstrap, 统一 sys.path 逻辑
+# ⚠ 必须在 module docstring 之外! 旧版把这块包进 docstring → bootstrap 永不执行
+#    → from foundation... ModuleNotFoundError → 学习聚合全链路死。
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 import os
 import sys
 import json
@@ -33,9 +35,6 @@ import hashlib
 import time
 from datetime import datetime
 
-SCRIPTS = os.path.dirname(os.path.abspath(__file__))
-sys.path.insert(0, SCRIPTS)
-
 from foundation.core.paths import MEMBERS_DIR
 from domain.kg.storage.kg_duckdb import get_db, init_schema  # v3.0: kg_duckdb 已迁入 kg/ 子包
 

package/templates/qoder/scripts/domain/kg/search/search_index.py

@@ -258,6 +258,42 @@ def _duckdb_load(filename):
                 result[proj] = {'files': vf or 0, 'classes': 0, 'apis': 0}
             return result if result else None
 
+        elif filename == 'entity-registry.json':
+            # 实体注册表 (fill_prototype 取真实按钮文案 / gen_design_doc 取按钮样本)。
+            # 真实数据在 DuckDB entities 表 (6131 行: BUTTON/ENDPOINT/FEATURE/...),
+            # 不再有 entity-registry.json 文件 (kg.py 注释: 通常不存在)。
+            # 重建为 {'entities': {id: {'type':..., 'canonical':..., 'cn':..., 'properties': props}}}
+            # 消费方 extract_real_buttons 读 entities[eid]['properties']['button_text']。
+            def _entity_loader(con):
+                rows = con.execute("SELECT id, type, canonical, cn, props FROM entities").fetchall()
+                result = {'entities': {}}
+                for eid, etype, canon, cn, props in rows:
+                    try:
+                        props_d = json.loads(props) if props else {}
+                    except Exception:
+                        props_d = {}
+                    result['entities'][eid] = {
+                        'type': etype, 'canonical': canon, 'cn': cn or '',
+                        'properties': props_d,
+                    }
+                return result if result['entities'] else None
+            return _load_with_pickle_cache(con, 'entity-registry', _entity_loader)
+
+        elif filename == 'prd-features.json':
+            # 从 entities 表 FEATURE 行重建 (prd-features.json 文件不存在)。
+            # gen_design_doc 取 feature 模块样本。结构: {'features': {canonical: {'cn':..., 'properties':...}}}
+            def _feature_loader(con):
+                rows = con.execute("SELECT id, canonical, cn, props FROM entities WHERE type='FEATURE'").fetchall()
+                result = {'features': {}}
+                for eid, canon, cn, props in rows:
+                    try:
+                        props_d = json.loads(props) if props else {}
+                    except Exception:
+                        props_d = {}
+                    result['features'][canon or eid] = {'cn': cn or '', 'id': eid, 'properties': props_d}
+                return result if result['features'] else None
+            return _load_with_pickle_cache(con, 'prd-features', _feature_loader)
+
     except Exception:
         return None
     return None

package/templates/qoder/scripts/domain/report/status_snapshot.py

@@ -141,16 +141,25 @@ def snapshot(repo=None):
     data["index_age_days"] = _index_freshness(meta)
 
     # 3. EVA 评估历史 (健康度趋势)
-    data["eval_history"] = _read_jsonl_tail(
-        os.path.join(qd, "learning", "eval-history.jsonl"), n=10)
+    # ⚠ 真实路径是 data/learning/eval-history.jsonl (旧版写 .qoder/learning/ 是历史 bug,
+    #   eval_prd.py/learn.py 早改了, 这里要对齐 EVAL_HISTORY_PATH, 否则 /wl-status 永远 null)。
+    try:
+        from foundation.core.paths import EVAL_HISTORY_PATH
+        eval_path = str(EVAL_HISTORY_PATH)
+    except Exception:
+        eval_path = os.path.join(repo, "data", "learning", "eval-history.jsonl")
+    data["eval_history"] = _read_jsonl_tail(eval_path, n=10)
 
-    # 4. 学习反馈
-    data["feedback_count"] = None
-    fb = os.path.join(qd, "learning", "feedback.jsonl")
-    if os.path.exists(fb):
+    # 4. 学习反馈 (扫所有成员的 journal/feedback.jsonl, learn.py 写这里)
+    data["feedback_count"] = 0
+    members_dir = os.path.join(repo, "workspace", "members")
+    if os.path.isdir(members_dir):
         try:
-            with open(fb, encoding="utf-8") as f:
-                data["feedback_count"] = sum(1 for _ in f)
+            for m in os.listdir(members_dir):
+                fb = os.path.join(members_dir, m, "journal", "feedback.jsonl")
+                if os.path.isfile(fb):
+                    with open(fb, encoding="utf-8") as f:
+                        data["feedback_count"] += sum(1 for _ in f)
         except Exception:
             pass
 
@@ -172,8 +181,8 @@ def snapshot(repo=None):
     # 8. 任务目录结构
     data["tasks_dir"] = _list_dir(os.path.join(qd, "workspace", "tasks"))
 
-    # 9. 学习模式
-    data["patterns"] = _list_dir(os.path.join(qd, "learning", "patterns"))
+    # 9. 学习模式 (data/learning/patterns/, 非 .qoder/learning/)
+    data["patterns"] = _list_dir(os.path.join(repo, "data", "learning", "patterns"))
 
     # 10. 成员目录 (团队规模)
     data["members"] = _list_dir(os.path.join(qd, "workspace", "members"))

package/templates/qoder/scripts/domain/requirement/archive_prd.py

@@ -10,7 +10,7 @@ for _ in range(10):
         break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
-from foundation.core.paths import get_repo_root
+from foundation.core.paths import get_repo_root
 
 """
 archive_prd.py - PRD 按时间归档到个人工作区
@@ -45,44 +45,10 @@ except (AttributeError, TypeError, OSError, IOError):
     except Exception:
         pass
 
-# 让 common/ 可被 import（直接当脚本跑时）
-_THIS_DIR = os.path.dirname(os.path.abspath(__file__))
-_COMMON = os.path.join(_THIS_DIR, "foundation")
-if _COMMON not in sys.path:
-    sys.path.insert(0, _COMMON)
-
-try:
-    from paths import get_repo_root, get_developer, MEMBERS_DIR
-except ImportError:
-    # 极端兜底：直接算路径
-    def get_repo_root():
-        current = Path(_THIS_DIR).resolve()
-        for _ in range(10):
-            if (current / ".qoder").is_dir():
-                return current
-            parent = current.parent
-            if parent == current:
-                break
-            current = parent
-        return Path(_THIS_DIR).parent.parent
-
-    def get_developer(repo_root=None):
-        dev = (repo_root or get_repo_root()) / ".qoder" / ".developer"
-        if not dev.is_file():
-            return None
-        for enc in ("utf-8", "gbk"):
-            try:
-                for line in dev.read_text(encoding=enc).splitlines():
-                    line = line.strip()
-                    if "=" in line and line.split("=")[0].strip() == "name":
-                        return line.split("=", 1)[1].strip() or None
-                    if ":" in line and line.split(":")[0].strip() == "name":
-                        return line.split(":", 1)[1].strip() or None
-            except (OSError, IOError, UnicodeDecodeError):
-                continue
-        return None
-
-    MEMBERS_DIR = None  # 下面用 repo_root 拼
+# v3.x: 顶部 bootstrap 已 setup, 直接 import foundation.* (旧版重复尝试 from paths
+# + 手写兜底, 兜底会与 foundation.core.paths 静默漂移, 这里统一走真源)。
+from foundation.core.paths import get_repo_root as _grr, get_developer, MEMBERS_DIR
+get_repo_root = _grr  # 已在顶部 import, 这里显式重绑确保本模块可见
 
 
 # ============================================================

package/templates/qoder/scripts/domain/task/zentao_sync.py

@@ -24,10 +24,10 @@ import os
 import sys
 
 # ── 路径自举: 让脚本能独立运行 (复用 bootstrap 模式) ──
-# task_utils/identity 用相对导入 (.paths), 必须从 common 包上下文导入,
-# 因此把 scripts/ 加入 path, 用 common.xxx / task.xxx 访问。
+# 本脚本在 scripts/domain/task/ 下 (scripts 下 2 级), dirname 两次才到 scripts/。
+# 旧版只 dirname 一次 → _SCRIPTS=scripts/domain/ → 找不到 foundation → 整个 zentao CLI 同步死。
 _HERE = os.path.dirname(os.path.abspath(__file__))
-_SCRIPTS = os.path.dirname(_HERE)          # .qoder/scripts
+_SCRIPTS = os.path.dirname(os.path.dirname(_HERE))   # .qoder/scripts (上两级)
 _COMMON = os.path.join(_SCRIPTS, 'foundation')
 for _p in (_SCRIPTS, _COMMON):
     if _p not in sys.path:

package/templates/qoder/scripts/foundation/integrations/zentao_client.py

@@ -60,15 +60,38 @@ class ZentaoClient:
 
     @classmethod
     def from_config(cls) -> Optional['ZentaoClient']:
-        """从 .qoder/config.yaml 的 zentao 段构造（CLI 用）。凭据不全返回 None。"""
+        """从 .qoder/config.yaml 的 zentao 段构造（CLI 用）。凭据不全返回 None。
+
+        v3.1.4 设计: url 团队共享(放 config.yaml), user/password 个人凭据(放
+        workspace/members/{dev}/.private/secrets/zentao.env, gitignored)。
+        所以这里 url 从 config 读, user/password 从 zentao.env 读 ——
+        与 mcp_launcher.launch_zentao() 完全对齐 (旧版从 config 读 user/password
+        → 永远 None, 因为 config 故意不放个人凭据)。
+        """
+        # ① url 从 config.yaml
+        url = ''
         try:
             from foundation.core.config import load_config_section, SECTIONS
             cfg = load_config_section(SECTIONS.ZENTAO)
+            url = (cfg.get('url') or '').strip()
         except Exception:
-            return None
-        url = (cfg.get('url') or '').strip()
-        user = (cfg.get('user') or '').strip()
-        pwd = (cfg.get('password') or '')
+            url = ''
+        # ② user/password 从当前开发者的 .private/secrets/zentao.env
+        user = pwd = ''
+        try:
+            from foundation.core.paths import get_secrets_dir, get_developer
+            dev = get_developer()
+            if dev:
+                env_file = os.path.join(get_secrets_dir(dev), 'zentao.env')
+                if os.path.isfile(env_file):
+                    for line in open(env_file, encoding='utf-8'):
+                        line = line.strip()
+                        if line.startswith('ZENTAO_USER='):
+                            user = line.split('=', 1)[1].strip().strip('"').strip("'")
+                        elif line.startswith('ZENTAO_PASSWORD='):
+                            pwd = line.split('=', 1)[1].strip().strip('"').strip("'")
+        except Exception:
+            pass
         if not url or not user or not pwd:
             return None
         return cls(url, user, pwd)

package/templates/qoder/skills/design-import/figma-workflow.md

@@ -1,81 +1,81 @@
-# Figma 协作指南（设计师专用）
-
-> 工作流出的 HTML 原型 → Figma 精修 → 录回 spec.json 闭环
-
-## 为什么这条路可行
-
-工作流用 `fill_prototype.py` 出的 HTML 原型有以下特征，**非常适合 html.to.design 插件转换**：
-
-- CSS 用标准 CSS 变量（`:root { --primary: ... }`），插件能正确解析成 Figma Variables
-- 布局用 Flexbox/Grid，转换后图层结构清晰
-- 颜色是 Vben 真实 HSL token（不是 #1890ff），导入后直接是正确配色
-- 图标是内联 SVG（Ant Design），导入后是可编辑矢量
-
-## 完整流程（4 步）
-
-### Step 1: PM 出原型（工作流侧）
-
-PM 在 QoderWork 说"出个 XX 的原型"，工作流输出：
-
-```
-workspace/members/{pm}/drafts/prototype-{需求名}-web.html
-```
-
-设计师从 PM 那拿到这个 HTML 文件。
-
-### Step 2: 导入 Figma（设计师侧）
-
-1. 打开 Figma，新建一个 Frame
-2. 菜单：**Plugins → html.to.design**（by ‹div›RIOTS）
-   - 没装的话：Figma Community 搜 "html.to.design" 安装（免费）
-3. 插件面板里选 **File** 标签（不是 URL 标签）
-4. 把 HTML 文件**拖进拖放区**（或点选文件）
-5. 点 **Import**，等几秒
-
-**结果**：HTML 变成完全可编辑的 Figma 图层——每个元素是独立的 Frame/Text/Rectangle，颜色是正确的 Vben 配色。
-
-### Step 3: 设计师精修（Figma 侧）
-
-设计师在 Figma 里做只有人能做的精修：
-
-- 调间距/对齐（AI 的间距可能不精确）
-- 优化交互细节（hover 态、动画、过渡）
-- 换更合适的图标/插图
-- 调整信息层级和视觉重点
-- 加设计师特有的"手感"
-
-**注意**：颜色 token（`--primary` 等）尽量别改——它们是系统统一的，改了前端实现时会对不上。
-
-### Step 4: 录回工作流（闭环）
-
-设计师精修完，在 QoderWork 里说：
-
-> "录入设计稿"
-
-工作流把 Figma 最终稿的关键决策（布局/配色/组件）录成 `data/style/{需求名}-design-spec.json`。
-
-从此：
-- 下次同需求出原型，工作流**优先用这份 spec**
-- 前端拿到的 HTML 原型**匹配设计师的 Figma 终稿**
-- 设计师的劳动成果**沉淀进知识图谱**，不浪费
-
-## 常见问题
-
-**Q: 导入后图层太碎怎么办？**
-A: html.to.design 会按 HTML DOM 结构生成图层。fill_prototype 出的 HTML 结构已经很干净（侧边栏/搜索栏/表格各自独立），不会太碎。如果某个区域图层太多，选中后用 Figma 的 "Flatten" 合并。
-
-**Q: 表格数据是假的怎么办？**
-A: 对的，原型里的表格行是示例数据（"XX示例1"）。这是故意的——原型验证的是布局和交互，不是数据。真实数据前端会从 API 取。
-
-**Q: 图标导入后变位图了？**
-A: 不会。工作流用的图标是内联 SVG（不是图片标签），html.to.design 会保留为矢量。如果个别图标显示异常，从 `data/index/icon-reference.json` 找原始 SVG 手动替换。
-
-**Q: APP 端原型也能导入吗？**
-A: 能。`prototype-{需求名}-app.html` 同样是标准 HTML，导入方式一样。APP 原型用的是 Vant 风格（移动端组件库）。
-
-## html.to.design 插件安装
-
-- Figma Community 搜索：`html.to.design`
-- 或直接访问：https://www.figma.com/community/plugin/1159123024924461424
-- 免费版每次导入有限制，团队版无限
-- 也有 Chrome 扩展版（适合截取在线页面）
+# Figma 协作指南（设计师专用）
+
+> 工作流出的 HTML 原型 → Figma 精修 → 录回 spec.json 闭环
+
+## 为什么这条路可行
+
+工作流用 `fill_prototype.py` 出的 HTML 原型有以下特征，**非常适合 html.to.design 插件转换**：
+
+- CSS 用标准 CSS 变量（`:root { --primary: ... }`），插件能正确解析成 Figma Variables
+- 布局用 Flexbox/Grid，转换后图层结构清晰
+- 颜色是 Vben 真实 HSL token（不是 #1890ff），导入后直接是正确配色
+- 图标是内联 SVG（Ant Design），导入后是可编辑矢量
+
+## 完整流程（4 步）
+
+### Step 1: PM 出原型（工作流侧）
+
+PM 在 QoderWork 说"出个 XX 的原型"，工作流输出：
+
+```
+workspace/members/{pm}/drafts/prototype-{需求名}-web.html
+```
+
+设计师从 PM 那拿到这个 HTML 文件。
+
+### Step 2: 导入 Figma（设计师侧）
+
+1. 打开 Figma，新建一个 Frame
+2. 菜单：**Plugins → html.to.design**（by ‹div›RIOTS）
+   - 没装的话：Figma Community 搜 "html.to.design" 安装（免费）
+3. 插件面板里选 **File** 标签（不是 URL 标签）
+4. 把 HTML 文件**拖进拖放区**（或点选文件）
+5. 点 **Import**，等几秒
+
+**结果**：HTML 变成完全可编辑的 Figma 图层——每个元素是独立的 Frame/Text/Rectangle，颜色是正确的 Vben 配色。
+
+### Step 3: 设计师精修（Figma 侧）
+
+设计师在 Figma 里做只有人能做的精修：
+
+- 调间距/对齐（AI 的间距可能不精确）
+- 优化交互细节（hover 态、动画、过渡）
+- 换更合适的图标/插图
+- 调整信息层级和视觉重点
+- 加设计师特有的"手感"
+
+**注意**：颜色 token（`--primary` 等）尽量别改——它们是系统统一的，改了前端实现时会对不上。
+
+### Step 4: 录回工作流（闭环）
+
+设计师精修完，在 QoderWork 里说：
+
+> "录入设计稿"
+
+工作流把 Figma 最终稿的关键决策（布局/配色/组件）录成 `data/style/{需求名}-design-spec.json`。
+
+从此：
+- 下次同需求出原型，工作流**优先用这份 spec**
+- 前端拿到的 HTML 原型**匹配设计师的 Figma 终稿**
+- 设计师的劳动成果**沉淀进知识图谱**，不浪费
+
+## 常见问题
+
+**Q: 导入后图层太碎怎么办？**
+A: html.to.design 会按 HTML DOM 结构生成图层。fill_prototype 出的 HTML 结构已经很干净（侧边栏/搜索栏/表格各自独立），不会太碎。如果某个区域图层太多，选中后用 Figma 的 "Flatten" 合并。
+
+**Q: 表格数据是假的怎么办？**
+A: 对的，原型里的表格行是示例数据（"XX示例1"）。这是故意的——原型验证的是布局和交互，不是数据。真实数据前端会从 API 取。
+
+**Q: 图标导入后变位图了？**
+A: 不会。工作流用的图标是内联 SVG（不是图片标签），html.to.design 会保留为矢量。如果个别图标显示异常，从 `data/index/ref-icon.json` 找原始 SVG 手动替换。
+
+**Q: APP 端原型也能导入吗？**
+A: 能。`prototype-{需求名}-app.html` 同样是标准 HTML，导入方式一样。APP 原型用的是 Vant 风格（移动端组件库）。
+
+## html.to.design 插件安装
+
+- Figma Community 搜索：`html.to.design`
+- 或直接访问：https://www.figma.com/community/plugin/1159123024924461424
+- 免费版每次导入有限制，团队版无限
+- 也有 Chrome 扩展版（适合截取在线页面）

package/templates/qoder/skills/prototype-generator/SKILL.md

@@ -32,21 +32,21 @@ Generate production-ready HTML prototypes that match the project's actual UI sty
 - 若 `.qoder/.current-task` 存在，原型命名带上任务关键词
 - 平台（Web/APP/Both）必须明确；如未指定，先问用户（见 prd-generator Step 0）
 
-## ⚠️ 前置门: 用户是否选了"画原型"？（v3.1 新增）
-
-本 skill **只在用户明确选择"画原型"后才进入**。
-
-- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
-  `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
-- 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
-  `这个需求要画原型吗？(画 / 不画)`
-  用户答"不画"→ 退出；用户答"画"→ 继续。
-- **绝不擅自决定画/不画**。决策权在用户，本 skill 只执行。
-
-> 这条门治"AI 默默画了个塑料骨架"的反模式——比如"出交车点检固定为总部全局规则"
-> 这种纯规则下发型需求，AI 不该自己往里塞一个配置页原型。
-
----
+## ⚠️ 前置门: 用户是否选了"画原型"？（v3.1 新增）
+
+本 skill **只在用户明确选择"画原型"后才进入**。
+
+- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
+  `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
+- 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
+  `这个需求要画原型吗？(画 / 不画)`
+  用户答"不画"→ 退出；用户答"画"→ 继续。
+- **绝不擅自决定画/不画**。决策权在用户，本 skill 只执行。
+
+> 这条门治"AI 默默画了个塑料骨架"的反模式——比如"出交车点检固定为总部全局规则"
+> 这种纯规则下发型需求，AI 不该自己往里塞一个配置页原型。
+
+---
 ## Step 0: Know the Platform
 
 The platform MUST already be decided (asked by /wl-prd-full Step 0).
@@ -229,12 +229,12 @@ Key design tokens already in the templates (do not override):
 
 ## ⚠️ Icons: NEVER emoji, ALWAYS the project's real icon system
 
-Source of truth: **data/index/icon-reference.json** (real usage counts +
+Source of truth: **data/index/ref-icon.json** (real usage counts +
 ready-to-paste SVGs extracted from the actual projects).
 
-- **Web (fywl-ui)**: Ant Design icons. Inline the SVG from icon-reference.json:
+- **Web (fywl-ui)**: Ant Design icons. Inline the SVG from ref-icon.json:
   ```html
-  <span class="anticon">{svg from icon-reference.json web.svg.outlined[...]}</span>
+  <span class="anticon">{svg from ref-icon.json web.svg.outlined[...]}</span>
   <style>.anticon svg{width:1em;height:1em;fill:currentColor}</style>
   ```
   Most-used in the real app: Download(303x), Plus(171x), Delete, Search, Edit...
@@ -260,31 +260,31 @@ ready-to-paste SVGs extracted from the actual projects).
 4. ICS 的菜单来自后端接口(`access_mode: backend`),静态代码里抓不到完整菜单树,
    所以菜单层级**必须由需求/PRD 提供**,不要去代码里找。
 
-## 🔒 Step 3.5: 来源锚定 + UTF-8（硬门 #3，eval A2 检查）
-
-### 来源锚定（必做）
-
-生成的 HTML 必须在 `<head>` 里写一行注释，标注样式来源的真实文件：
-
-```html
-<!-- @prototype-source: fywl-ui/apps/ics/src/views/xxx/index.vue, fywl-ui/apps/ics/src/api/xxx.ts -->
-<meta name="x-source-pages" content="fywl-ui/.../index.vue">
-```
-
-- 来源文件**必须来自 Step 2 读过的真实 Vue/TS 文件**（prefetch 返回的 page_examples）
-- 写不出具体文件名 = 你没做 Step 2 = 违规
-- eval A2 会检查：HTML 含 `@prototype-source:` 或 `x-source-pages` → 通过；否则 A2 扣 5 分
-
-### UTF-8 强制（治编码乱码）
-
-生成的 HTML **必须用 UTF-8 写入**，否则中文 `<title>`/注释会变成 `鍑轰氦杞?` 乱码。
-
-- Write 工具调用时，内容里的中文必须是原始 UTF-8（不要从 GBK 源复制）
-- 如果用 Python 写文件：`open(path, 'w', encoding='utf-8')`
-- **绝不要从 bash 输出里复制中文再粘贴**（bash 在 Windows 上可能转 GBK）→ 优先让
-  `fill_prototype` 脚本直接出文件，AI 只 Edit 占位符
-
----
+## 🔒 Step 3.5: 来源锚定 + UTF-8（硬门 #3，eval A2 检查）
+
+### 来源锚定（必做）
+
+生成的 HTML 必须在 `<head>` 里写一行注释，标注样式来源的真实文件：
+
+```html
+<!-- @prototype-source: fywl-ui/apps/ics/src/views/xxx/index.vue, fywl-ui/apps/ics/src/api/xxx.ts -->
+<meta name="x-source-pages" content="fywl-ui/.../index.vue">
+```
+
+- 来源文件**必须来自 Step 2 读过的真实 Vue/TS 文件**（prefetch 返回的 page_examples）
+- 写不出具体文件名 = 你没做 Step 2 = 违规
+- eval A2 会检查：HTML 含 `@prototype-source:` 或 `x-source-pages` → 通过；否则 A2 扣 5 分
+
+### UTF-8 强制（治编码乱码）
+
+生成的 HTML **必须用 UTF-8 写入**，否则中文 `<title>`/注释会变成 `鍑轰氦杞?` 乱码。
+
+- Write 工具调用时，内容里的中文必须是原始 UTF-8（不要从 GBK 源复制）
+- 如果用 Python 写文件：`open(path, 'w', encoding='utf-8')`
+- **绝不要从 bash 输出里复制中文再粘贴**（bash 在 Windows 上可能转 GBK）→ 优先让
+  `fill_prototype` 脚本直接出文件，AI 只 Edit 占位符
+
+---
 ## Step 4: Highlight Changes + Interactivity
 
 - Mark NEW/CHANGED elements with the template's `highlight-new` class

package/templates/qoder/skills/wl-commit/SKILL.md

@@ -37,7 +37,19 @@ git status && git diff HEAD --stat
 
 ### Step 2: 质量门禁（提交前自检）
 
-逐项检查，任何一项不过都暂停问用户：
+**2a. 程序级强制门禁（syncgate）—— 先 git add 再跑**
+```bash
+# 1. 精确 add (不用 git add .)
+git add <相关文件>
+# 2. 对暂存文件跑零信任门禁 (身份/作者/秘密扫描/REQ-ID)
+python -c "import sys; sys.path.insert(0, r'$R/.qoder/scripts'); from domain.task.syncgate import run_gates; from foundation.core.paths import get_developer, get_repo_root; import subprocess; staged=subprocess.check_output(['git','diff','--cached','--name-only'],cwd=r'$R',text=True).split(); ok,reason=run_gates(staged, get_developer(), str(get_repo_root())); print('GATE_PASS' if ok else ('GATE_FAIL: '+reason)); sys.exit(0 if ok else 2)"
+```
+- `GATE_PASS` → 继续 2b
+- `GATE_FAIL: <原因>` → 停下，把原因告诉用户（如"检出疑似密钥 .env"），问修复还是强制。默认修复。
+  （这与 team_sync.py push 走的是同一道 syncgate，源码提交也不绕过零信任门禁。）
+
+**2b. 人工自检（grep 类）**
+逐项检查：
 - [ ] 无 TODO / FIXME 残留（grep 一下）
 - [ ] 金额字段用了 BigDecimal（不出现 double/float 存钱）
 - [ ] 命名/风格跟周围代码一致
@@ -60,8 +72,8 @@ type 选 feat / fix / refactor / docs / test / chore。
 **用户没明确说"提交/确认"之前，不要真的 commit。**
 
 ### Step 5: 提交 + 推送
+（文件已在 Step 2a git add 过，门禁已过）
 ```bash
-git add <相关文件>            # 精确 add，不用 git add .
 git commit -m "<确认后的信息>"
 git pull --rebase             # 先拉远端
 git push