@hupan56/wlkj 2.3.4 → 2.4.0

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

@@ -6,175 +6,94 @@ trigger: "user describes a requirement, asks for PRD, mockup, or invokes /wl-prd
 
 # PRD Generator Skill
 
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+## 性能原则（最重要的规则）
 
-会话开始时先读这 3 个文件（不存在就跳过，不要报错中断）：
-- `.qoder/.developer` — 当前开发者名（key=value 格式，用于产出存到 `workspace/members/{dev}/drafts/`）
-- `.qoder/.current-task` — 当前活动任务（决定 PRD 关联哪个 task）
-- `data/index/.index-meta.json` — 知识图谱新鲜度（过期要提示先 `/wl-init` 重建）
+1. **最少轮次**: Quick <=5 轮, Reference <=10 轮。不要 60 轮"深度思考"
+2. **一次取全**: 用 context_pack 一次拿全上下文，不要逐个 search（5-6 次变 1 次）
+3. **批量生成**: PRD + 原型一次 Write 写完，不分两轮
+4. **不重复读**: 模板已有正确颜色（vben-style / Vant），不要单独读 style JSON
+5. **并行调用**: 独立操作放一个消息里并行（如同时 Read 2 个文件）
+6. **Quick 跳过**: EVA / 历史 PRD / 网络搜索 / style JSON
 
-读完后再判断是否要问平台（见 Step 0）。如果 `.developer` 不存在，先提示用户
-"还没初始化，建议先说'初始化'（/wl-init）注册开发者身份"，但不要阻塞。
+## 自取上下文（Quest / QoderWork 无 hook，必须自读）
 
----
-
-## ⚠️ STEP 0: MANDATORY PLATFORM SELECTION (MUST DO FIRST!)
-
-**CRITICAL: You MUST ask this question BEFORE doing ANYTHING else.**
-**NEVER auto-detect. NEVER assume. NEVER skip. ALWAYS ASK.**
+- `.qoder/.developer` — 当前开发者名
+- `.qoder/.current-task` — 当前活动任务
+- `data/index/.index-meta.json` — 知识图谱新鲜度
 
-**Copy and ask this exact question:**
+## STEP 0: 必须先问平台
 
 ```
 这个需求是针对哪个平台？
-
-1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
-2. **APP 移动端** (Carmg-H5) - Vant 风格  
-3. **两端都要**
-
+1. Web 管理端 (fywl-ui) - Ant Design Vue + VxeGrid 风格
+2. APP 移动端 (Carmg-H5) - Vant 风格
+3. 两端都要
 请选择 (1/2/3):
 ```
+等用户回答。绝不自动判断。
 
-**Then WAIT for user answer before proceeding.**
+| 回答 | 平台 | 项目 | 原型模板 |
+|------|------|------|---------|
+| 1 | Web | fywl-ui | prototype-web.html |
+| 2 | APP | Carmg-H5 | prototype-app.html |
+| 3 | Both | Both | 两个模板 |
 
-### Platform → Project Mapping
+## 取上下文 — 一次取全（不要逐个搜）
 
-| User Answer | Platform | Project | Component Library | Template |
-|-------------|----------|---------|-------------------|----------|
-| 1 或 Web/PC/管理端 | Web | fywl-ui | Ant Design Vue + VxeGrid | prototype-web.html |
-| 2 或 APP/H5/移动端 | APP | Carmg-H5 | Vant 3 + Element Plus | prototype-app.html |
-| 3 或 都要/两端 | Both | Both | Generate 2 prototypes | Both templates |
-
-### Search Command
-
-After user selects platform, use:
 ```bash
-/wl-search <keyword> --platform web   # For Web
-/wl-search <keyword> --platform app   # For APP
-/wl-search <keyword>                  # For Both
+python .qoder/scripts/context_pack.py <关键词> --platform <web|app>
 ```
-
----
-
-## How Each Mode Reads Data
-
-### Reference Mode (DEFAULT)
-1. **ASK PLATFORM FIRST** (Step 0 above)
-2. search_index.py <keyword> --platform <web|app>
-3. search_index.py --style <type> --platform <web|app>
-4. search_index.py --field <name>
-5. Read data/docs/prd/ for historical PRDs
-6. Read data/docs/drafts/ for business context
-7. Style tokens: Web -> data/index/vben-style-reference.json, APP -> Vant
-   variables. Only open data/style/ PDFs if a token is missing from JSON.
-8. Read top 2-3 similar Vue files from CORRECT project
-9. Present ALL findings as ONE numbered list, confirm in a single round
-   (batch, not one question per finding)
-10. Generate PRD with product-type template
-11. Generate interactive HTML prototype matching TARGET platform style
-
-### Brainstorm Mode
-1. **ASK PLATFORM FIRST** (Step 0 above)
-2. SCAMPER 7 dimensions
-3. 5-Why root cause analysis
-4. Dispatch N sub-agents (web search only)
-5. Read existing code from TARGET platform for style extraction
-6. Generate PRD + prototype (platform-specific)
-
-### Planning Mode
-1. **ASK PLATFORM FIRST** (Step 0 above)
-2. search_index.py for current implementation (platform-aware)
-3. Web search for ideal state
-4. Gap analysis table
-5. Generate PRD + prototype (platform-specific)
-
-### Quick Mode
-1. **ASK PLATFORM FIRST** (Step 0 above)
-2. search_index.py to locate code (platform-aware)
-3. Generate Mini-PRD + quick prototype (platform-specific)
-
----
-
-## Platform-Specific Style Sources
-
-### Web 管理端 (fywl-ui)
-```
-样式来源: data/index/vben-style-reference.json
-组件库: Ant Design Vue + VxeGrid
-设计 Token: Vben Admin HSL 变量
-关键文件: data/code/fywl-ui/apps/xxx/index.vue
-原型模板: .qoder/templates/prototype-web.html
-```
-
-**CSS Variables (Web):**
-```css
---primary: 212 100% 45%;        /* 蓝色 */
---destructive: 359.33 100% 65.1%; /* 红色 */
---success: 144 57% 58%;         /* 绿色 */
---background-deep: 216 20.11% 95.47%; /* 灰底 */
-```
-
-### APP 移动端 (Carmg-H5)
-```
-样式来源: data/code/Carmg-H5/src/
-组件库: Vant 3 + Element Plus
-适配: postcss-px-to-viewport (vw) + lib-flexible (rem)
-关键文件: data/code/Carmg-H5/src/modules/xxx/index.vue
-原型模板: .qoder/templates/prototype-app.html
-```
-
-**Design Tokens (APP):**
-```css
---van-primary-color: #1989fa;
---van-success-color: #07c160;
---van-warning-color: #ff976a;
---van-danger-color: #ee0a24;
-max-width: 375px; /* 移动端基准 */
-```
-
----
-
-## Prototype Generation Rules
-
-### Required Features
-- Style matches TARGET platform EXACTLY
-- Changed/new elements highlighted with subtle border
-- Interactive: clickable buttons, fillable forms
-- Single HTML file, self-contained
-- **Web**: Desktop layout, sidebar navigation
-- **APP**: Mobile layout, bottom tab bar, 375px width
-
-### Style Priority (when conflicts)
-1. Real .vue files in project (HIGHEST)
-2. data/style/ PDF specs
-3. vben-style-reference.json (framework default)
-4. If PDF vs Code conflict → **Code wins**
-
----
-
-## PRD Templates (团队标准, MUST USE)
-
-Distilled from data/docs/constitution/prdtemplate/*.docx (团队章程源文件):
-
-| Mode | Template | Rule |
-|------|----------|------|
-| Reference / Brainstorm / Planning | .qoder/templates/prd-full-template.md | 所有章节必须保留（不适用写"无"） |
-| Quick | .qoder/templates/prd-quick-template.md | 改动要素涉及则填，章节标题保留 |
-
-Read the template file, fill it with the findings. The 10-point quality
-check below maps to the template's 自检 section. If the .docx 源文件更新了,
-re-distill the .md templates (wl-init doctor 会提示).
-
----
-
-## Quality Self-Check (10 Items)
-1. Background answers "why"
-2. Goals are quantifiable
-3. User personas specific
-4. Business rules exhaustive
-5. Exceptions covered (2+ per feature)
-6. AC testable (Given-When-Then)
-7. Data events complete
-8. No tech implementation in PRD
-9. Priority tagged (P0/P1/P2)
-10. Schedule grounded
+返回 7 章节（代码+页面+字段+PRD+API+样式+Wiki）。**只读最相关 1-2 个 Vue 文件**。
+
+## 五种模式
+
+### Reference（默认 — 直接说需求）
+1. 问平台
+2. context_pack 一次取全
+3. 读 1-2 个 Vue 文件
+4. 一次性确认发现
+5. **一次 Write** PRD + 原型
+6. EVA 评估 + 确认发布
+
+### Quick（快速 — "快速""加个字段""小改动"）
+1. 问平台
+2. context_pack 一次取全
+3. **一次 Write** Mini-PRD + 微型原型
+4. 一句话确认 → push
+> 跳过：EVA / 历史 PRD / 搜索 / style JSON
+
+### Discuss（探讨 — "探讨""聊聊""分析"）
+1. 听需求
+2. 问关键问题（痛点/谁用/现状/目标）
+3. 给 2-3 个方向建议
+> 不出文件。聊完说"出PRD"转 Reference
+
+### Brainstorm（头脑风暴）
+1. 问平台
+2. SCAMPER + 多 agent 调研
+3. 生成 PRD + 原型
+
+### Planning（规划）
+1. 问平台
+2. 现状 + 理想态 + Gap + MVP
+3. 生成 PRD + 原型
+
+## 原型规则
+
+- 从模板开始（`.qoder/templates/prototype-{web|app}.html`），模板已有正确颜色
+- **不要单独读 vben-style-reference.json** — 模板里 CSS 变量已配好
+- 只改 diff 部分，新功能高亮
+- 单 HTML 文件，可交互
+- Web: 桌面布局 + 侧边栏；APP: 375px + 底部 tab
+
+## PRD 模板
+
+| 模式 | 模板 |
+|------|------|
+| Reference/Brainstorm/Planning | `.qoder/templates/prd-full-template.md` |
+| Quick | `.qoder/templates/prd-quick-template.md` |
+
+## 质量自检（10 项，Quick 跳过）
+1. 背景回答"为什么" 2. 目标可量化 3. 用户画像具体
+4. 业务规则完整 5. 异常覆盖(2+) 6. 验收可测(Given-When-Then)
+7. 数据事件完整 8. PRD 无技术实现 9. 优先级标注 10. 排期合理

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

@@ -38,10 +38,22 @@ trigger: "用户描述需求、要 PRD、要原型、要 mockup，或直接 /wl-
 - `.qoder/.current-task` — 当前活动任务
 - `data/index/.index-meta.json` — 知识图谱新鲜度（过期提示先 `/wl-init`，不阻塞）
 
-## 完整流程
+## 五种模式（看用户怎么说自动选）
 
-按 `.qoder/commands/wl-prd.md` 执行（含 Reference/Brainstorm/Planning/Quick
-四种模式）。核心步骤：
+| 用户怎么说 | 模式 | 出PRD？ | 出原型？ |
+|-----------|------|---------|---------|
+| 直接说需求（默认） | Reference 参考 | ✅ | ✅ |
+| "探讨""聊聊""分析一下""不知道怎么做" | **Discuss 探讨** | ❌ | ❌ |
+| "头脑风暴""brainstorm" | Brainstorm 头脑风暴 | ✅ | ✅ |
+| "规划""plan" | Planning 规划 | ✅ | ✅ |
+| "快速""quick""加个字段" | Quick 快速 | ✅ | ✅ |
+
+> **探讨模式**：纯讨论，理需求、拆问题、给方向建议。不出文件。
+> 讨论完用户说"出PRD"→ 自动转参考模式。
+
+## 完整流程（Reference/Brainstorm/Planning/Quick 模式）
+
+按 `.qoder/commands/wl-prd.md` 执行。核心步骤：
 
 1. **一次取全上下文**（fast path）：
    ```bash