@hupan56/wlkj 2.6.0 → 2.7.0

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

@@ -1,186 +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 会自动识别。
+# 新手指南
+
+> 不需要懂代码、不需要懂 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-full` | 写需求 |
+| `/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-full
+查代码     → /wl-search
+建任务     → /wl-task
+看进度     → /wl-status
+出报告     → /wl-report
+拉最新     → /wl-init
+环境坏了   → python .qoder/scripts/init_doctor.py --fix
+```
+
+记不住？直接说中文，AI 会自动识别。

package/templates/qoder/agents/prd-planning.md

@@ -1,57 +0,0 @@
-# PRD Planning Agent (Research + Reference)
-
-## Required: Load Context First (Pull-Based)
-Read the dispatch prompt — it MUST contain: platform (Web/APP/Both),
-topic, current developer name. If platform is missing, STOP and report
-back: "platform not specified - caller must ask user first (see /wl-prd Step 0)".
-For task context, run: python .qoder/scripts/task.py current --source
-
-## Recursion Guard
-You are the prd-planning sub-agent. Do NOT spawn another prd-planning agent.
-
-## Your Role
-Combine current reality analysis + future research into a planning report.
-
-## Phase 1: Current State Analysis (Reference)
-1. Scan data/code/ for current implementation
-2. Use data/index/keyword-index.json to locate relevant files
-3. Read data/docs/prd/ for existing PRDs
-4. Read data/docs/drafts/ for business context
-5. Summarize: what exists, how it works, current limitations
-
-## Phase 2: Ideal State Research (Search Web)
-1. Search for competitor products and features
-2. Search for industry trends and best practices
-3. Search for technical solutions and patterns
-4. Summarize: what the ideal state looks like
-
-## Phase 3: Gap Analysis
-Compare Phase 1 vs Phase 2:
-| Dimension | Current | Ideal | Gap |
-Create a table showing all gaps.
-
-## Phase 4: Plans
-### Current Plan (MVP)
-- What to build NOW based on team capacity
-- Prioritized by business value + feasibility
-- Only include what can be done in current sprint
-
-### Future Plan (Roadmap)
-- What to build LATER
-- Group by iteration/version
-- Mark dependencies between items
-
-## Phase 5: Confirm with User
-Present the FULL report in one message. Ask all four questions together:
-1. Is the current state analysis accurate?
-2. Is the ideal state aligned with business goals?
-3. Is the MVP scope right?
-4. Is the roadmap priority correct?
-Adjust based on feedback — at most 2 adjustment rounds, then finalize
-with the user's latest answers (do not loop indefinitely).
-
-## Output
-1. Save planning report to: workspace/members/{developer}/drafts/plan-{topic}.md
-2. If the user wants to proceed with the MVP, also generate
-   PRD + prototype (per /wl-prd Step 6, platform template applies)
-   **PRD 第一行必须是 `<!-- mode: planning -->`** (syncgate/eval_prd 靠此识别模式).

package/templates/qoder/agents/prd-research.md

@@ -1,34 +0,0 @@
-# PRD Research Agent (Brainstorm)
-
-## Required: Load Context First (Pull-Based)
-This platform does NOT auto-inject task context.
-Before doing anything else, you MUST:
-1. Read the dispatch prompt to get active task info
-2. If no task info, run: python .qoder/scripts/task.py current --source
-3. Read the task PRD at the path shown
-
-## Recursion Guard
-You are the prd-research sub-agent.
-Do NOT spawn another prd-research agent.
-
-## Your Role
-You are ONE of N brainstorm agents analyzing a requirement.
-Your specific perspective is defined in the dispatch prompt.
-
-## Workflow
-1. Read your assigned perspective from dispatch prompt
-2. Search the web for relevant information
-3. Analyze the requirement from your perspective
-4. Write your findings to workspace/members/{pm}/drafts/brainstorm-agent{N}-{perspective}.md
-5. Include: key findings, risks, opportunities, recommendations
-
-Note: your report is an intermediate artifact - the caller merges all
-agent reports into the PRD and then deletes brainstorm-agent*.md files.
-合并生成的最终 PRD 第一行必须是 `<!-- mode: brainstorm -->` (syncgate/eval_prd 靠此识别模式).
-
-## Output Format
-# Brainstorm Report: {perspective}
-## Key Findings
-## Risks
-## Opportunities
-## Recommendations

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

@@ -1,51 +0,0 @@
----
-name: wl-insight
-description: "Data insight: user feedback analysis + product metrics review in one command"
-argument-hint: "[type: feedback/metrics/all] [data or description]"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
----
-
-# /wl-insight - Data Insight (Feedback + Metrics)
-
-User input: $ARGUMENTS
-
-## Type Detection
-- "feedback" or paste feedback text -> Feedback analysis
-- "metrics" or paste data table -> Metrics review
-- "all" or no keyword -> Both (if data available)
-- Default: ask user what they want to analyze
-
-## Feedback Analysis
-1. Parse feedback data (text/CSV/paste)
-2. Classify: feature-request / bug / UX / performance / praise / question
-3. Sentiment: positive / neutral / negative
-4. Extract pain points (frequency x severity)
-5. Output:
-   - Category breakdown
-   - Top 10 pain points with representative quotes
-   - Prioritized improvement recommendations
-6. Save to: workspace/members/{dev}/drafts/wl-insight-feedback-{date}.md
-
-## Metrics Review
-1. Parse metrics data
-2. North Star decomposition (North Star -> L1 -> L2)
-3. Growth: DAU/WAU/MAU + user segments
-4. Retention: D1/D7/D30 vs industry benchmarks
-5. Conversion funnel: bottleneck identification
-6. A/B experiment interpretation (if data provided)
-7. OKR alignment check
-8. Anomaly attribution (if metric changed)
-9. Output:
-   - Health overview table
-   - Key insights (data-backed)
-   - Action recommendations
-10. Save to: workspace/members/{dev}/drafts/wl-insight-metrics-{date}.md
-
-## Combined (all)
-Run both analyses. Cross-reference:
-- Metrics anomaly + user feedback = root cause
-- Feedback trends + metric changes = validation
-
-## Output
-Always end with: "Use /wl-prd to convert insights into action"

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

@@ -1,92 +0,0 @@
----
-name: wl-prd
-description: "生成 PRD + 平台匹配的原型（/wl-prd 命令入口）。Generate PRD with platform-aware prototype. 用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'或输入 /wl-prd 时触发。先问平台！"
-trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-prd"
----
-
-# wl-prd — PRD + 原型生成（/wl-prd 命令入口）
-
-> 这是 `/wl-prd` 命令的 skill 入口。QoderWork 的 `/` 列表读 skills，
-> 所以本 skill 让 QoderWork 也能用 `/wl-prd`，与 Qoder IDE 保持一致。
-> 完整工作流见同名 command 文件 `.qoder/commands/wl-prd.md` 和
-> 功能型 skill `.qoder/skills/prd-generator/SKILL.md`。
-
-## ⚠️ STEP 0: 必须先问平台（任何分析前）
-
-```
-这个需求是针对哪个平台？
-
-1. Web 管理端 (fywl-ui) - Ant Design Vue + VxeGrid 风格
-2. APP 移动端 (Carmg-H5) - Vant 风格
-3. 两端都要
-
-请选择 (1/2/3):
-```
-
-**绝不自动判断。绝不假设。绝不跳过。永远先问。等用户回答。**
-
-| 回答 | 平台 | 项目 | 搜索 flag | 原型模板 |
-|------|------|------|-----------|----------|
-| 1 / Web / PC / 管理端 | Web | fywl-ui | `--platform web` | prototype-web.html |
-| 2 / APP / H5 / 移动端 | APP | Carmg-H5 | `--platform app` | prototype-app.html |
-| 3 / 都要 / 两端 | Both | Both | 都跑 | 两个模板，两份原型 |
-
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-
-会话开始先读（不存在就跳过，不要报错中断）：
-- `.qoder/.developer` — 当前开发者名（产出存到 `workspace/members/{dev}/drafts/`）
-- `.qoder/.current-task` — 当前活动任务
-- `data/index/.index-meta.json` — 知识图谱新鲜度（过期提示先 `/wl-init`，不阻塞）
-
-## 四种用法（简单）
-
-| 怎么说 | 做什么 | 出PRD？ |
-|--------|--------|---------|
-| 直接说需求 | 直接生成 | ✅ |
-| "深度"或"规划""创新""调研" | 先分析(现状/Gap/SCAMPER)再生成 | ✅ |
-| "快速"或"加个字段" | Mini-PRD，跳过 EVA | ✅ |
-| "探讨"或"聊聊" | 纯讨论，不出文件 | ❌ |
-
-> **深度模式** = 先做现状+Gap+多角度分析，再出 PRD。适合大需求/新领域/想创新。
-> **探讨模式** = 聊完说"出PRD"→ 自动转默认生成。
->
-> **mode 标记**：生成的 PRD 第一行写 `<!-- mode: quick/brainstorm/planning/reference -->`，
-> syncgate/eval_prd 靠它识别模式（Quick 跳过 EVA）。模板已带默认值，只改值别删。
-
-## 完整流程（默认/深度/快速 模式）
-
-按 `.qoder/commands/wl-prd.md` 执行。核心步骤：
-
-1. **一次取全上下文**（fast path）：
-   ```bash
-   python .qoder/scripts/context_pack.py <业务关键词> --platform <web|app>
-   ```
-2. 读历史 PRD、业务草稿、风格 token
-3. 一次性确认发现（不要一条一条问）
-4. 生成 PRD + 原型（从平台模板开始，填真实字段，diff 高亮）
-5. **EVA 质量门禁**：
-   ```bash
-   python .qoder/scripts/eval_prd.py <draft-prd.md> <prototype.html>
-   ```
-   <80% 就修到 PASS。
-6. 发布 + 归档 + 同步（3 合 1）：
-   ```bash
-   # a. 归档到 data/docs/prd/ (立刻可搜, 不用等 cron)
-   python .qoder/scripts/collect_prds.py
-   # b. 推送到团队 (push 后也会自动再 collect 一次)
-   python .qoder/scripts/team_sync.py push
-   ```
-   > collect_prds 把你的 PRD 从 workspace/members/{你的名字}/drafts/ 拷到 data/docs/prd/，
-   > 这样 search_index --prd 立刻能搜到新 PRD。
-
-详细生成规则、样式 token、原型规则见：
-- 功能型 skill：`.qoder/skills/prd-generator/SKILL.md`
-- 原型规则：`.qoder/skills/prototype-generator/SKILL.md`
-- 命令完整定义：`.qoder/commands/wl-prd.md`
-
-## REQ-ID 分配（并发安全）
-
-**必须**用原子分配器，禁止手动扫描最大值：
-```bash
-python -c "import sys; sys.path.insert(0,'.qoder/scripts'); from common.reqid import allocate_req_id; n=allocate_req_id(); print('REQ-%d-%03d' % (__import__('datetime').date.today().year, n))"
-```