@hupan56/wlkj 2.2.4 → 2.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,25 +1,25 @@
1
- ---
2
- name: design-review
3
- description: "评审设计交付物的完整性。Review design artifacts for completeness. 用户说'评审设计''设计稿看一下''检查交互稿'时触发。"
4
- trigger: "user invokes /review design, asks to check design, or designer submits design artifacts"
5
- ---
6
-
7
- # Design Review Skill
8
-
9
- ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
-
11
- - `.qoder/.developer` — 当前评审人
12
- - 设计文件路径由用户指定,或扫 `workspace/members/{dev}/drafts/prototype-*.html`
13
-
14
- ## 检查项 (Checklist)
15
- - [ ] 组件规格完整(components.json)
16
- - [ ] 交互流程覆盖所有状态(interaction-flow.md)
17
- - [ ] 技术约束已标注
18
- - [ ] 响应式/设计 Token 已定义
19
- - [ ] 符合 PRD 需求
20
- - [ ] **图标来自真源(data/index/icon-reference.json),无 emoji**(硬性)
21
- - [ ] 颜色来自真源(Web: vben-style-reference.json;APP: Vant 变量)
22
-
23
- ## 输出
24
-
25
- 报告:PASS 或 列出需修复的问题清单
1
+ ---
2
+ name: design-review
3
+ description: "评审设计交付物的完整性。Review design artifacts for completeness. 用户说'评审设计''设计稿看一下''检查交互稿'时触发。"
4
+ trigger: "user invokes /review design, asks to check design, or designer submits design artifacts"
5
+ ---
6
+
7
+ # Design Review Skill
8
+
9
+ ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
+
11
+ - `.qoder/.developer` — 当前评审人
12
+ - 设计文件路径由用户指定,或扫 `workspace/members/{dev}/drafts/prototype-*.html`
13
+
14
+ ## 检查项 (Checklist)
15
+ - [ ] 组件规格完整(components.json)
16
+ - [ ] 交互流程覆盖所有状态(interaction-flow.md)
17
+ - [ ] 技术约束已标注
18
+ - [ ] 响应式/设计 Token 已定义
19
+ - [ ] 符合 PRD 需求
20
+ - [ ] **图标来自真源(data/index/icon-reference.json),无 emoji**(硬性)
21
+ - [ ] 颜色来自真源(Web: vben-style-reference.json;APP: Vant 变量)
22
+
23
+ ## 输出
24
+
25
+ 报告:PASS 或 列出需修复的问题清单
@@ -1,180 +1,180 @@
1
- ---
2
- name: prd-generator
3
- description: "生成 PRD + 平台匹配的原型。Generate PRD with platform-aware prototype. 用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'时触发。"
4
- trigger: "user describes a requirement, asks for PRD, mockup, or invokes /wl-prd"
5
- ---
6
-
7
- # PRD Generator Skill
8
-
9
- ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
-
11
- 会话开始时先读这 3 个文件(不存在就跳过,不要报错中断):
12
- - `.qoder/.developer` — 当前开发者名(key=value 格式,用于产出存到 `workspace/members/{dev}/drafts/`)
13
- - `.qoder/.current-task` — 当前活动任务(决定 PRD 关联哪个 task)
14
- - `data/index/.index-meta.json` — 知识图谱新鲜度(过期要提示先 `/wl-init` 重建)
15
-
16
- 读完后再判断是否要问平台(见 Step 0)。如果 `.developer` 不存在,先提示用户
17
- "还没初始化,建议先说'初始化'(/wl-init)注册开发者身份",但不要阻塞。
18
-
19
- ---
20
-
21
- ## ⚠️ STEP 0: MANDATORY PLATFORM SELECTION (MUST DO FIRST!)
22
-
23
- **CRITICAL: You MUST ask this question BEFORE doing ANYTHING else.**
24
- **NEVER auto-detect. NEVER assume. NEVER skip. ALWAYS ASK.**
25
-
26
- **Copy and ask this exact question:**
27
-
28
- ```
29
- 这个需求是针对哪个平台?
30
-
31
- 1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
32
- 2. **APP 移动端** (Carmg-H5) - Vant 风格
33
- 3. **两端都要**
34
-
35
- 请选择 (1/2/3):
36
- ```
37
-
38
- **Then WAIT for user answer before proceeding.**
39
-
40
- ### Platform → Project Mapping
41
-
42
- | User Answer | Platform | Project | Component Library | Template |
43
- |-------------|----------|---------|-------------------|----------|
44
- | 1 或 Web/PC/管理端 | Web | fywl-ui | Ant Design Vue + VxeGrid | prototype-web.html |
45
- | 2 或 APP/H5/移动端 | APP | Carmg-H5 | Vant 3 + Element Plus | prototype-app.html |
46
- | 3 或 都要/两端 | Both | Both | Generate 2 prototypes | Both templates |
47
-
48
- ### Search Command
49
-
50
- After user selects platform, use:
51
- ```bash
52
- /wl-search <keyword> --platform web # For Web
53
- /wl-search <keyword> --platform app # For APP
54
- /wl-search <keyword> # For Both
55
- ```
56
-
57
- ---
58
-
59
- ## How Each Mode Reads Data
60
-
61
- ### Reference Mode (DEFAULT)
62
- 1. **ASK PLATFORM FIRST** (Step 0 above)
63
- 2. search_index.py <keyword> --platform <web|app>
64
- 3. search_index.py --style <type> --platform <web|app>
65
- 4. search_index.py --field <name>
66
- 5. Read data/docs/prd/ for historical PRDs
67
- 6. Read data/docs/drafts/ for business context
68
- 7. Style tokens: Web -> data/index/vben-style-reference.json, APP -> Vant
69
- variables. Only open data/style/ PDFs if a token is missing from JSON.
70
- 8. Read top 2-3 similar Vue files from CORRECT project
71
- 9. Present ALL findings as ONE numbered list, confirm in a single round
72
- (batch, not one question per finding)
73
- 10. Generate PRD with product-type template
74
- 11. Generate interactive HTML prototype matching TARGET platform style
75
-
76
- ### Brainstorm Mode
77
- 1. **ASK PLATFORM FIRST** (Step 0 above)
78
- 2. SCAMPER 7 dimensions
79
- 3. 5-Why root cause analysis
80
- 4. Dispatch N sub-agents (web search only)
81
- 5. Read existing code from TARGET platform for style extraction
82
- 6. Generate PRD + prototype (platform-specific)
83
-
84
- ### Planning Mode
85
- 1. **ASK PLATFORM FIRST** (Step 0 above)
86
- 2. search_index.py for current implementation (platform-aware)
87
- 3. Web search for ideal state
88
- 4. Gap analysis table
89
- 5. Generate PRD + prototype (platform-specific)
90
-
91
- ### Quick Mode
92
- 1. **ASK PLATFORM FIRST** (Step 0 above)
93
- 2. search_index.py to locate code (platform-aware)
94
- 3. Generate Mini-PRD + quick prototype (platform-specific)
95
-
96
- ---
97
-
98
- ## Platform-Specific Style Sources
99
-
100
- ### Web 管理端 (fywl-ui)
101
- ```
102
- 样式来源: data/index/vben-style-reference.json
103
- 组件库: Ant Design Vue + VxeGrid
104
- 设计 Token: Vben Admin HSL 变量
105
- 关键文件: data/code/fywl-ui/apps/xxx/index.vue
106
- 原型模板: .qoder/templates/prototype-web.html
107
- ```
108
-
109
- **CSS Variables (Web):**
110
- ```css
111
- --primary: 212 100% 45%; /* 蓝色 */
112
- --destructive: 359.33 100% 65.1%; /* 红色 */
113
- --success: 144 57% 58%; /* 绿色 */
114
- --background-deep: 216 20.11% 95.47%; /* 灰底 */
115
- ```
116
-
117
- ### APP 移动端 (Carmg-H5)
118
- ```
119
- 样式来源: data/code/Carmg-H5/src/
120
- 组件库: Vant 3 + Element Plus
121
- 适配: postcss-px-to-viewport (vw) + lib-flexible (rem)
122
- 关键文件: data/code/Carmg-H5/src/modules/xxx/index.vue
123
- 原型模板: .qoder/templates/prototype-app.html
124
- ```
125
-
126
- **Design Tokens (APP):**
127
- ```css
128
- --van-primary-color: #1989fa;
129
- --van-success-color: #07c160;
130
- --van-warning-color: #ff976a;
131
- --van-danger-color: #ee0a24;
132
- max-width: 375px; /* 移动端基准 */
133
- ```
134
-
135
- ---
136
-
137
- ## Prototype Generation Rules
138
-
139
- ### Required Features
140
- - Style matches TARGET platform EXACTLY
141
- - Changed/new elements highlighted with subtle border
142
- - Interactive: clickable buttons, fillable forms
143
- - Single HTML file, self-contained
144
- - **Web**: Desktop layout, sidebar navigation
145
- - **APP**: Mobile layout, bottom tab bar, 375px width
146
-
147
- ### Style Priority (when conflicts)
148
- 1. Real .vue files in project (HIGHEST)
149
- 2. data/style/ PDF specs
150
- 3. vben-style-reference.json (framework default)
151
- 4. If PDF vs Code conflict → **Code wins**
152
-
153
- ---
154
-
155
- ## PRD Templates (团队标准, MUST USE)
156
-
157
- Distilled from data/docs/constitution/prdtemplate/*.docx (团队章程源文件):
158
-
159
- | Mode | Template | Rule |
160
- |------|----------|------|
161
- | Reference / Brainstorm / Planning | .qoder/templates/prd-full-template.md | 所有章节必须保留(不适用写"无") |
162
- | Quick | .qoder/templates/prd-quick-template.md | 改动要素涉及则填,章节标题保留 |
163
-
164
- Read the template file, fill it with the findings. The 10-point quality
165
- check below maps to the template's 自检 section. If the .docx 源文件更新了,
166
- re-distill the .md templates (wl-init doctor 会提示).
167
-
168
- ---
169
-
170
- ## Quality Self-Check (10 Items)
171
- 1. Background answers "why"
172
- 2. Goals are quantifiable
173
- 3. User personas specific
174
- 4. Business rules exhaustive
175
- 5. Exceptions covered (2+ per feature)
176
- 6. AC testable (Given-When-Then)
177
- 7. Data events complete
178
- 8. No tech implementation in PRD
179
- 9. Priority tagged (P0/P1/P2)
180
- 10. Schedule grounded
1
+ ---
2
+ name: prd-generator
3
+ description: "生成 PRD + 平台匹配的原型。Generate PRD with platform-aware prototype. 用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'时触发。"
4
+ trigger: "user describes a requirement, asks for PRD, mockup, or invokes /wl-prd"
5
+ ---
6
+
7
+ # PRD Generator Skill
8
+
9
+ ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
+
11
+ 会话开始时先读这 3 个文件(不存在就跳过,不要报错中断):
12
+ - `.qoder/.developer` — 当前开发者名(key=value 格式,用于产出存到 `workspace/members/{dev}/drafts/`)
13
+ - `.qoder/.current-task` — 当前活动任务(决定 PRD 关联哪个 task)
14
+ - `data/index/.index-meta.json` — 知识图谱新鲜度(过期要提示先 `/wl-init` 重建)
15
+
16
+ 读完后再判断是否要问平台(见 Step 0)。如果 `.developer` 不存在,先提示用户
17
+ "还没初始化,建议先说'初始化'(/wl-init)注册开发者身份",但不要阻塞。
18
+
19
+ ---
20
+
21
+ ## ⚠️ STEP 0: MANDATORY PLATFORM SELECTION (MUST DO FIRST!)
22
+
23
+ **CRITICAL: You MUST ask this question BEFORE doing ANYTHING else.**
24
+ **NEVER auto-detect. NEVER assume. NEVER skip. ALWAYS ASK.**
25
+
26
+ **Copy and ask this exact question:**
27
+
28
+ ```
29
+ 这个需求是针对哪个平台?
30
+
31
+ 1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
32
+ 2. **APP 移动端** (Carmg-H5) - Vant 风格
33
+ 3. **两端都要**
34
+
35
+ 请选择 (1/2/3):
36
+ ```
37
+
38
+ **Then WAIT for user answer before proceeding.**
39
+
40
+ ### Platform → Project Mapping
41
+
42
+ | User Answer | Platform | Project | Component Library | Template |
43
+ |-------------|----------|---------|-------------------|----------|
44
+ | 1 或 Web/PC/管理端 | Web | fywl-ui | Ant Design Vue + VxeGrid | prototype-web.html |
45
+ | 2 或 APP/H5/移动端 | APP | Carmg-H5 | Vant 3 + Element Plus | prototype-app.html |
46
+ | 3 或 都要/两端 | Both | Both | Generate 2 prototypes | Both templates |
47
+
48
+ ### Search Command
49
+
50
+ After user selects platform, use:
51
+ ```bash
52
+ /wl-search <keyword> --platform web # For Web
53
+ /wl-search <keyword> --platform app # For APP
54
+ /wl-search <keyword> # For Both
55
+ ```
56
+
57
+ ---
58
+
59
+ ## How Each Mode Reads Data
60
+
61
+ ### Reference Mode (DEFAULT)
62
+ 1. **ASK PLATFORM FIRST** (Step 0 above)
63
+ 2. search_index.py <keyword> --platform <web|app>
64
+ 3. search_index.py --style <type> --platform <web|app>
65
+ 4. search_index.py --field <name>
66
+ 5. Read data/docs/prd/ for historical PRDs
67
+ 6. Read data/docs/drafts/ for business context
68
+ 7. Style tokens: Web -> data/index/vben-style-reference.json, APP -> Vant
69
+ variables. Only open data/style/ PDFs if a token is missing from JSON.
70
+ 8. Read top 2-3 similar Vue files from CORRECT project
71
+ 9. Present ALL findings as ONE numbered list, confirm in a single round
72
+ (batch, not one question per finding)
73
+ 10. Generate PRD with product-type template
74
+ 11. Generate interactive HTML prototype matching TARGET platform style
75
+
76
+ ### Brainstorm Mode
77
+ 1. **ASK PLATFORM FIRST** (Step 0 above)
78
+ 2. SCAMPER 7 dimensions
79
+ 3. 5-Why root cause analysis
80
+ 4. Dispatch N sub-agents (web search only)
81
+ 5. Read existing code from TARGET platform for style extraction
82
+ 6. Generate PRD + prototype (platform-specific)
83
+
84
+ ### Planning Mode
85
+ 1. **ASK PLATFORM FIRST** (Step 0 above)
86
+ 2. search_index.py for current implementation (platform-aware)
87
+ 3. Web search for ideal state
88
+ 4. Gap analysis table
89
+ 5. Generate PRD + prototype (platform-specific)
90
+
91
+ ### Quick Mode
92
+ 1. **ASK PLATFORM FIRST** (Step 0 above)
93
+ 2. search_index.py to locate code (platform-aware)
94
+ 3. Generate Mini-PRD + quick prototype (platform-specific)
95
+
96
+ ---
97
+
98
+ ## Platform-Specific Style Sources
99
+
100
+ ### Web 管理端 (fywl-ui)
101
+ ```
102
+ 样式来源: data/index/vben-style-reference.json
103
+ 组件库: Ant Design Vue + VxeGrid
104
+ 设计 Token: Vben Admin HSL 变量
105
+ 关键文件: data/code/fywl-ui/apps/xxx/index.vue
106
+ 原型模板: .qoder/templates/prototype-web.html
107
+ ```
108
+
109
+ **CSS Variables (Web):**
110
+ ```css
111
+ --primary: 212 100% 45%; /* 蓝色 */
112
+ --destructive: 359.33 100% 65.1%; /* 红色 */
113
+ --success: 144 57% 58%; /* 绿色 */
114
+ --background-deep: 216 20.11% 95.47%; /* 灰底 */
115
+ ```
116
+
117
+ ### APP 移动端 (Carmg-H5)
118
+ ```
119
+ 样式来源: data/code/Carmg-H5/src/
120
+ 组件库: Vant 3 + Element Plus
121
+ 适配: postcss-px-to-viewport (vw) + lib-flexible (rem)
122
+ 关键文件: data/code/Carmg-H5/src/modules/xxx/index.vue
123
+ 原型模板: .qoder/templates/prototype-app.html
124
+ ```
125
+
126
+ **Design Tokens (APP):**
127
+ ```css
128
+ --van-primary-color: #1989fa;
129
+ --van-success-color: #07c160;
130
+ --van-warning-color: #ff976a;
131
+ --van-danger-color: #ee0a24;
132
+ max-width: 375px; /* 移动端基准 */
133
+ ```
134
+
135
+ ---
136
+
137
+ ## Prototype Generation Rules
138
+
139
+ ### Required Features
140
+ - Style matches TARGET platform EXACTLY
141
+ - Changed/new elements highlighted with subtle border
142
+ - Interactive: clickable buttons, fillable forms
143
+ - Single HTML file, self-contained
144
+ - **Web**: Desktop layout, sidebar navigation
145
+ - **APP**: Mobile layout, bottom tab bar, 375px width
146
+
147
+ ### Style Priority (when conflicts)
148
+ 1. Real .vue files in project (HIGHEST)
149
+ 2. data/style/ PDF specs
150
+ 3. vben-style-reference.json (framework default)
151
+ 4. If PDF vs Code conflict → **Code wins**
152
+
153
+ ---
154
+
155
+ ## PRD Templates (团队标准, MUST USE)
156
+
157
+ Distilled from data/docs/constitution/prdtemplate/*.docx (团队章程源文件):
158
+
159
+ | Mode | Template | Rule |
160
+ |------|----------|------|
161
+ | Reference / Brainstorm / Planning | .qoder/templates/prd-full-template.md | 所有章节必须保留(不适用写"无") |
162
+ | Quick | .qoder/templates/prd-quick-template.md | 改动要素涉及则填,章节标题保留 |
163
+
164
+ Read the template file, fill it with the findings. The 10-point quality
165
+ check below maps to the template's 自检 section. If the .docx 源文件更新了,
166
+ re-distill the .md templates (wl-init doctor 会提示).
167
+
168
+ ---
169
+
170
+ ## Quality Self-Check (10 Items)
171
+ 1. Background answers "why"
172
+ 2. Goals are quantifiable
173
+ 3. User personas specific
174
+ 4. Business rules exhaustive
175
+ 5. Exceptions covered (2+ per feature)
176
+ 6. AC testable (Given-When-Then)
177
+ 7. Data events complete
178
+ 8. No tech implementation in PRD
179
+ 9. Priority tagged (P0/P1/P2)
180
+ 10. Schedule grounded
@@ -1,36 +1,36 @@
1
- ---
2
- name: prd-review
3
- description: "评审 PRD 完整性与质量。Review PRD for completeness and quality. 用户说'评审PRD''PRD质量怎么样''检查一下这个需求文档'时触发。"
4
- trigger: "user invokes /review prd, asks to review/check PRD quality, or PM submits PRD"
5
- ---
6
-
7
- # PRD Review Skill
8
-
9
- ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
-
11
- - `.qoder/.developer` — 当前评审人
12
- - `data/index/.index-meta.json` — 图谱新鲜度(影响"现实锚定"能否校验)
13
- - 评审的 PRD 文件路径由用户指定;若用户没给路径,扫 `data/docs/prd/` 和
14
- `workspace/members/{dev}/drafts/` 列出最近的 PRD 让用户选
15
-
16
- ## 评审检查项 (Checklist)
17
- - [ ] 用户故事清晰
18
- - [ ] 验收标准可测(Given-When-Then)
19
- - [ ] 优先级已标(P0/P1/P2/P3)
20
- - [ ] 模块/领域已识别
21
- - [ ] 非功能性需求已列
22
- - [ ] 边界情况已考虑(每个功能 ≥2 个异常场景)
23
- - [ ] 依赖已识别
24
-
25
- ## 评审输出
26
-
27
- 报告:PASS 或 列出需修复的问题清单
28
- 若 PASS:更新任务状态为 prd_review passed
29
-
30
- ## 自动化校验(推荐)
31
-
32
- 跑一次 EVA 门禁给出客观分数:
33
- ```bash
34
- python .qoder/scripts/eval_prd.py <PRD路径> [原型HTML路径]
35
- ```
36
- 分数 ≥80% 才能发布。低于 80% 把 EVA 报告的问题合并进上面的清单。
1
+ ---
2
+ name: prd-review
3
+ description: "评审 PRD 完整性与质量。Review PRD for completeness and quality. 用户说'评审PRD''PRD质量怎么样''检查一下这个需求文档'时触发。"
4
+ trigger: "user invokes /review prd, asks to review/check PRD quality, or PM submits PRD"
5
+ ---
6
+
7
+ # PRD Review Skill
8
+
9
+ ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
10
+
11
+ - `.qoder/.developer` — 当前评审人
12
+ - `data/index/.index-meta.json` — 图谱新鲜度(影响"现实锚定"能否校验)
13
+ - 评审的 PRD 文件路径由用户指定;若用户没给路径,扫 `data/docs/prd/` 和
14
+ `workspace/members/{dev}/drafts/` 列出最近的 PRD 让用户选
15
+
16
+ ## 评审检查项 (Checklist)
17
+ - [ ] 用户故事清晰
18
+ - [ ] 验收标准可测(Given-When-Then)
19
+ - [ ] 优先级已标(P0/P1/P2/P3)
20
+ - [ ] 模块/领域已识别
21
+ - [ ] 非功能性需求已列
22
+ - [ ] 边界情况已考虑(每个功能 ≥2 个异常场景)
23
+ - [ ] 依赖已识别
24
+
25
+ ## 评审输出
26
+
27
+ 报告:PASS 或 列出需修复的问题清单
28
+ 若 PASS:更新任务状态为 prd_review passed
29
+
30
+ ## 自动化校验(推荐)
31
+
32
+ 跑一次 EVA 门禁给出客观分数:
33
+ ```bash
34
+ python .qoder/scripts/eval_prd.py <PRD路径> [原型HTML路径]
35
+ ```
36
+ 分数 ≥80% 才能发布。低于 80% 把 EVA 报告的问题合并进上面的清单。