@hupan56/wlkj 2.0.0

package/templates/root/AGENTS.md

@@ -0,0 +1,182 @@
+# QODER Pipeline
+
+## ⚠️ CRITICAL RULE #1: ALWAYS ASK PLATFORM FIRST
+
+**When user asks for PRD or prototype, you MUST ask this question 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.**
+**Wait for user answer before doing ANYTHING else.**
+
+---
+
+## CRITICAL RULE #2: Use /wl-search to find code
+
+When user asks about code, business, API, feature:
+1. **ALWAYS** use `/wl-search <keyword>` command first
+2. Then read only the specific files returned
+3. **NEVER** grep the entire codebase directly
+
+Examples:
+- "考勤代码在哪" -> /wl-search attendance
+- "保险定时任务" -> /wl-search insurance
+- "薪资API" -> /wl-search --api salary
+
+## CRITICAL RULE #2.5: 自然语言 → 技能 路由（Quest / QoderWork 入口）
+
+Quest 与 QoderWork 没有斜杠命令，AI 必须按下表把用户自然语言映射到
+`.qoder/skills/` 下的技能（Qoder IDE 编辑器与 CLI 用 `/wl-*` 命令，同样适用）：
+
+| 用户说什么 | 触发 skill |
+|------------|-----------|
+| "写个需求""生成PRD""做个原型" | prd-generator + prototype-generator |
+| "查一下""代码在哪""搜保险""考勤API" | wl-search |
+| "建任务""排优先级""任务做完了" | wl-task |
+| "项目怎么样""进度""健康度" | wl-status |
+| "写日报""周报""我干了啥" | wl-report |
+| "用户反馈""数据怎么样" | wl-insight |
+| "生成规格""写spec" | spec-generator |
+| "开始写代码""按规格实现" | spec-coder |
+| "写单元测试" | test-generator |
+| "评审PRD" | prd-review |
+| "提交代码""commit""推上去" | wl-commit |
+| "初始化""换开发者""环境检查" | wl-init |
+
+找不到明确匹配 → 先问用户意图，不要乱跑。
+注意区分："同步/保存产出" = team_sync（push）；"提交/commit 代码" = wl-commit。
+
+## CRITICAL RULE #3: User NEVER touches git
+
+PMs on this team do not know git. ALL git operations are invisible:
+- After any publish/save action (/wl-prd publish, /wl-task create/finish,
+  /wl-report save), run: `python .qoder/scripts/team_sync.py push`
+- To get teammates' latest work: `python .qoder/scripts/team_sync.py pull`
+- If team_sync prints SYNC_CONFLICT, YOU (the AI) resolve the conflict
+  yourself (it tells you the commands). NEVER ask the user to run git.
+- When the user says 同步/保存/提交 in natural language -> team_sync, not raw git.
+
+## Platform Filtering
+
+After user selects platform, use it for search:
+
+```bash
+# Search by platform
+/wl-search 保险 --platform web      # Only fywl-ui (PC)
+/wl-search 保险 --platform app      # Only Carmg-H5 (Mobile)
+/wl-search 保险                       # Both platforms
+
+# Platform shortcuts
+web/pc/管理端 -> fywl-ui
+app/mobile/h5/移动端 -> Carmg-H5
+```
+
+## 11 Commands (All prefixed /wl-)
+
+### Pipeline Core
+| Command | Auto | Purpose |
+|---------|------|---------|
+| `/wl-init` | YES | Register/switch developer identity |
+| `/wl-prd` | YES | Generate PRD (ASKS platform first!) |
+| `/wl-spec` | YES | Generate technical Spec from PRD |
+| `/wl-code` | NO | Code implementation (needs confirm) |
+| `/wl-commit` | NO | Git commit + push + sync (needs confirm) |
+
+### Product Management
+| Command | Auto | Purpose |
+|---------|------|---------|
+| `/wl-search` | YES | Search code index (supports Chinese, platform filtering) |
+| `/wl-task` | YES | Task management + RICE prioritization |
+| `/wl-status` | YES | Project status + roadmap + health |
+| `/wl-insight` | YES | Feedback analysis + metrics review |
+
+### Reporting
+| Command | Auto | Purpose |
+|---------|------|---------|
+| `/wl-report` | YES | Generate daily or weekly work report |
+| `/wl-test` | NO | Generate unit tests (needs confirm) |
+
+## Knowledge Index
+
+3 projects: Carmg-H5(1378 files), fywl-ics(8973 files, 3903 APIs), fywl-ui(3270 files)
+Search: /wl-search <keyword> returns compact results (~200 bytes)
+Weekly sync: python .qoder/scripts/git_sync.py
+
+### Style Index (Prototype Reference)
+UI patterns from Vue files: Tables(718), Forms(301), Detail(129), Dashboard(90)
+Top components: Space(583), Modal(270), Select(172), Input(134)
+Form components: Input(2262), Select(1049), ApiSelect(725), DatePicker(265)
+Field map: 2383 entries
+
+Style search:
+  python .qoder/scripts/search_index.py --style table/form/modal/dashboard
+  python .qoder/scripts/search_index.py --field <field_name>
+  python .qoder/scripts/search_index.py --components
+  python .qoder/scripts/search_index.py --vben    # Vben Admin CSS variables
+
+Prototype templates:
+  .qoder/templates/prototype-web.html   # Web管理端 (Vben Admin + Ant Design)
+  .qoder/templates/prototype-app.html   # APP移动端 (Vant)
+
+Prototype output: workspace/members/{dev}/drafts/prototype-{feature}.html
+Style priority: Code > PDF > Default
+
+## Workflow
+
+/wl-init -> /wl-prd (ASK PLATFORM!) -> /wl-task -> /wl-spec -> /wl-code -> /wl-test -> /wl-commit -> /wl-report
+
+## Cross-platform & Qoder Product Family Compatibility
+
+This pipeline works on Windows + macOS, across the whole Qoder family.
+Each product loads rules from a different carrier — keep them in sync:
+
+| 产品/模式 | 规则载体 | 命令载体 |
+|-----------|---------|---------|
+| Qoder IDE 默认编辑器 | .qoder/rules/wl-pipeline.md (always_on) | .qoder/commands/wl-*.md |
+| Qoder Quest 模式 | .qoder/rules/ + .qoder/skills/ + .qoder/agents/ | 自然语言 -> skills |
+| Qoder CLI (qodercli) | 本文件 AGENTS.md | 自然语言 -> scripts |
+| QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
+| Claude Code 等其他工具 | 本文件 AGENTS.md | .qoder/commands/wl-*.md |
+
+- THE rule file: `.qoder/rules/wl-pipeline.md` — 修改流程规则时同步更新它和本文件
+- Quest 修改 agents/skills 后需重启 Quest 窗口/新建对话才能生效（Qoder 已知限制）
+- **Repo Wiki** (`.qoder/repowiki/`, Qoder IDE 生成): 存在则作为模块级知识源,
+  写 PRD 前优先查相关模块页；可提交 git 团队共享。索引管"定位", Wiki 管"理解"。
+- All scripts are pure Python 3 + git, path-autodetecting (no hardcoded
+  drive letters). Invoke as `python` (Windows) or `python3` (macOS).
+- Weekly update: Windows -> scripts/setup_weekly_cron.bat,
+  macOS/Linux -> scripts/setup_weekly_cron.sh. Only ONE machine per team
+  needs this; everyone else gets the graph via /wl-init's auto pull.
+- Environment problems of any kind -> run:
+  `python .qoder/scripts/init_doctor.py` (add --fix to auto-repair).
+
+## Fast Path: one call to get all context
+
+`python .qoder/scripts/context_pack.py <业务词> --platform <web|app>` returns
+code files + page examples + field specs + PRDs + APIs + style/icon pointers
+in ONE call. Use it FIRST; fall back to search_index.py for drill-down.
+
+## Icons: NEVER emoji
+
+Prototypes use the projects' real icon systems (data/index/icon-reference.json):
+Web = Ant Design inline SVG, APP = Vant font icons. Emoji in a prototype = FAIL.
+
+## Quality Gate (EVA)
+
+Before publishing any PRD: `python .qoder/scripts/eval_prd.py <prd> [prototype]`
+must PASS (>=80%). Metrics definition: data/docs/constitution/eva-metrics.md
+
+## Permission Model
+
+| Level | Commands | Auto |
+|-------|---------|------|
+| SAFE | /wl-init, /wl-prd, /wl-search, /wl-task, /wl-spec, /wl-status, /wl-insight, /wl-report | YES |
+| DANGEROUS | /wl-code, /wl-test, /wl-commit | NO |

package/templates/root/README-pipeline.md

@@ -0,0 +1,56 @@
+# QODER R&D Pipeline
+
+`npx wlkj init zhangsan` 一行搞定。
+
+## 目录结构
+
+```
+.qoder/              引擎（配置、脚本、规则）  你不需要直接碰
+workspace/           工作区（你每天看的东西）  清晰可见
+  specs/            团队共享 Spec（Git 追踪）
+  tasks/            团队共享任务（Git 追踪）
+  constitution/     团队规范约束（Git 追踪）
+  members/          个人工作空间（gitignored）
+    {你的名字}/
+      journal/      个人会话日志
+      drafts/       个人草稿
+      inbox/        待处理项
+workspace/specs/
+  prd/              PRD 产出
+  specs/            Spec 产出
+```
+
+## 四种工作模式
+
+| 模式 | 适用场景 | 触发方式 |
+|------|---------|---------|
+| 需求调研 | 大需求/新领域 | "我要做一个XX系统" |
+| 快速需求 | 小功能/Bug fix | "加个字段" / "跳过流程" |
+| 代码对齐 | 现有项目迭代 | "对齐现有代码" |
+| 个人->团队 | 草稿提交 | "推送给团队" |
+
+## 命令
+
+```bash
+# 初始化
+npx wlkj init zhangsan
+
+# 日常
+npx wlkj status
+npx wlkj task create "请假功能" -p P1
+npx wlkj task list --mine
+npx wlkj task start leave
+npx wlkj task finish
+
+# Git (中文)
+npx wlkj 提交PRD        # git add workspace/specs/ + commit + push
+npx wlkj 拉取最新        # git pull
+npx wlkj 提交代码        # git add src/ + commit + push
+npx wlkj 提交测试        # git add tests/ + commit + push
+npx wlkj 查看状态        # git status
+
+# 在 QODER 里说
+"帮我生成PRD，需求是..."
+"按Spec编码"
+"生成单元测试"
+```

package/templates/root/ROLES.md

@@ -0,0 +1,85 @@
+# 三个角色怎么用
+
+## 产品经理
+
+```
+第1步: 在 Codex 中说
+  "帮我生成PRD，需求是员工请假功能"
+
+第2步: AI 逐题问你 5 个问题（每次只问一个）
+  - 业务场景是什么？
+  - 目标用户是谁？
+  - 核心功能是什么？
+  - 用户故事有哪些？
+  - 验收标准是什么？
+
+第3步: AI 生成 PRD 到 docs/ai/prd/REQ-002-employee-leave.md
+
+第4步: 你审核 PRD，确认后：
+  git add docs/ai/prd/
+  git commit -m "docs(ai): REQ-002 PRD [ai-generated]"
+  git push
+
+完成。Spec 会自动生成。
+```
+
+---
+
+## 开发人员
+
+```
+第0步: 初始化（一次性）
+  npx wlkj init zhangsan
+
+第1步: 收到通知"REQ-002 Spec 已生成"
+  打开 docs/ai/specs/REQ-002-attendance-leave.md 审核
+
+第2步: 确认无误后，在 Codex 中说
+  "按 Spec 编码"
+
+第3步: AI 按 Spec 严格实现代码
+  Entity -> Mapper -> Service -> Controller
+
+第4步: 代码完成后，在 Codex 中说
+  "生成单元测试"
+
+第5步: 测试通过后提交
+  npx wlkj task finish
+  npx wlkj task archive leave
+```
+
+---
+
+## UI 设计师
+
+当前 MVP 阶段 UI 有两条路：
+
+### 路线 A：用现有系统（推荐）
+后端接口按 Spec 实现完，前端直接对接。
+UI 在现有的 Vue 3 + Element Plus 页面里加功能。
+
+### 路线 B：AI 生成 UI（未来）
+在 Spec 阶段加一个 `ui-spec` 步骤：
+1. Spec 里增加「页面原型」章节
+2. AI 根据接口生成 Element Plus 组件代码
+3. 嵌入现有 Vue 页面
+
+### 现在怎么做
+```
+第1步: 在 Spec 审核时，补充页面需求
+  "这个接口需要什么页面？表格还是表单？"
+
+第2步: 开发实现后端时，AI 同时生成 Vue 组件骨架
+
+第3步: UI 设计师调整样式和交互细节
+```
+
+---
+
+## 一句话总结
+
+| 角色 | 做什么 | 用什么 |
+|------|--------|--------|
+| 产品 | 描述需求 -> 审核 PRD -> push | prd-generator skill |
+| 开发 | 审核 Spec -> 说"按Spec编码" -> 测试 | spec-coder + test-generator skill |
+| UI | 后端完成后对接，或在 Spec 阶段参与 | 当前手动，未来 AI 生成 |

package/templates/root//346/226/260/346/211/213/346/214/207/345/215/227.md

@@ -0,0 +1,186 @@
+# 新手指南
+
+> 不需要懂代码、不需要懂 git。会说中文就能用。
+
+---
+
+## 一、开始前准备
+
+### 必须有
+
+- 一台电脑（Windows / Mac）
+- 已装 **Node.js 16+**（去 nodejs.org 下载，装了就有 npx）
+- 已装 **Python 3.9+**（去 python.org 下载）
+
+### 可选（没有也能用）
+
+- **git**：团队协作用。没装也行，自己写 PRD / 查代码 / 建任务都不影响
+- **Qoder 客户端**（IDE / Quest / QoderWork 任一）：用 AI 对话驱动。没有也能用命令行
+- **飞书群机器人**：自动推送通知。没有不影响功能
+
+---
+
+## 二、新项目第一次使用（只做一次）
+
+建一个空文件夹，进去，跑一条命令：
+
+```
+mkdir 我的项目
+cd 我的项目
+npx wlkj init
+```
+
+它会自动完成一切：
+1. 安装完整工作流引擎（搜索/PRD/任务/报告/导出 全部就绪）
+2. 探测你的名字（从 git 配置读，或问你"叫什么名字"）
+3. 注册你的开发者身份
+4. 装 git（如果没有，会问你要不要自动装）
+5. 拉取源码建索引（如果配了 git 地址）
+6. 注册周五自动更新（询问式）
+7. 装 QoderWork 技能（检测到桌面端时询问）
+
+看到下面这样就成功了：
+
+```
+✓ 开发者: 你的名字
+✓ 知识图谱就绪
+安装完成! 现在可以开始了
+```
+
+> 想指定名字？`npx wlkj init 小王`
+> 想指定角色？`npx wlkj init 小王 dev`
+
+---
+
+## 三、日常使用（3 种方式，任选）
+
+### 方式 A：直接说话（推荐）
+
+在 Qoder 对话框里直接用中文说：
+
+| 你说什么 | 会发生什么 |
+|---------|-----------|
+| "写个保险异常筛选的需求" | 生成 PRD + 原型 |
+| "查一下考勤代码在哪" | 搜索代码 |
+| "建个任务：登录优化" | 建任务 |
+| "今天干了啥" | 出日报 |
+| "项目怎么样" | 看进度健康度 |
+
+### 方式 B：斜杠命令（精确）
+
+输入 `/` 会列出所有命令。常用的：
+
+| 命令 | 作用 |
+|------|------|
+| `/wl-prd` | 写需求 |
+| `/wl-search` | 查代码 |
+| `/wl-task` | 管任务 |
+| `/wl-status` | 看进度 |
+| `/wl-report` | 出报告 |
+| `/wl-init` | 拉取团队最新 |
+
+### 方式 C：命令行（兜底，无 Qoder 时）
+
+```
+python .qoder/scripts/search_index.py 保险
+python .qoder/scripts/task.py create "登录优化"
+python .qoder/scripts/report.py daily
+```
+
+---
+
+## 四、你能做什么
+
+### 写需求
+
+| 想做的事 | 怎么说 |
+|---------|--------|
+| 写完整需求文档 | "写个 XXX 的需求" |
+| 写小改动需求 | "快速写个 XXX" |
+| 头脑风暴 | "脑暴一下 XXX 功能" |
+| 做规划 | "规划 XXX 的路线图" |
+| 画原型 | 随需求自动生成 |
+
+### 查代码（不懂代码也能查）
+
+| 想做的事 | 怎么说 |
+|---------|--------|
+| 找业务代码 | "保险的代码在哪" |
+| 找 API | "考勤有哪些 API" |
+| 找字段用法 | "nickName 字段在哪用" |
+| 找同类页面 | "系统里有哪些列表页" |
+
+### 管任务
+
+| 想做的事 | 怎么说 / 命令 |
+|---------|--------------|
+| 建任务 | "建个任务：登录优化" |
+| 设截止日期 | "给登录优化设截止日期 7月15" |
+| 标记依赖 | "登录优化依赖数据库迁移" |
+| 看哪些能开始 | "哪些任务可以开始" |
+| 看哪些被卡住 | "哪些任务被阻塞" |
+| 看甘特图 | "看任务排期" |
+| 完成任务 | "这个任务做完了" |
+
+### 看进度 / 出报告
+
+| 想做的事 | 怎么说 |
+|---------|--------|
+| 看项目健康度 | "项目怎么样" |
+| 看我的任务 | "我的任务有哪些" |
+| 出日报 | "今天干了啥" |
+| 出周报 | "这周干了啥" |
+
+---
+
+## 五、团队协作
+
+### 团队第一次配置（只做一次）
+
+1. **填源码地址**：打开 `.qoder/config.yaml`，找到 `git_sync.projects`，把 `url` 改成你们团队的 git 地址（文件里有 `← 改成你的` 提示）
+2. **注册自动更新**（全队只需一台机器）：运行 `python .qoder/scripts/setup_weekly_cron.bat`
+3. **配飞书**（可选）：`.qoder/config.yaml` 里 `feishu` 段，填 webhook 地址，设 `enabled: true`
+
+### 每个成员加入
+
+```
+npx wlkj init 你的名字
+```
+
+每人跑一次就行。
+
+### 日常协作
+
+| 场景 | 你做什么 | 自动发生什么 |
+|------|---------|------------|
+| 写了 PRD 想分享 | 说"同步" | 推到团队仓库 |
+| 想拿队友的最新 | 说"拉取最新" | 自动拉取 |
+| 看全队进度 | "项目怎么样" | 显示全员任务 |
+| 派任务给人 | 建任务时指定负责人 | 任务标记归属 |
+
+---
+
+## 六、看不到命令怎么办
+
+| 现象 | 解决 |
+|------|------|
+| Quest 里输 `/` 没反应 | **新建一个对话**（改了配置后必须新建对话） |
+| QoderWork 里没命令 | 跑 `python .qoder/scripts/install_qoderwork.py`，然后**重启 QoderWork** |
+| 命令报错 | 跑 `python .qoder/scripts/init_doctor.py --fix` 自动修复 |
+
+---
+
+## 七、速查表
+
+```
+新项目     → mkdir 文件夹 && cd 文件夹 && npx wlkj init
+写需求     → /wl-prd
+查代码     → /wl-search
+建任务     → /wl-task
+看进度     → /wl-status
+出报告     → /wl-report
+拉最新     → /wl-init
+环境坏了   → python .qoder/scripts/init_doctor.py --fix
+```
+
+记不住？直接说中文，AI 会自动识别。