@guru-ai-product/ai-product-kit 0.2.251127120231 → 0.2.251127204055
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.
- package/package.json +1 -1
- package/skills/aipk_aso-new-release/GURU_AI.md +1 -1
- package/skills/aipk_development/GURU_AI.md +1 -1
- package/skills/aipk_format-requirement-pages-with-design/GURU_AI.md +1 -1
- package/skills/aipk_init_project/GURU_AI.md +2 -2
- package/skills/aipk_initiative-planning/GURU_AI.md +1 -1
- package/skills/aipk_requirements-changes/GURU_AI.md +1 -1
- package/skills/aipk_requirements-documentation/GURU_AI.md +1 -1
- package/skills/aipk_requirements-intake/GURU_AI.md +1 -1
- package/skills/aipk_requirements-review/GURU_AI.md +3 -3
- package/skills/aipk_requirements-review/SKILL.md +12 -5
- package/skills/aipk_requirements-review/template/Review_Report_Template.md +15 -5
- package/skills/aipk_skill_generate/GURU_AI.md +1 -1
- package/skills/aipk_tool_prompts/GURU_AI.md +1 -1
- package/skills/aipk_update-requirements-from-design/GURU_AI.md +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guru-ai-product/ai-product-kit",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.251127204055",
|
|
4
4
|
"description": "Sync the AI Product Kit Skill bundle through npx without cloning the repository.",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"publish": "node tools/build_package publish"
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# GURU AI Snapshot
|
|
2
2
|
|
|
3
|
-
Last refreshed: 2025-11-
|
|
3
|
+
Last refreshed: 2025-11-27T12:40:55.796Z
|
|
4
4
|
|
|
5
5
|
| File | Last Modified (UTC) |
|
|
6
6
|
| --- | --- |
|
|
7
7
|
| `scripts/check_agents.sh` | 2025-11-13T09:03:47.000Z |
|
|
8
8
|
| `skill.ini` | 2025-11-13T09:47:02.000Z |
|
|
9
9
|
| `SKILL.md` | 2025-11-19T03:59:35.000Z |
|
|
10
|
-
| `template/AGENTS_TEMPLATE.md` | 2025-11-
|
|
10
|
+
| `template/AGENTS_TEMPLATE.md` | 2025-11-27T12:40:55.714Z |
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# GURU AI Snapshot
|
|
2
2
|
|
|
3
|
-
Last refreshed: 2025-11-
|
|
3
|
+
Last refreshed: 2025-11-27T12:40:55.796Z
|
|
4
4
|
|
|
5
5
|
| File | Last Modified (UTC) |
|
|
6
6
|
| --- | --- |
|
|
7
|
-
| `SKILL.md` | 2025-11-
|
|
8
|
-
| `template/Review_Report_Template.md` | 2025-11-
|
|
7
|
+
| `SKILL.md` | 2025-11-27T12:40:13.000Z |
|
|
8
|
+
| `template/Review_Report_Template.md` | 2025-11-27T12:40:17.000Z |
|
|
@@ -35,7 +35,10 @@ description: Skill for reviewing product requirement docs for template conforman
|
|
|
35
35
|
- 交叉核对需求摘要、业务流程、交互说明、验收标准是否互相矛盾或前后不一致。
|
|
36
36
|
- 标记模糊描述、冲突规则、缺失的前置条件或异常处理。
|
|
37
37
|
- 服务端设计仅检查是否存在明显歧义或冲突,不做完备性验证(此部分仅为建议)。
|
|
38
|
-
-
|
|
38
|
+
- 设计图核对:
|
|
39
|
+
- 汇总所有设计资源(含嵌入在需求文档中的图片、附件链接等),确认可访问性;若缺失或无法访问,先暂停并记录信息缺口。
|
|
40
|
+
- 必须逐图查看:对嵌入式图片,滚动到文档中的每个图片位置并检查文案、布局、交互流程与需求描述的一致性;对外部链接则逐个打开。未逐图核对视为缺失流程,并在报告中标注扣分依据。
|
|
41
|
+
- 在报告的“设计图核对记录”表中列出已核对的图片/页面及发现的问题,使用可点击链接指向需求文档中的图片位置(文件+锚点或行号)或附件路径。
|
|
39
42
|
6. 评分与结论:
|
|
40
43
|
- 使用本 Skill 评分规则(下节)给出总分(满分 100,及格线 80)。
|
|
41
44
|
- 记录主要扣分原因,保持可追溯。
|
|
@@ -45,16 +48,19 @@ description: Skill for reviewing product requirement docs for template conforman
|
|
|
45
48
|
- 报告文件命名:`YYYYMMDD_vX.X.X需求评审_N.md`(N 为当日第 N 次评审,例:`20240915_v1.2.0需求评审_1.md`)。
|
|
46
49
|
- 在表格中标注问题对应的文档段落/位置,使用可点击链接指向文件或具体段落,给出整改建议和严重度。
|
|
47
50
|
- 报告存放路径:置于对应评审版本需求文档文件夹下的 `review/` 子目录;报告中所有文档链接使用相对路径。
|
|
51
|
+
- 设计图核对的链接、浏览状态和差异需集中记录在“设计图核对记录”表中,确保每个设计资源都被浏览。
|
|
48
52
|
8. 忽略项记录:若明确某些问题被确认可忽略,在 `review/ignore.md` 创建或追加表格记录:问题内容、对应文档(相对链接)、忽略原因(无明确原因可留空)。
|
|
53
|
+
- 忽略的问题必须写到具体点(具体段落/截图/规则及其上下文),避免笼统描述(如“登录相关问题”),确保后续评审可明确识别被忽略的具体问题。
|
|
49
54
|
|
|
50
55
|
## 评分规则(满分 100,≥80 通过)
|
|
51
56
|
|
|
52
57
|
| 维度 | 权重 | 扣分示例 |
|
|
53
58
|
| --- | --- | --- |
|
|
54
|
-
| 模板符合性 |
|
|
55
|
-
| UI 文案语言(英文) |
|
|
56
|
-
| 内容一致性/冲突 |
|
|
57
|
-
|
|
|
59
|
+
| 模板符合性 | 25 | 缺失必需章节(10+),标题/编号错乱(5-10),格式未按模板(3-5) |
|
|
60
|
+
| UI 文案语言(英文) | 15 | 非英文文案(8-10),中英混排/大小写不当(5-8),术语不统一(3-5) |
|
|
61
|
+
| 内容一致性/冲突 | 25 | 明显矛盾(10+),流程与验收标准不一致(5-10),缺少前置/异常处理(5-8) |
|
|
62
|
+
| 设计图一致性 | 20 | 未逐图核对或无浏览记录(10-15),设计图文案与需求描述不一致(5-10),设计流程与文字说明冲突(5-10) |
|
|
63
|
+
| 清晰度与可执行性 | 15 | 需求描述模糊(5-8),验收标准不可验证(5-8),关键指标缺失(5) |
|
|
58
64
|
|
|
59
65
|
- 总分 = 各维度得分之和;若维度缺失无法评估,标注原因并预留扣分。
|
|
60
66
|
- 严重度分级:Blocker(阻断上线)、Major(影响交付/理解)、Minor(可接受但需修正)、Info(可选改进)。
|
|
@@ -69,6 +75,7 @@ description: Skill for reviewing product requirement docs for template conforman
|
|
|
69
75
|
|
|
70
76
|
- 仅输出评审报告,不直接修改被评审需求文档。
|
|
71
77
|
- 报告需包含:总体评分与结论、评分拆解、问题清单(表格含位置、问题、严重度、整改建议)、引用的模板/标准。
|
|
78
|
+
- 设计图核对记录:报告中必须填充“设计图核对记录”表,标注设计资源链接、浏览状态、发现的差异,未填写视为缺失覆盖。
|
|
72
79
|
- 报告保存:与被评审版本的需求文档同级目录下的 `review/` 子目录;所有引用链接均使用相对路径。
|
|
73
80
|
- 忽略问题记录:评审前先查阅 `review/ignore.md` 并忽略其中已记录问题;若双方确认某些问题可忽略,在该文件以表格追加记录“问题内容 / 对应文档(相对链接) / 忽略原因”。
|
|
74
81
|
- 若信息不足导致无法评审,明确列出缺口并暂缓评分。
|
|
@@ -16,14 +16,22 @@
|
|
|
16
16
|
| 1 | | | | |
|
|
17
17
|
| 2 | | | | |
|
|
18
18
|
|
|
19
|
+
<!-- 列出本次评审涉及的设计资源(如 Figma 页面/附件),确认每个链接已打开核对;浏览状态示例:已核对/无法访问/缺失 -->
|
|
20
|
+
## 设计图核对记录
|
|
21
|
+
| 设计资源/页面 | 文档位置(链接/锚点)或附件路径 | 浏览状态 | 发现的差异/备注 |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| | | | |
|
|
24
|
+
| | | | |
|
|
25
|
+
|
|
19
26
|
<!-- 按评分规则填写各维度得分与主要扣分原因 -->
|
|
20
27
|
## 评分拆解
|
|
21
28
|
| 维度 | 权重 | 得分 | 主要扣分原因 | 整改建议 |
|
|
22
29
|
| --- | --- | --- | --- | --- |
|
|
23
|
-
| 模板符合性 |
|
|
24
|
-
| UI 文案语言(英文) |
|
|
25
|
-
| 内容一致性/冲突 |
|
|
26
|
-
|
|
|
30
|
+
| 模板符合性 | 25 | | | |
|
|
31
|
+
| UI 文案语言(英文) | 15 | | | |
|
|
32
|
+
| 内容一致性/冲突 | 25 | | | |
|
|
33
|
+
| 设计图一致性 | 20 | | | |
|
|
34
|
+
| 清晰度与可执行性 | 15 | | | |
|
|
27
35
|
| **合计** | 100 | | | |
|
|
28
36
|
|
|
29
37
|
<!-- 使用 Blocker / Major / Minor / Info 标注严重度;文档位置请使用可点击链接(文件+锚点或行号)。示例:文档位置(链接)= [登录需求-错误提示](../requirements/v1.2.0/login.md#L45) -->
|
|
@@ -33,8 +41,10 @@
|
|
|
33
41
|
| 1 | 模板符合性 | | | | |
|
|
34
42
|
| 2 | UI 文案语言(英文) | | | | |
|
|
35
43
|
| 3 | 内容一致性/冲突 | | | | |
|
|
36
|
-
| 4 |
|
|
44
|
+
| 4 | 设计图一致性 | | | | |
|
|
45
|
+
| 5 | 其他(如需) | | | | |
|
|
37
46
|
|
|
38
47
|
## 额外说明
|
|
39
48
|
- 信息缺口/待补充:
|
|
40
49
|
- 参考的模板与规范:
|
|
50
|
+
- 忽略项记录:如有确认忽略的问题,需在 `review/ignore.md` 记录具体问题内容、对应文档位置(可点击链接)及忽略原因,避免笼统描述。
|