@hupan56/wlkj 2.7.3 → 2.7.4

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,104 +0,0 @@
1
- ---
2
- name: wl-prd-review
3
- description: "评审 PRD 完整性与质量(7 项 checklist + EVA 评分)。"
4
- argument-hint: "[可选: PRD文件路径] 不给则列出最近 PRD 让用户选"
5
- auto-approve: true
6
- allowed-tools: [Read, Bash]
7
- ---
8
-
9
- # /wl-prd-review - 评审 PRD 完整性与质量
10
-
11
- User input: $ARGUMENTS
12
-
13
- > **定位:评审已有 PRD,不产出新 PRD。** 拿到一份 PRD,检查它够不够格发布/交付下游。
14
- > 产出的 PRD 要评审,跑这个;要从头写 PRD,走 `/wl-prd-full` 或 `/wl-prd-quick`。
15
-
16
- ---
17
-
18
- ## 🔧 环境自检(QoderWork 桌面端 vs Qoder IDE/CLI)
19
-
20
- **QoderWork 桌面端的工作目录是临时会话目录,不是仓库根!** 相对路径会失效。
21
- ```bash
22
- # 确定仓库根 R:
23
- R=$(python ~/.qoderwork/repo_root.py) # QoderWork 桌面端
24
- R=. # IDE/CLI(工作目录就是仓库)
25
- ```
26
-
27
- ---
28
-
29
- ## STEP 0: 定位要评审的 PRD
30
-
31
- **若 $ARGUMENTS 给了文件路径** → 直接 Read 该 PRD。
32
-
33
- **若没给路径** → 扫仓库的这两个目录,列出最近的 PRD 让用户选:
34
- ```bash
35
- # 已归档的可发布 PRD
36
- dir /b "$R\data\docs\prd\REQ-*.md"
37
- # 还在草稿区的
38
- dir /b "$R\workspace\members\*\drafts\REQ-*.md"
39
- ```
40
- 列出最近 5-10 份(带 REQ-ID 和标题),让用户选要评审哪份。
41
-
42
- ---
43
-
44
- ## STEP 1: 7 项人工评审 Checklist
45
-
46
- 读完 PRD 后,逐项检查:
47
-
48
- - [ ] **用户故事清晰**:每类用户要做什么,说清楚了
49
- - [ ] **验收标准可测**:每个功能点有 Given-When-Then,能照着测
50
- - [ ] **优先级已标**:功能点标了 P0/P1/P2/P3
51
- - [ ] **模块/领域已识别**:属于哪个业务模块明确
52
- - [ ] **非功能性需求已列**:性能/兼容/安全等(适用的话)
53
- - [ ] **边界情况已考虑**:每个功能 ≥2 个异常场景(空数据/超长/并发/权限等)
54
- - [ ] **依赖已识别**:依赖的其他模块/API/上下游说清了
55
-
56
- ---
57
-
58
- ## STEP 2: 跑 EVA 客观评分
59
-
60
- 给 PRD 打客观分数(这是评审的硬依据,在仓库根下执行):
61
- ```bash
62
- cd "$R" && python .qoder/scripts/eval_prd.py <PRD路径> [原型HTML路径]
63
- ```
64
-
65
- | 维度 | 权重 | 检查内容 |
66
- |------|------|----------|
67
- | A1 现实锚定 | 40 分 | 字段/API 在索引命中比例(有没有发明字段) |
68
- | A2 风格保真 | 30 分 | 原型颜色来自真源(无原型则跳过) |
69
- | A3 模板完整 | 30 分 | 章节齐全比例 |
70
-
71
- **≥ 80% 才 PASS**。低于 80% 把 EVA 报告的问题合并进 STEP 3 的修复清单。
72
-
73
- > 注意 mode 标记:quick PRD(`<!-- mode: quick -->`)会跳过 EVA 完整检查;reference/full PRD 跑全套。评审时尊重 mode 差异——quick PRD 不该用 13 章标准苛求。
74
-
75
- ---
76
-
77
- ## STEP 3: 合并报告
78
-
79
- 把 STEP 1 的 checklist 结果 + STEP 2 的 EVA 分数合并成评审报告:
80
-
81
- **若 PASS**(checklist 全过 + EVA ≥80%):
82
- ```
83
- ✅ PRD 评审通过
84
- - EVA 分数: XX/100
85
- - 7 项检查: 全部通过
86
- 建议:可发布(跑 /wl-prd-full 或 /wl-prd-quick 的发布流程),或直接建任务。
87
- ```
88
-
89
- **若不 PASS**:
90
- ```
91
- ❌ PRD 需修复,问题清单:
92
- 1. [必须] 验收标准缺 Given-When-Then(功能 X)
93
- 2. [必须] A1 命中率仅 45%,疑似发明字段:abcField, xyzStatus
94
- 3. [建议] 边界情况只考虑了空数据,缺超长/并发场景
95
- ...
96
- 修复后重新评审:/wl-prd-review <PRD路径>
97
- ```
98
-
99
- ---
100
-
101
- ## ⚙️ 自取上下文(Quest / QoderWork 无 hook 注入,必须自读)
102
-
103
- - `.qoder/.developer` — 当前评审人
104
- - `data/index/.index-meta.json` — 图谱新鲜度(影响 A1 现实锚定能否校验;过期则 A1 可能漏报)