@hupan56/wlkj 2.0.0

package/templates/qoder/config.yaml

@@ -0,0 +1,141 @@
+roles:
+  pm:
+    name: Product Manager
+    permissions: [create_task, write_prd, approve_prd, review_spec]
+    skills: [prd-generator, prd-review]
+  design:
+    name: Designer
+    permissions: [upload_design, approve_design]
+    skills: [design-review]
+  dev:
+    name: Developer
+    permissions: [write_spec, implement, commit, review_code]
+    skills: [spec-coder, test-generator]
+
+pipeline:
+  workspace_dir: workspace
+  prd_dir: specs/prd
+  spec_dir: specs
+  task_dir: tasks
+  data_dir: data
+  auto_spec_on_prd_push: true
+  req_id_start: 1
+
+# ── Platforms (知识图谱/搜索的平台映射, 换项目改这里即可) ──
+# search_index.py --platform <key或alias> 会过滤到对应 project 目录
+platforms:
+  web:
+    project: fywl-ui
+    aliases: [pc, 管理端, 后台]
+    ui_stack: "Ant Design Vue + VxeGrid (Vben Admin)"
+    prototype_template: .qoder/templates/prototype-web.html
+  app:
+    project: Carmg-H5
+    aliases: [mobile, h5, 移动端]
+    ui_stack: "Vant 3"
+    prototype_template: .qoder/templates/prototype-app.html
+
+# ── Git Sync (Weekly) ──
+# 每个项目在 data/code/ 下有自己的 git 仓库
+# 运行: python .qoder/scripts/git_sync.py
+# 或设 cron: 每周五 18:00
+#
+# ★ 源码仓库配置 (重要) ★
+#   把下面的 url 改成你团队的 git 地址 (Gitea/GitLab/GitHub 均可)。
+#   branch 改成你的主分支。
+#   不知道填什么? 注释掉整个 projects 段, 手动把代码放到 data/code/<项目名>/ 即可。
+#   填完后跑: python .qoder/scripts/setup.py  会自动克隆+建索引。
+git_sync:
+  schedule: "0 18 * * 5"
+  projects:
+    Carmg-H5:
+      remote: origin
+      url: http://10.87.106.228:8877/pengxicheng/Carmg-H5.git  # ← 改成你的
+      branch: jlzDEV                                            # ← 改成你的主分支
+    fywl-ics:
+      remote: origin
+      url: http://10.87.106.228:8877/fywl-ics/fywl-ics.git    # ← 改成你的
+      branch: release-fix                                       # ← 改成你的主分支
+    fywl-ui:
+      remote: origin
+      url: http://10.87.106.228:8877/fywl-ics/fywl-ui.git     # ← 改成你的
+      branch: release-fix                                       # ← 改成你的主分支
+
+
+prd_modes:
+  reference:
+    steps: [scan, analyze, reflect, confirm, generate]
+    product_types: [B2C, B2B, internal, platform]
+    quality_checklist:
+      - background_not_vague
+      - goals_quantifiable
+      - user_personas_specific
+      - business_rules_exhaustive
+      - exceptions_covered
+      - ac_testable
+      - data_events_complete
+      - no_tech_implementation
+      - priority_tagged
+      - schedule_grounded
+    built_in:
+      - competitive_scan
+      - story_breakdown
+  # Brainstorm mode (dispatches .qoder/agents/prd-research.md sub-agents)
+  brainstorm:
+    min_agents: 2
+    default_agents: 4
+    built_in:
+      - SCAMPER
+      - 5Whys
+      - constraint_innovation
+      - impact_effort_screening
+  planning:
+    steps: [current_state, ideal_state, gap_analysis, plans]
+  quick:
+    steps: [locate, generate, confirm]
+
+task:
+  prioritization: RICE
+  auto_rank: true
+
+status:
+  dimensions:
+    - on_time_delivery
+    - scope_stability
+    - dependency_health
+    - pipeline_flow
+    - learning_growth
+
+insight:
+  types: [feedback, metrics]
+
+# ── Feishu (飞书) 通知集成 (阶段 D) ──
+# 群机器人 webhook: 在飞书群设置 > 群机器人 > 添加自定义机器人 > 拿 webhook URL
+# 支持环境变量覆盖: export FEISHU_WEBHOOK_URL=...
+feishu:
+  enabled: false  # 设 true 并配 webhook_url 后才推送
+  webhook_url: ""  # 或填群机器人 webhook, 或用环境变量 FEISHU_WEBHOOK_URL
+  secret: ""       # 签名校验密钥 (机器人启用签名校验时填), 或 FEISHU_SECRET
+  # 推送哪些事件 (不配则全推)
+  events:
+    - task_finished       # 任务完成
+    - prd_published       # PRD 发布
+    - eval_rejected       # EVA 门禁拒绝
+    - deadline_warning    # 截止日期临近 (由 /wl-status 触发)
+  # 卡片主题色 (default/green/orange/red)
+  theme:
+    task_finished: green
+    prd_published: blue
+    eval_rejected: red
+    deadline_warning: orange
+
+  feedback_categories: [feature_request, bug, UX, performance, praise, question]
+  metrics_analyses: [growth, retention, funnel, ab_experiment, okr]
+
+notification:
+  console:
+    type: console
+    enabled: true
+
+codex:
+  dispatch_mode: inline

package/templates/qoder/hooks/inject-workflow-state.py

@@ -0,0 +1,117 @@
+# inject-workflow-state.py - Inject workflow state on every message
+import os, json, sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+NL = chr(10)
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+# mtime 缓存 (审计 H5: 每条用户消息都跑这个 hook, 缓存避免重复读盘)
+# 格式: {filepath: (mtime, parsed_value)}
+_CACHE = {}
+
+
+def _read_developer():
+    """读当前开发者名 (容错: UTF-8/GBK)."""
+    df = os.path.join(BASE, '.qoder', '.developer')
+    if not os.path.isfile(df):
+        return None
+    for enc in ('utf-8', 'gbk', 'utf-8-sig'):
+        try:
+            with open(df, encoding=enc) as f:
+                for line in f:
+                    line = line.strip()
+                    if line.startswith('name='):
+                        return line.split('=', 1)[1].strip()
+                    if line.startswith('name:') or ':' in line:
+                        # 容错 name: x 格式
+                        for sep in ('=', ':'):
+                            if sep in line:
+                                k, v = line.split(sep, 1)
+                                if k.strip() == 'name':
+                                    return v.strip()
+        except (OSError, UnicodeDecodeError):
+            continue
+    return None
+
+
+def _cached_read(path, parser):
+    """带 mtime 缓存的文件读。parser: callable(content_str) -> value."""
+    try:
+        mtime = os.path.getmtime(path)
+    except OSError:
+        return None
+    cached = _CACHE.get(path)
+    if cached and cached[0] == mtime:
+        return cached[1]
+    # 重读
+    for enc in ('utf-8', 'gbk', 'utf-8-sig'):
+        try:
+            with open(path, encoding=enc) as f:
+                content = f.read()
+            value = parser(content)
+            _CACHE[path] = (mtime, value)
+            return value
+        except (OSError, UnicodeDecodeError):
+            continue
+    return None
+
+
+def get_status():
+    # 优先读按开发者隔离的 current-task 文件
+    dev = _read_developer()
+    ct_candidates = []
+    if dev:
+        safe = ''.join(c for c in dev if c.isalnum() or c in '_-') or 'anon'
+        ct_candidates.append(os.path.join(BASE, '.qoder', '.runtime', 'current-task.' + safe))
+    ct_candidates.append(os.path.join(BASE, '.qoder', '.current-task'))  # 旧格式回退
+
+    rel = None
+    for ct in ct_candidates:
+        rel = _cached_read(ct, lambda c: c.strip() or None)
+        if rel:
+            break
+    if not rel:
+        return None, None
+
+    tj = os.path.join(BASE, rel, 'task.json')
+    if os.path.isfile(tj):
+        d = _cached_read(tj, lambda c: json.loads(c) if c.strip() else None)
+        if d:
+            return rel, d.get('status', 'unknown')
+    return rel, None
+
+
+# Statuses written by task.py: planning -> in_progress -> completed
+GUIDE = {
+    None: 'No active task. Use /wl-prd to start, or /wl-task create.',
+    'planning': 'Task in planning. Use /wl-prd to write the PRD, then /wl-task start.',
+    'in_progress': 'Dev in progress. /wl-spec to generate spec, /wl-code to implement.',
+    'completed': 'Task completed. /wl-task archive to archive, or start the next one.',
+}
+
+
+def main():
+    tp, st = get_status()
+    g = GUIDE.get(st, 'Status "{}" - check task.json, expected planning/in_progress/completed.'.format(st))
+    parts = []
+    parts.append('<qoder-workflow>')
+    if tp:
+        parts.append('Task: ' + tp)
+    parts.append('Status: ' + str(st))
+    parts.append('Do: ' + g)
+    parts.append('</qoder-workflow>')
+    print(NL.join(parts))
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except Exception as e:
+        print('<qoder-workflow>')
+        print('hook error: ' + str(e)[:200])
+        print('</qoder-workflow>')

package/templates/qoder/hooks/session-start.py

@@ -0,0 +1,204 @@
+# session-start.py - Inject project context on session start
+import os, json, sys
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+NL = chr(10)
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+# Injected as REAL OUTPUT below (a comment here would never reach the AI)
+CRITICAL_RULE = NL.join([
+    '## CRITICAL RULE',
+    'When user asks for /wl-prd, ALWAYS ask platform FIRST:',
+    '"这个需求是针对哪个平台？',
+    ' 1. Web 管理端 (fywl-ui) - Ant Design Vue + VxeGrid 风格',
+    ' 2. APP 移动端 (Carmg-H5) - Vant 风格',
+    ' 3. 两端都要',
+    ' 请选择 (1/2/3):"',
+    'DO NOT skip this question. DO NOT auto-detect. ALWAYS ASK.',
+])
+
+
+def load_json_safe(path):
+    try:
+        with open(path, encoding='utf-8') as f:
+            return json.load(f)
+    except Exception:
+        return None
+
+
+def get_developer():
+    df = os.path.join(BASE, '.qoder', '.developer')
+    if not os.path.isfile(df):
+        return None
+    try:
+        with open(df, encoding='utf-8') as f:
+            content = f.read()
+    except Exception:
+        return None
+    info = {}
+    for line in content.strip().splitlines():
+        for sep in ('=', ':'):
+            if sep in line:
+                k, v = line.split(sep, 1)
+                info[k.strip()] = v.strip()
+                break
+    return info or None
+
+
+def get_active_tasks():
+    td = os.path.join(BASE, 'workspace', 'tasks')
+    if not os.path.isdir(td):
+        return []
+    tasks = []
+    for d in sorted(os.listdir(td)):
+        data = load_json_safe(os.path.join(td, d, 'task.json'))
+        if data is None:
+            continue
+        tasks.append({
+            'name': d,
+            'title': data.get('title', d),
+            'status': data.get('status', 'unknown')
+        })
+    return tasks
+
+
+def get_team_size():
+    md = os.path.join(BASE, 'workspace', 'members')
+    if not os.path.isdir(md):
+        return 0
+    return len([d for d in os.listdir(md) if os.path.isdir(os.path.join(md, d))])
+
+
+def get_index_info():
+    lines = []
+    lines.append('## Knowledge Index')
+    lines.append('Use search script (DO NOT read large JSON files directly):')
+    lines.append('  python .qoder/scripts/search_index.py <keyword> [--platform web|app]')
+    lines.append('  python .qoder/scripts/search_index.py --prd <keyword>   # search PRDs')
+    lines.append('  python .qoder/scripts/search_index.py --style <table|form> [--platform p]')
+    lines.append('  python .qoder/scripts/search_index.py --field <name>    # field usage')
+    lines.append('  python .qoder/scripts/search_index.py --api <keyword>   # API endpoints')
+    lines.append('  python .qoder/scripts/search_index.py --components      # UI components')
+    lines.append('  python .qoder/scripts/search_index.py --modules         # project overview')
+    lines.append('  python .qoder/scripts/search_index.py --list            # top keywords')
+
+    meta = load_json_safe(os.path.join(BASE, 'data', 'index', '.index-meta.json'))
+    if meta:
+        projects = meta.get('projects', {})
+        if isinstance(projects, dict):
+            for proj, info in projects.items():
+                if isinstance(info, dict):
+                    files = info.get('files', 0)
+                else:
+                    files = info  # new meta format: {project: file_count}
+                lines.append('  ' + str(proj) + ': ' + str(files) + ' files')
+        elif isinstance(projects, list):
+            for proj in projects:
+                lines.append('  ' + str(proj))
+        lines.append('Last sync: ' + str(meta.get('last_sync', 'unknown')))
+        # Staleness warning (审计发现: cron 从未注册, 索引可能静默过期)
+        last_sync = meta.get('last_sync')
+        if last_sync:
+            try:
+                from datetime import datetime
+                # 兼容多种格式: "2026-06-12 16:49" / ISO
+                ts = str(last_sync).replace('T', ' ').split('.')[0].strip()
+                for fmt in ('%Y-%m-%d %H:%M', '%Y-%m-%d %H:%M:%S', '%Y-%m-%dT%H:%M:%S'):
+                    try:
+                        sync_dt = datetime.strptime(ts, fmt)
+                        break
+                    except ValueError:
+                        continue
+                else:
+                    sync_dt = None
+                if sync_dt:
+                    age_days = (datetime.now() - sync_dt).days
+                    if age_days > 30:
+                        lines.append('[CRITICAL] 索引已 {} 天未更新! 搜索结果严重过期. 跑: python .qoder/scripts/git_sync.py'.format(age_days))
+                    elif age_days > 7:
+                        lines.append('[WARN] 索引已 {} 天未更新, 建议刷新: python .qoder/scripts/git_sync.py'.format(age_days))
+            except Exception:
+                pass  # 日期解析失败不阻塞
+        if meta.get('failures'):
+            lines.append('WARNING: last sync had errors - see data/index/.index-meta.json')
+
+    return NL.join(lines)
+
+
+def get_style_info():
+    """Read style metadata for quick reference"""
+    meta = load_json_safe(os.path.join(BASE, 'data', 'index', 'style-meta.json'))
+    if not meta:
+        return None
+
+    lines = []
+    lines.append('## UI Style Index')
+    lines.append('Style search: python .qoder/scripts/search_index.py --style <table|form|modal>')
+    lines.append('Field search: python .qoder/scripts/search_index.py --field <name>')
+
+    for proj, d in meta.get('projects', {}).items():
+        vue = d.get('vue_files', 0)
+        if vue > 0:
+            pt = d.get('page_types', {})
+            types_str = ', '.join([k + ':' + str(v) for k, v in pt.items() if v > 0])
+            lines.append('  ' + proj + ': ' + str(vue) + ' Vue (' + types_str + ')')
+
+    lines.append('Top components: ' + ', '.join(list(meta.get('common_components', {}).keys())[:8]))
+    lines.append('Field map: ' + str(meta.get('field_count', 0)) + ' entries')
+
+    if os.path.isdir(os.path.join(BASE, 'data', 'style')):
+        lines.append('Style PDFs: data/style/ (design specs, code takes priority)')
+
+    return NL.join(lines)
+
+
+def main():
+    parts = []
+    parts.append('<qoder-context>')
+    dev = get_developer()
+    if dev:
+        name = dev.get('name', 'unknown')
+        role = dev.get('role', 'unknown')
+        parts.append('Developer: ' + name + ' (' + role + ')')
+        parts.append('Workspace: workspace/members/' + name + '/')
+    else:
+        parts.append('Developer: NOT SET. Run /wl-init to register.')
+    team = get_team_size()
+    if team > 0:
+        parts.append('Team members: ' + str(team))
+    tasks = get_active_tasks()
+    if tasks:
+        parts.append('Active tasks:')
+        for t in tasks:
+            parts.append('  [' + t['status'] + '] ' + t['name'] + ' - ' + t['title'])
+
+    parts.append('')
+    parts.append(CRITICAL_RULE)
+
+    idx_info = get_index_info()
+    if idx_info:
+        parts.append('')
+        parts.append(idx_info)
+
+    style_info = get_style_info()
+    if style_info:
+        parts.append('')
+        parts.append(style_info)
+
+    parts.append('</qoder-context>')
+    print(NL.join(parts))
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except Exception as e:
+        # A broken hook must never kill the session - emit minimal context
+        print('<qoder-context>')
+        print('session-start hook error: ' + str(e)[:200])
+        print('</qoder-context>')

package/templates/qoder/rules/wl-pipeline.md

@@ -0,0 +1,105 @@
+---
+trigger: always_on
+---
+
+# QODER Pipeline 工作流规则（全模式生效）
+
+> 本规则是 wl-pipeline 的核心约束，通过 .qoder/rules/ 在 Qoder IDE 对话、
+> Quest 模式中始终生效。Qoder CLI 读根目录 AGENTS.md（内容一致）。
+> 完整命令定义在 .qoder/commands/wl-*.md，技能在 .qoder/skills/。
+
+## 规则 0：自然语言 → 技能 路由表（全端通用）
+
+所有 Qoder 产品（IDE 编辑器 / Quest 模式 / QoderWork 桌面端 / CLI）都支持两种触发方式：
+1. **斜杠命令**：输入 `/wl-prd` `/wl-search` 等（commands 和 skills 都可用 `/` 触发）
+2. **自然语言**：直接说"写个需求""查一下代码"，AI 按下表自动映射到对应 skill
+
+> 注意：Quest/QoderWork 里 `/` 会同时列出 commands（如 `/wl-prd`）和 skills（如 `/prd-generator`）。
+> 两者功能等价，优先用 `/wl-*` 命令（更稳定，参数提示更全）。
+
+| 用户说什么 | 触发的 skill/command |
+|------------|---------------------|
+| "写个需求""生成PRD""做个原型""保单这块加个功能" | `/wl-prd` 或 prd-generator + prototype-generator |
+| "查一下""代码在哪""搜保险""考勤的API""字段含义" | `/wl-search` 或 wl-search |
+| "建任务""排优先级""这个任务做完了""开始做这个" | `/wl-task` 或 wl-task |
+| "项目怎么样""进度""健康度""路线图" | `/wl-status` 或 wl-status |
+| "写日报""周报""我这周干了啥""今天做了什么" | `/wl-report` 或 wl-report |
+| "用户反馈""数据怎么样""转化漏斗""留存" | `/wl-insight` 或 wl-insight |
+| "生成规格""写spec""技术方案" | `/wl-spec` 或 spec-generator |
+| "开始写代码""按规格实现""实现这个接口" | `/wl-code` 或 spec-coder |
+| "写单元测试""补测试""覆盖一下" | `/wl-test` 或 test-generator |
+| "评审PRD""PRD质量怎么样" | prd-review |
+| "提交代码""commit""推上去""保存代码" | `/wl-commit` 或 wl-commit |
+| "初始化""换开发者""环境检查""我是谁" | `/wl-init` 或 wl-init |
+
+**找不到明确匹配时：先问用户意图，不要乱跑**（"你是想写 PRD、查代码、还是建任务？"）。
+注意：用户说"同步/保存产出"通常指 team_sync（push），不是 git commit；
+用户说"提交/commit 代码"才是 wl-commit。
+
+## 规则 1：PRD/原型需求必须先问平台
+
+用户提出 PRD、原型、需求分析类请求时，第一步永远是问（绝不自动判断）：
+
+```
+这个需求是针对哪个平台？
+1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
+2. **APP 移动端** (Carmg-H5) - Vant 风格
+3. **两端都要
+请选择 (1/2/3):
+```
+
+## 规则 2：查代码只用索引，不全库 grep
+
+```bash
+python .qoder/scripts/context_pack.py <业务关键词> --platform <web|app>   # 一次取全(首选)
+python .qoder/scripts/search_index.py <关键词> --platform <web|app>      # 单项搜索
+```
+context_pack 一条命令返回：相关代码文件 + 同类页面示例 + 字段规格 +
+相关 PRD + 设计 Token + 图标参考 + 模板路径。禁止对 data/code/ 全库 grep。
+
+## 规则 3：原型风格必须来自真源（含图标）
+
+- 起点永远是平台模板：.qoder/templates/prototype-web.html / prototype-app.html
+- 颜色只用真源：data/index/vben-style-reference.json（Web HSL token）、
+  chart-style-reference.json（看板/大屏两种系统内风格）、Vant 变量（APP）
+- **图标绝对禁止 emoji**：Web 用 data/index/icon-reference.json 里的
+  Ant Design 真实 SVG（内联，fill=currentColor）；APP 用 Vant 字体图标
+  （CDN: https://cdn.jsdelivr.net/npm/vant@4/lib/index.css + van-icon 类名）
+- 新功能（无现有页面）也必须锚定系统内最近似的真实页面：
+  大屏/全国地图类 → dashboard/monitor 先例；工作台卡片类 → dashboard/workbench
+- 原型头部注释必须写明风格来自哪些真实文件，写不出来源 = 风格提取没做
+
+## 规则 4：PRD 必须套团队模板 + 过 EVA 门禁
+
+- 完整需求用 .qoder/templates/prd-full-template.md，零星需求用 prd-quick-template.md
+- 发布前：`python .qoder/scripts/eval_prd.py <prd> [原型]` 必须 PASS (≥80%)
+- 发现确认采用批量方式（一个编号列表一轮确认），不要逐条问
+
+## 规则 5：用户永不接触 git
+
+- 产出保存/发布后自动执行 `python .qoder/scripts/team_sync.py push`
+- 拉取团队最新：`python .qoder/scripts/team_sync.py pull`
+- 出现 SYNC_CONFLICT 由 AI 按提示自行解决，绝不让用户跑 git 命令
+
+## 规则 6：环境问题找 doctor
+
+任何"索引不对/搜不到/环境坏了"类问题：
+`python .qoder/scripts/init_doctor.py`（加 --fix 自动修复，幂等增量，不会重头构建）
+
+## 规则 7：Repo Wiki 是补充知识源
+
+若存在 .qoder/repowiki/（Qoder IDE 生成的仓库 Wiki），写 PRD 前先查其中
+相关模块页面（架构、模块说明比索引更全面）；data/code/ 下各源码仓库若有
+自己的 repowiki 同样优先参考。索引负责"定位文件"，Wiki 负责"理解模块"。
+
+## 用户侧命令一览（用户只需要知道这些）
+
+| 命令 | 作用 |
+|------|------|
+| /wl-init [名字] [角色] | 初始化/切换开发者 + 环境体检 |
+| /wl-prd <需求描述> | 生成 PRD + 原型（最核心） |
+| /wl-search <关键词> | 查代码/PRD/字段/API |
+| /wl-task, /wl-status, /wl-report | 任务/状态/日报周报 |
+| /wl-spec, /wl-code, /wl-test, /wl-commit | 规格/编码/测试/提交（后三个需确认） |
+
+用户用自然语言表达即可，AI 负责映射到命令和脚本。