@guru-ai-product/ai-product-kit 0.2.251124152747 → 0.2.251126162951
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/mcp/skills/aipk_init_project/template/AGENTS_TEMPLATE.md +7 -0
- package/mcp/src/server.js +2 -0
- 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 +8 -0
- package/skills/aipk_requirements-review/SKILL.md +64 -0
- package/skills/aipk_requirements-review/template/Review_Report_Template.md +42 -0
- 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
|
@@ -62,6 +62,13 @@ Always print a highlighted line such as **I'm using skill "XXXX"** (replace XXXX
|
|
|
62
62
|
<arguments>{"skill_name": "aipk_requirements-intake"}</arguments>
|
|
63
63
|
</skill>
|
|
64
64
|
|
|
65
|
+
<skill>
|
|
66
|
+
<name>aipk_requirements-review</name>
|
|
67
|
+
<description>Skill for reviewing product requirement docs for template conformance, English-only UI copy, internal consistency, and producing a scored review report without editing the source document.</description>
|
|
68
|
+
<tool>product_kit_skill</tool>
|
|
69
|
+
<arguments>{"skill_name": "aipk_requirements-review"}</arguments>
|
|
70
|
+
</skill>
|
|
71
|
+
|
|
65
72
|
<skill>
|
|
66
73
|
<name>aipk_update-requirements-from-design</name>
|
|
67
74
|
<description>Sync requirement docs with design mockups (composite or standalone UI frames) via split/mapping scripts, capturing visual alignment and change records; use this when design assets drive the update and avoid pure text-only work.</description>
|
package/mcp/src/server.js
CHANGED
|
@@ -26,6 +26,7 @@ const PRODUCT_KIT_SKILLS = {
|
|
|
26
26
|
"aipk_requirements-changes": join(PROJECT_ROOT, "skills/aipk_requirements-changes/SKILL.md"),
|
|
27
27
|
"aipk_requirements-documentation": join(PROJECT_ROOT, "skills/aipk_requirements-documentation/SKILL.md"),
|
|
28
28
|
"aipk_requirements-intake": join(PROJECT_ROOT, "skills/aipk_requirements-intake/SKILL.md"),
|
|
29
|
+
"aipk_requirements-review": join(PROJECT_ROOT, "skills/aipk_requirements-review/SKILL.md"),
|
|
29
30
|
"aipk_skill_generate": join(PROJECT_ROOT, "skills/aipk_skill_generate/SKILL.md"),
|
|
30
31
|
"aipk_tool_prompts": join(PROJECT_ROOT, "skills/aipk_tool_prompts/SKILL.md"),
|
|
31
32
|
"aipk_update-requirements-from-design": join(PROJECT_ROOT, "skills/aipk_update-requirements-from-design/SKILL.md"),
|
|
@@ -40,6 +41,7 @@ const SKILL_DESCRIPTIONS = {
|
|
|
40
41
|
"aipk_requirements-changes": "Templates, prompts, and procedures for documenting requirement changes, including structured overviews and diff analysis; use for any change to requirement docs and avoid new requirement drafting or unrelated engineering work.",
|
|
41
42
|
"aipk_requirements-documentation": "Guide for drafting new requirement docs or iterating existing ones textually; apply when starting from scratch or doing template-compliant text updates without design assets, and avoid design-driven updates or implementation/test tasks.",
|
|
42
43
|
"aipk_requirements-intake": "Structured intake pipeline combining Gemini DeepResearch with multi-platform data to discover product needs; use during early-stage opportunity validation and avoid it once requirements are defined or when design/dev tasks begin.",
|
|
44
|
+
"aipk_requirements-review": "Skill for reviewing product requirement docs for template conformance, English-only UI copy, internal consistency, and producing a scored review report without editing the source document.",
|
|
43
45
|
"aipk_skill_generate": "Playbook for creating or refreshing Skills so metadata, templates, and scripts meet Claude’s expectations; use when scaffolding Skills or syncing bundles, not for unrelated product content.",
|
|
44
46
|
"aipk_tool_prompts": "Catalog of curated tool prompts with strengths, scenarios, and I/O rules for reuse; refer to it when consuming or extending prompts, not when writing unrelated product docs or new Skills.",
|
|
45
47
|
"aipk_update-requirements-from-design": "Sync requirement docs with design mockups (composite or standalone UI frames) via split/mapping scripts, capturing visual alignment and change records; use this when design assets drive the update and avoid pure text-only work.",
|
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.251126162951",
|
|
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-26T08:29:52.028Z
|
|
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-26T08:29:51.898Z |
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aipk_requirements-review
|
|
3
|
+
description: Skill for reviewing product requirement docs for template conformance, English-only UI copy, internal consistency, and producing a scored review report without editing the source document.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 产品需求评审指南
|
|
7
|
+
|
|
8
|
+
## 技能范围
|
|
9
|
+
|
|
10
|
+
- 作用：评审产品需求文档的模板符合性、UI 文案语言（仅限英文）、前后内容一致性，并输出独立评审报告。
|
|
11
|
+
- 适用场景：已提供需求文档草稿或版本，需快速发现结构、语言、逻辑问题并给出整改建议；单份或多份需求文档的批次评审。
|
|
12
|
+
- 不适用场景：需求文档为空/未成型（先使用撰写类 Skill），或任务要求直接修改原文档（需额外确认或使用撰写 Skill）。
|
|
13
|
+
|
|
14
|
+
## 使用前准备
|
|
15
|
+
|
|
16
|
+
1. 确认待评审文档的来源、版本、目标发布范围（如 `v1.0.0`/`v0.0.0` 需求池）。
|
|
17
|
+
2. 获取目标模板链接或路径（优先使用 `skills/aipk_requirements-documentation/template/` 下的官方模板；若另有项目模板，需用户明确提供）。
|
|
18
|
+
3. 说明评审产物仅为报告，不直接改动原需求文档。批次评审时仅输出一份整体报告。
|
|
19
|
+
4. 若缺少模板或文档路径，先暂停并向用户索取。
|
|
20
|
+
|
|
21
|
+
## 评审流程
|
|
22
|
+
|
|
23
|
+
1. 对齐评审范围：明确文档版本、涉及模块和交付期，确认需对照的模板名称。
|
|
24
|
+
2. 模板符合性检查：
|
|
25
|
+
- 核对章节齐全性、顺序、层级、编号、表格/列表格式是否与模板一致。
|
|
26
|
+
- 标记缺失章节、格式偏差或模板约定未落实的内容。
|
|
27
|
+
3. UI 文案语言检查：
|
|
28
|
+
- 检查界面文案、按钮、提示、消息等是否全部为英文，避免中英混排或非英文内容。
|
|
29
|
+
- 标记疑似翻译遗漏、拼写/大小写不当、术语不一致。
|
|
30
|
+
4. 内容一致性与冲突检查：
|
|
31
|
+
- 交叉核对需求摘要、业务流程、交互说明、验收标准是否互相矛盾或前后不一致。
|
|
32
|
+
- 标记模糊描述、冲突规则、缺失的前置条件或异常处理。
|
|
33
|
+
5. 评分与结论：
|
|
34
|
+
- 使用本 Skill 评分规则（下节）给出总分（满分 100，及格线 80）。
|
|
35
|
+
- 记录主要扣分原因，保持可追溯。
|
|
36
|
+
6. 输出评审报告：
|
|
37
|
+
- 使用模板 `./template/Review_Report_Template.md` 填写，不修改原需求文档。
|
|
38
|
+
- 若评审多份需求，合并为单份批次报告，并在“覆盖文档”中列出所有文件及版本。
|
|
39
|
+
- 报告文件命名：`YYYYMMDD_vX.X.X需求评审_N.md`（N 为当日第 N 次评审，例：`20240915_v1.2.0需求评审_1.md`）。
|
|
40
|
+
- 在表格中标注问题对应的文档段落/位置，给出整改建议和严重度。
|
|
41
|
+
|
|
42
|
+
## 评分规则（满分 100，≥80 通过）
|
|
43
|
+
|
|
44
|
+
| 维度 | 权重 | 扣分示例 |
|
|
45
|
+
| --- | --- | --- |
|
|
46
|
+
| 模板符合性 | 30 | 缺失必需章节（10+），标题/编号错乱（5-10），格式未按模板（3-5） |
|
|
47
|
+
| UI 文案语言（英文） | 20 | 非英文文案（10+），中英混排/大小写不当（5-8），术语不统一（3-5） |
|
|
48
|
+
| 内容一致性/冲突 | 30 | 明显矛盾（10+），流程与验收标准不一致（5-10），缺少前置/异常处理（5-8） |
|
|
49
|
+
| 清晰度与可执行性 | 20 | 需求描述模糊（5-8），验收标准不可验证（5-8），关键指标缺失（5） |
|
|
50
|
+
|
|
51
|
+
- 总分 = 各维度得分之和；若维度缺失无法评估，标注原因并预留扣分。
|
|
52
|
+
- 严重度分级：Blocker（阻断上线）、Major（影响交付/理解）、Minor（可接受但需修正）、Info（可选改进）。
|
|
53
|
+
|
|
54
|
+
## 模板与参考
|
|
55
|
+
|
|
56
|
+
- 评审报告模板：`./template/Review_Report_Template.md`
|
|
57
|
+
- 需求模板参考（用于比对结构）：`../aipk_requirements-documentation/template/index.md` 及子模板
|
|
58
|
+
- 文档撰写规范：`docs/guide_writing_standard/SKILL.md`
|
|
59
|
+
|
|
60
|
+
## 交付要求
|
|
61
|
+
|
|
62
|
+
- 仅输出评审报告，不直接修改被评审需求文档。
|
|
63
|
+
- 报告需包含：总体评分与结论、评分拆解、问题清单（表格含位置、问题、严重度、整改建议）、引用的模板/标准。
|
|
64
|
+
- 若信息不足导致无法评审，明确列出缺口并暂缓评分。
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# 产品需求评审报告
|
|
2
|
+
# 文件名：YYYYMMDD_vX.X.X需求评审_N.md（示例：20240915_v1.2.0需求评审_1.md）
|
|
3
|
+
|
|
4
|
+
<!-- 填写被评审文档名称、版本、模板来源、评审人和日期；发布前请移除本行注释 -->
|
|
5
|
+
## 基本信息
|
|
6
|
+
- 文档名称/链接：
|
|
7
|
+
- 版本与日期：
|
|
8
|
+
- 使用模板：
|
|
9
|
+
- 评审人：
|
|
10
|
+
- 评审日期：
|
|
11
|
+
- 总分（/100，≥80 通过）：
|
|
12
|
+
- 结论（通过/不通过）：
|
|
13
|
+
|
|
14
|
+
<!-- 批次评审时列出全部需求文档；单文档可保留一行 -->
|
|
15
|
+
## 覆盖文档
|
|
16
|
+
| 序号 | 文档名称/链接 | 版本 | 模块/范围 | 备注 |
|
|
17
|
+
| --- | --- | --- | --- | --- |
|
|
18
|
+
| 1 | | | | |
|
|
19
|
+
| 2 | | | | |
|
|
20
|
+
|
|
21
|
+
<!-- 按评分规则填写各维度得分与主要扣分原因 -->
|
|
22
|
+
## 评分拆解
|
|
23
|
+
| 维度 | 权重 | 得分 | 主要扣分原因 | 整改建议 |
|
|
24
|
+
| --- | --- | --- | --- | --- |
|
|
25
|
+
| 模板符合性 | 30 | | | |
|
|
26
|
+
| UI 文案语言（英文） | 20 | | | |
|
|
27
|
+
| 内容一致性/冲突 | 30 | | | |
|
|
28
|
+
| 清晰度与可执行性 | 20 | | | |
|
|
29
|
+
| **合计** | 100 | | | |
|
|
30
|
+
|
|
31
|
+
<!-- 使用 Blocker / Major / Minor / Info 标注严重度；文档位置可使用章节、段落或行号 -->
|
|
32
|
+
## 问题清单
|
|
33
|
+
| 检查项 | 文档位置 | 问题/风险 | 严重度 | 整改建议 |
|
|
34
|
+
| --- | --- | --- | --- | --- |
|
|
35
|
+
| 模板符合性 | | | | |
|
|
36
|
+
| UI 文案语言 | | | | |
|
|
37
|
+
| 内容一致性/冲突 | | | | |
|
|
38
|
+
| 其他（如需） | | | | |
|
|
39
|
+
|
|
40
|
+
## 额外说明
|
|
41
|
+
- 信息缺口/待补充：
|
|
42
|
+
- 参考的模板与规范：
|