@guru-ai-product/ai-product-kit 0.2.251208164834 → 0.2.251215204804
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 +5 -4
- package/skills/aipk_requirements-documentation/template/4.3_/344/272/244/344/272/222/344/270/216/345/223/215/345/272/224/345/274/217/350/256/276/350/256/241.md +2 -2
- package/skills/aipk_requirements-documentation/template/5_/346/225/260/346/215/256/344/270/216/346/234/215/345/212/241/347/253/257/351/234/200/346/261/202.md +157 -0
- package/skills/aipk_requirements-documentation/template/index.md +7 -1
- package/skills/aipk_requirements-documentation/template//351/234/200/346/261/202/350/277/255/344/273/243/346/250/241/346/235/277.md +3 -1
- package/skills/aipk_requirements-intake/GURU_AI.md +1 -1
- package/skills/aipk_requirements-review/GURU_AI.md +1 -1
- 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.251215204804",
|
|
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-12-
|
|
3
|
+
Last refreshed: 2025-12-15T12:48:04.774Z
|
|
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-12-
|
|
10
|
+
| `template/AGENTS_TEMPLATE.md` | 2025-12-15T12:48:04.683Z |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# GURU AI Snapshot
|
|
2
2
|
|
|
3
|
-
Last refreshed: 2025-12-
|
|
3
|
+
Last refreshed: 2025-12-15T12:48:04.774Z
|
|
4
4
|
|
|
5
5
|
| File | Last Modified (UTC) |
|
|
6
6
|
| --- | --- |
|
|
@@ -10,11 +10,12 @@ Last refreshed: 2025-12-08T08:48:34.843Z
|
|
|
10
10
|
| `template/3_商业化策略.md` | 2025-11-19T03:59:35.000Z |
|
|
11
11
|
| `template/4.1_用户体验流程与信息架构.md` | 2025-11-19T03:59:35.000Z |
|
|
12
12
|
| `template/4.2_关键界面.md` | 2025-12-01T05:54:03.000Z |
|
|
13
|
-
| `template/4.3_交互与响应式设计.md` | 2025-
|
|
13
|
+
| `template/4.3_交互与响应式设计.md` | 2025-12-15T10:44:24.000Z |
|
|
14
|
+
| `template/5_数据与服务端需求.md` | 2025-12-15T11:48:40.000Z |
|
|
14
15
|
| `template/AI 应用类APP通用埋点文档.xlsx` | 2025-11-19T03:59:35.000Z |
|
|
15
16
|
| `template/Draft_产品需求草稿.md` | 2025-11-19T03:59:35.000Z |
|
|
16
17
|
| `template/Draft_用户旅程草稿.md` | 2025-11-19T03:59:35.000Z |
|
|
17
|
-
| `template/index.md` | 2025-12-
|
|
18
|
+
| `template/index.md` | 2025-12-15T11:17:59.000Z |
|
|
18
19
|
| `template/埋点规范文档.md` | 2025-11-19T03:59:35.000Z |
|
|
19
|
-
| `template/需求迭代模板.md` | 2025-12-
|
|
20
|
+
| `template/需求迭代模板.md` | 2025-12-15T08:55:40.000Z |
|
|
20
21
|
| `template/需求迭代索引.md` | 2025-11-19T03:59:35.000Z |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## 文档导航
|
|
4
4
|
|
|
5
|
-
← **[上一部分：关键界面](./4.2_关键界面.md)** | 📋 **[返回索引](./index.md)**
|
|
5
|
+
← **[上一部分：关键界面](./4.2_关键界面.md)** | **[下一部分：数据与服务端需求](./5_数据与服务端需求.md)** → | 📋 **[返回索引](./index.md)**
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -84,4 +84,4 @@
|
|
|
84
84
|
|
|
85
85
|
---
|
|
86
86
|
|
|
87
|
-
← **[上一部分：关键界面](./4.2_关键界面.md)** | 📋 **[返回索引](./index.md)**
|
|
87
|
+
← **[上一部分：关键界面](./4.2_关键界面.md)** | **[下一部分：数据与服务端需求](./5_数据与服务端需求.md)** → | 📋 **[返回索引](./index.md)**
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# 产品需求文档 - 第五部分：数据与服务端需求
|
|
2
|
+
|
|
3
|
+
## 文档导航
|
|
4
|
+
|
|
5
|
+
← **[上一部分：交互与响应式设计](./4.3_交互与响应式设计.md)** | 📋 **[返回索引](./index.md)**
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 5. 数据与服务端需求
|
|
10
|
+
|
|
11
|
+
<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
|
|
12
|
+
**填写规则**：
|
|
13
|
+
|
|
14
|
+
- 本部分用于从 0 到 1 的需求文档，补齐「有哪些数据」「数据存在哪里（客户端/服务端/第三方）」「哪些场景需要服务端交互」等可落地信息，避免仅停留在功能描述层面。
|
|
15
|
+
- 若产品为纯离线、完全不涉及服务端：可将「5.3、5.6-5.9」统一标记为 `*略*`，并在「5.3 客户端与服务端交互清单」与「5.6 服务端范围与依赖」说明原因。
|
|
16
|
+
- 若不涉及数据持久化（例如纯展示、临时计算）：可将「5.2-5.5」标记为 `*略*`，并在「5.1 数据范围与口径」说明原因。
|
|
17
|
+
- 本模板强调“需求侧的可验证性”，不替代服务端技术方案；当需求与技术方案存在差异时，应在对应小节补充差异说明与链接。
|
|
18
|
+
<!-- ⚠️ 规范说明结束 ⚠️ -->
|
|
19
|
+
|
|
20
|
+
### 5.1 数据范围与口径
|
|
21
|
+
|
|
22
|
+
**关键数据对象**：
|
|
23
|
+
|
|
24
|
+
- **[对象1]**：[定义与边界，例如：用户、内容、订单、会话、任务]
|
|
25
|
+
- **[对象2]**：[定义与边界]
|
|
26
|
+
- **[对象3]**：[定义与边界]
|
|
27
|
+
|
|
28
|
+
**数据分级与合规**（如适用）：
|
|
29
|
+
|
|
30
|
+
| 数据类型 | 示例 | 是否包含个人信息 | 处理要求 |
|
|
31
|
+
|---|---|---|---|
|
|
32
|
+
| 业务数据 | [示例] | 否/是 | [脱敏/最小化/保留期/访问控制] |
|
|
33
|
+
| 设备数据 | [示例] | 否/是 | [处理要求] |
|
|
34
|
+
| 内容数据 | [示例] | 否/是 | [处理要求] |
|
|
35
|
+
|
|
36
|
+
### 5.2 数据清单与存储位置（客户端 / 服务端）
|
|
37
|
+
|
|
38
|
+
<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
|
|
39
|
+
**重要说明**：
|
|
40
|
+
|
|
41
|
+
- 本节不要求提供字段级数据字典；重点是明确“有哪些数据”和“存在哪里”，以便开发/测试明确边界与验收。
|
|
42
|
+
- “存储位置”至少要区分：客户端本地、服务端持久化、第三方平台（如有）。
|
|
43
|
+
<!-- ⚠️ 规范说明结束 ⚠️ -->
|
|
44
|
+
|
|
45
|
+
#### 5.2.1 数据清单（数据项级）
|
|
46
|
+
|
|
47
|
+
| 数据项 | 业务含义 | 数据来源 | 是否必需 | 敏感等级 | 备注 |
|
|
48
|
+
|---|---|---|---|---|---|
|
|
49
|
+
| [数据项1] | [含义与边界] | [用户输入/本地生成/服务端返回/第三方] | 是/否 | [普通/敏感/高度敏感] | [备注] |
|
|
50
|
+
| [数据项2] | [含义与边界] | [来源] | 是/否 | [等级] | [备注] |
|
|
51
|
+
| [数据项3] | [含义与边界] | [来源] | 是/否 | [等级] | [备注] |
|
|
52
|
+
|
|
53
|
+
#### 5.2.2 存储位置与生命周期（数据项级）
|
|
54
|
+
|
|
55
|
+
| 数据项 | 存储位置 | 客户端存储形式（如适用） | 服务端存储类型（如适用） | 保留期 | 删除/清理机制 |
|
|
56
|
+
|---|---|---|---|---|---|
|
|
57
|
+
| [数据项1] | 仅客户端/仅服务端/两端/第三方 | [Keychain/SQLite/文件/内存] | [DB/对象存储/搜索索引/缓存] | [保留期] | [软删/硬删/清缓存] |
|
|
58
|
+
| [数据项2] | [位置] | [形式] | [类型] | [保留期] | [机制] |
|
|
59
|
+
|
|
60
|
+
### 5.3 客户端与服务端交互清单（必填）
|
|
61
|
+
|
|
62
|
+
<!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
|
|
63
|
+
**重要说明**：本节用于回答“哪些场景需要服务端交互”。每个交互点至少写清：触发时机、目的、是否要求登录、失败时客户端体验。
|
|
64
|
+
<!-- ⚠️ 规范说明结束 ⚠️ -->
|
|
65
|
+
|
|
66
|
+
| 交互场景 | 触发时机 | 客户端发起 | 服务端处理 | 结果返回/落地 | 鉴权 | 失败处理 |
|
|
67
|
+
|---|---|---|---|---|---|---|
|
|
68
|
+
| [场景1，例如：登录] | [点击/启动/定时] | [发送什么] | [校验/生成/写入] | [token/状态/本地保存] | [匿名/JWT/签名] | [提示/重试/降级] |
|
|
69
|
+
| [场景2，例如：拉取数据] | [进入页面/下拉刷新] | [发送什么] | [查询/聚合] | [渲染/缓存] | [要求] | [处理] |
|
|
70
|
+
| [场景3，例如：提交数据] | [点击保存/自动同步] | [发送什么] | [校验/写入/幂等] | [回写/刷新] | [要求] | [处理] |
|
|
71
|
+
|
|
72
|
+
### 5.4 数据同步与一致性（如适用）
|
|
73
|
+
|
|
74
|
+
**数据流说明**：
|
|
75
|
+
|
|
76
|
+
- **写入路径**：[客户端 → 服务端 → 存储/索引/缓存]
|
|
77
|
+
- **读取路径**：[客户端 → 服务端 → 聚合/计算 → 返回]
|
|
78
|
+
- **同步策略**：[实时/准实时/批处理/离线]
|
|
79
|
+
- **一致性要求**：[强一致/最终一致/允许短暂不一致]
|
|
80
|
+
|
|
81
|
+
**关键场景数据流**（示例结构）：
|
|
82
|
+
|
|
83
|
+
- **[场景1]**：[例如：创建任务并同步到多端]
|
|
84
|
+
- **数据源**：[用户输入/本地生成/第三方回调]
|
|
85
|
+
- **触发条件**：[何时写入/更新]
|
|
86
|
+
- **传递链路**：[客户端组件 → API → 存储 → 下游]
|
|
87
|
+
- **失败重试**：[重试次数/退避策略/用户提示]
|
|
88
|
+
|
|
89
|
+
### 5.5 数据生命周期与迁移（如适用）
|
|
90
|
+
|
|
91
|
+
**保留期与删除**：
|
|
92
|
+
|
|
93
|
+
- **保留期**：[例如：日志 30 天、业务数据 2 年]
|
|
94
|
+
- **删除机制**：[软删/硬删/延迟删除]
|
|
95
|
+
- **导出与可携带性**：[是否支持导出、导出范围]
|
|
96
|
+
|
|
97
|
+
**版本与迁移**：
|
|
98
|
+
|
|
99
|
+
- **结构变更策略**：[新增字段/字段废弃/拆表合表]
|
|
100
|
+
- **迁移方式**：[在线迁移/离线迁移/双写]
|
|
101
|
+
- **回滚策略**：[如何回滚、兼容窗口]
|
|
102
|
+
|
|
103
|
+
### 5.6 服务端范围与依赖
|
|
104
|
+
|
|
105
|
+
**服务端模块边界**：
|
|
106
|
+
|
|
107
|
+
- **[模块1]**：[职责范围，包含/不包含哪些能力]
|
|
108
|
+
- **[模块2]**：[职责范围]
|
|
109
|
+
|
|
110
|
+
**外部依赖 / 第三方服务**（如适用）：
|
|
111
|
+
|
|
112
|
+
| 依赖 | 用途 | 鉴权方式 | SLA/配额 | 风险 | 备选方案 |
|
|
113
|
+
|---|---|---|---|---|---|
|
|
114
|
+
| [依赖1] | [用途] | [API Key/OAuth/签名] | [说明] | [风险点] | [备选] |
|
|
115
|
+
|
|
116
|
+
### 5.7 异步任务与消息（如适用）
|
|
117
|
+
|
|
118
|
+
| 任务/Topic | 触发条件 | 重试策略 | 幂等键 | 失败处理 | 监控指标 |
|
|
119
|
+
|---|---|---|---|---|---|
|
|
120
|
+
| [任务1] | [触发] | [次数/退避] | [key] | [补偿/告警] | [指标] |
|
|
121
|
+
|
|
122
|
+
### 5.8 安全与合规（如适用）
|
|
123
|
+
|
|
124
|
+
**数据安全**：
|
|
125
|
+
|
|
126
|
+
- **传输加密**：[HTTPS/TLS版本要求]
|
|
127
|
+
- **存储加密**：[敏感字段加密/密钥管理]
|
|
128
|
+
- **访问控制**：[RBAC/资源级权限/最小权限]
|
|
129
|
+
- **审计日志**：[记录范围/保留期/检索方式]
|
|
130
|
+
|
|
131
|
+
**隐私与合规**（如适用）：
|
|
132
|
+
|
|
133
|
+
- **数据最小化**：[收集范围与理由]
|
|
134
|
+
- **用户权利**：[删除/导出/更正请求流程]
|
|
135
|
+
- **内容合规**：[审核策略/违规处理]
|
|
136
|
+
|
|
137
|
+
### 5.9 可观测性与运维（如适用）
|
|
138
|
+
|
|
139
|
+
**可用性目标**：
|
|
140
|
+
|
|
141
|
+
- **SLO**：[例如：月可用性 99.9%]
|
|
142
|
+
- **容量预估**：[QPS/存储增长/峰值假设]
|
|
143
|
+
|
|
144
|
+
**监控与告警**：
|
|
145
|
+
|
|
146
|
+
- **关键指标**：[成功率/延迟/错误码分布/队列堆积]
|
|
147
|
+
- **告警策略**：[阈值/分级/处理人]
|
|
148
|
+
|
|
149
|
+
**发布与回滚**：
|
|
150
|
+
|
|
151
|
+
- **灰度策略**：[开关/分批/范围]
|
|
152
|
+
- **回滚条件**：[指标触发/异常类型]
|
|
153
|
+
- **兼容窗口**：[客户端版本/接口版本]
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
← **[上一部分：交互与响应式设计](./4.3_交互与响应式设计.md)** | 📋 **[返回索引](./index.md)**
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
|
-
本索引提供了产品需求文档（PRD
|
|
21
|
+
本索引提供了产品需求文档（PRD）的完整模板结构，包含快速草稿模板和五个独立的文档部分。
|
|
22
22
|
|
|
23
23
|
## 快速开始
|
|
24
24
|
|
|
@@ -75,6 +75,12 @@
|
|
|
75
75
|
- **适用场景**：交互设计、多设备适配、无障碍优化
|
|
76
76
|
- **关键输出**：交互规范、适配策略、无障碍方案
|
|
77
77
|
|
|
78
|
+
### [第五部分：数据与服务端需求](./5_数据与服务端需求.md)
|
|
79
|
+
|
|
80
|
+
- **内容概述**：数据清单与存储位置（客户端/服务端）、客户端/服务端交互清单、数据同步与一致性、安全与运维要求
|
|
81
|
+
- **适用场景**：从 0 到 1 的产品/功能，或需求中明确涉及服务端能力、跨端数据一致性、接口与存储设计
|
|
82
|
+
- **关键输出**：关键数据清单与存储位置、服务端交互场景清单、同步与一致性要求、可观测性与发布回滚要求
|
|
83
|
+
|
|
78
84
|
## 使用指南
|
|
79
85
|
|
|
80
86
|
### 文档导航规范
|
|
@@ -501,7 +501,9 @@ graph TD
|
|
|
501
501
|
| | | [参数3名称] | [参数3值说明] |
|
|
502
502
|
| | | [参数4名称] | [参数4值说明] |
|
|
503
503
|
|
|
504
|
-
## 4.
|
|
504
|
+
## 4. 服务端需求（参考）
|
|
505
|
+
|
|
506
|
+
> **重要说明（必须保留并输出）**：本节「服务端需求」仅为建议参考，**不强制执行**，也**不作为测试与评审依据**；服务端具体实现请以服务端相关设计/技术方案为准。如本节内容与服务端设计存在冲突，请以服务端设计为准，并在此处补充差异说明与对应链接。
|
|
505
507
|
|
|
506
508
|
### 4.1 接口需求
|
|
507
509
|
|