@guru-ai-product/ai-product-kit 0.2.251112183752 → 0.2.251113155253

package/mcp/.doc_cache/d165d35fea568d64_/351/234/200/346/261/202/345/217/230/345/212/250/350/257/264/346/230/216/346/226/207/346/241/243/346/250/241/346/235/277.md

@@ -0,0 +1,576 @@
+# [版本号] 需求文档变动说明
+
+> **变动周期**: YYYY年MM月DD日 → YYYY年MM月DD日（X天）  
+> **对比版本**: `<旧commit>` → `<新commit>`
+
+## 1. 变动概述
+
+**对比版本**:
+
+- **基准版本**: `<commit-hash>` (YYYY年MM月DD日) - <提交信息>
+- **最新版本**: `<commit-hash>` (HEAD, YYYY年MM月DD日) - <提交信息>
+
+**变动周期**: YYYY年MM月DD日 → YYYY年MM月DD日（约X天）
+
+**总体变动**:
+
+- X个文件变更
+- 新增XXXX行
+- 删除XXX行
+- 净增加XXXX行
+- 新增X个需求文档（vX.X.X: X个，vX.X.X: X个）
+- 重大修改X个核心文档
+
+---
+
+## 2. Commit 历史
+
+### 2.1 Commit #1: <commit-hash> (YYYY-MM-DD)
+
+**提交信息**: <提交信息>
+
+**变更内容**:
+
+- 新增/修改 `文件路径` (XXX行)
+- 新增/修改 `文件路径` (XXX行)
+
+### 2.2 Commit #2: <commit-hash> (YYYY-MM-DD)
+
+**提交信息**: <提交信息>
+
+**变更内容**:
+
+- 优化/新增/删除 描述 (±XXX行)
+- 优化/新增/删除 描述 (±XXX行)
+
+---
+
+## 3. 文档级变动详情
+
+### 3.1 vX.X.X 版本
+
+#### 3.1.1 修改文档：`文件名.md` ⭐⭐⭐
+
+📄 查看文件 (./文件名.md)
+
+**变动量**: +XXX行 / -XX行（净增XXX行）
+
+**新增内容**:
+
+- 📍 新增"章节名称" → `章节名称:行号` (./文件名.md#L行号)
+  - 具体内容说明
+  - 具体内容说明
+- 📍 补充功能详细说明 → `章节名称:行号` (./文件名.md#L行号)
+  - 具体内容说明
+  - 具体内容说明
+- 新增其他内容（未链接）
+
+**修改内容**:
+
+- 📍 优化描述结构 → `章节名称:行号` (./文件名.md#L行号)
+- 📍 完善说明 → `章节名称:行号` (./文件名.md#L行号)
+- 调整其他内容
+- 更新内容
+- 优化表述
+
+**删除内容**:
+
+- 删除重复或过时的描述（XX行）
+- 精简冗余的说明文字
+
+#### 3.1.2 新增文档：`文件名.md` ⭐⭐⭐
+
+📄 查看文件 (./文件名.md)
+
+**文档规模**: XXX行
+
+**包含内容**:
+
+- 📍 需求背景和业务目标 → `1. 需求背景:X` (./文件名.md#LX)
+- 📍 功能设计 → `2. 功能设计:XX` (./文件名.md#LXX)
+  - 📍 子功能1 → `2.1 子功能1:XXX` (./文件名.md#LXXX)
+  - 📍 子功能2 → `2.2 子功能2:XXX` (./文件名.md#LXXX)
+- 📍 界面设计 → `3. 界面设计:XXX` (./文件名.md#LXXX)
+  - 📍 页面设计 → `3.1 页面设计:XXX` (./文件名.md#LXXX)
+- 📍 客户端需求 → `4. 客户端需求:XXX` (./文件名.md#LXXX)
+- 📍 服务端需求 → `5. 服务端需求:XXX` (./文件名.md#LXXX)
+
+#### 3.1.3 新增文件：draft文件和图片
+
+**draft/文件名.md** (XX行)
+
+- 内容说明
+
+**images/图片名.png**
+
+- 用途说明
+
+### 3.2 vX.X.X 版本（全新版本目录）
+
+**说明**: vX.X.X目录在<旧commit>版本中不存在，是本次变动新增的版本目录
+
+#### 3.2.1 新增文档：`文件名.md` ⭐⭐⭐
+
+📄 查看文件 (../vX.X.X/文件名.md)
+
+**文档规模**: XXX行（优化后）
+
+**包含内容**:
+
+- 📍 需求背景 → `1. 需求背景:X` (../vX.X.X/文件名.md#LX)
+  - 用户痛点
+  - 业务目标
+  - 竞品分析
+- 📍 功能设计 → `2. 功能设计:XX` (../vX.X.X/文件名.md#LXX)
+  - 📍 核心功能 → `2.1 核心功能:XXX` (../vX.X.X/文件名.md#LXXX)
+    - 子功能1
+    - 子功能2
+  - 功能2
+  - 功能3
+- 📍 界面设计 → `3. 界面设计:XXX` (../vX.X.X/文件名.md#LXXX)
+  - 📍 页面布局 → `3.1 页面布局:XXX` (../vX.X.X/文件名.md#LXXX)
+  - 📍 交互设计 → `3.2 交互设计:XXX` (../vX.X.X/文件名.md#LXXX)
+- 📍 交互流程 → `4. 交互流程:XXX` (../vX.X.X/文件名.md#LXXX)
+- 📍 技术实现 → `5. 技术实现:XXX` (../vX.X.X/文件名.md#LXXX)
+
+**优化历史**:
+
+- 初始版本(<commit>): XXX行
+- 优化后(<commit>): XXX行（-XX行）
+- 优化内容: 精简描述、优化结构、删除冗余
+
+---
+
+## 4. 功能维度变动分析
+
+### 4.1 核心新功能
+
+#### 4.1.1 功能名称 ⭐⭐⭐
+
+📄 查看完整文档 (../vX.X.X/文件名.md)
+
+**功能定位**: 功能类型（创作能力增强/用户留存和激活/商业化增长）
+
+**新增内容**:
+
+- 📍 **功能模块1** → `章节:行号` (../vX.X.X/文件名.md#L行号)
+  - 具体功能点1（参数、配置）
+  - 具体功能点2
+  - 具体功能点3
+- 📍 **功能模块2** → `章节:行号` (../vX.X.X/文件名.md#L行号)
+  - 具体功能点
+  - 具体功能点
+- 📍 **功能模块3** → `章节:行号` (../vX.X.X/文件名.md#L行号)
+  - 具体功能点
+  - 具体功能点
+- 📍 **功能模块4** → `章节:行号` (../vX.X.X/文件名.md#L行号)
+  - 具体功能点
+
+**技术要求**:
+
+- 📍 技术点1 → `章节:行号` (../vX.X.X/文件名.md#L行号)
+- 📍 技术点2 → `章节:行号` (../vX.X.X/文件名.md#L行号)
+- 📍 技术点3 → `章节:行号` (../vX.X.X/文件名.md#L行号)
+- 技术点4
+
+**开发复杂度**: 高/中/低（预计XX-XX人日）
+
+### 4.2 核心功能优化
+
+#### 4.2.1 功能名称 ⭐⭐⭐
+
+📄 查看完整文档 (./文件名.md)
+
+**优化内容**:
+
+**新增部分**（+XXX行）:
+
+- 📍 **新增模块1** → `章节:行号` (./文件名.md#L行号)
+  - 具体内容
+  - 具体内容
+- **新增模块2**
+  - 📍 子模块1 → `章节:行号` (./文件名.md#L行号)
+  - 📍 子模块2 → `章节:行号` (./文件名.md#L行号)
+  - 📍 子模块3 → `章节:行号` (./文件名.md#L行号)
+- 📍 **新增模块3** → `章节:行号` (./文件名.md#L行号)
+  - 具体内容
+- 📍 **新增模块4** → `章节:行号` (./文件名.md#L行号)
+  - 具体内容
+- 📍 **新增模块5** → `章节:行号` (./文件名.md#L行号)
+  - 具体内容
+
+**删除部分**（-XX行）:
+
+- 删除内容说明
+- 删除内容说明
+
+**优化效果**:
+
+- 文档更加完整和详细（净增XXX行）
+- 功能描述更加清晰
+- 技术方案更加具体
+
+**开发影响**: 预计XX-XX人日
+
+---
+
+## 5. 产品策略分析
+
+### 5.1 功能战略定位
+
+**创作能力增强**:
+
+- 功能1: 价值说明
+- 功能2: 价值说明
+
+**用户增长留存**:
+
+- 功能1: 价值说明
+- 功能2: 价值说明
+
+**商业化提升**:
+
+- 功能1: 价值说明
+- 功能2: 价值说明
+
+### 5.2 版本演进路径
+
+**vX.X.X 定位**: 定位说明
+
+- 重点1
+- 重点2
+- 重点3
+
+**vX.X.X 定位**: 定位说明
+
+- 重点1
+- 重点2
+- 重点3
+
+---
+
+## 6. 附录
+
+### 6.1 完整变更文件清单
+
+**vX.X.X 修改文件** (X个):
+
+1. `文件名.md` (+XXX/-XX行)
+2. `文件名.md` (+XX行)
+
+**vX.X.X 新增文件** (X个):
+
+3. `文件名.md` (XXX行)
+4. `draft/文件名.md` (XX行)
+5. `images/图片名.png` (图片)
+
+**vX.X.X 新增文件（全新目录）** (X个):
+
+6. `文件名.md` (XXX行)
+7. `文件名.md` (XXX行)
+8. `draft/文件名.md` (XX行)
+9. `images/图片名.png` (图片)
+
+### 6.2 变动统计汇总
+
+| 类型 | 数量 | 行数 |
+|------|------|------|
+| 修改文档 | X个 | +XXX/-XX |
+| 新增文档 | X个 | XXX行 |
+| 新增draft | X个 | XX行 |
+| 新增图片 | X个 | - |
+| **合计** | **XX个** | **+XXXX/-XXX** |
+
+### 6.3 Commit 详情
+
+**Commit 1: <commit-hash>**
+
+- 日期: YYYY-MM-DD HH:MM:SS
+- 作者: 作者名
+- 提交信息: 提交信息
+- 文件变更: X个文件，XXX行新增
+
+**Commit 2: <commit-hash>**
+
+- 日期: YYYY-MM-DD HH:MM:SS
+- 作者: 作者名
+- 提交信息: 提交信息
+- 文件变更: X个文件，XXX行新增，XX行删除
+
+### 6.4 查看完整差异命令
+
+```bash
+# 查看所有文件变更统计
+git diff --stat <旧commit>..<新commit>
+
+# 查看所有文件详细变更
+git diff <旧commit>..<新commit>
+
+# 查看特定文件变更
+git diff <旧commit>..<新commit> -- "../../vX.X.X/文件名.md"
+
+# 查看两个版本的文件内容
+git show <旧commit>:../../vX.X.X/文件名.md
+git show <新commit>:../../vX.X.X/文件名.md
+
+# 查看提交历史
+git log --oneline <旧commit>..<新commit>
+```
+
+### 6.5 文档结构概览
+
+```
+../../requirements
+├── vX.X.X/
+│   ├── 文件名.md [修改: +XXX/-XX]
+│   ├── 文件名.md [修改: +XX]
+│   ├── 文件名.md [新增: XXX行]
+│   ├── draft/
+│   │   ├── 文件名.md [新增: XX行]
+│   │   └── 文件名.md [新增: XX行]
+│   └── images/
+│       └── 图片名.png [新增]
+└── vX.X.X/ [新增目录]
+    ├── 文件名.md [新增: XXX行]
+    ├── 文件名.md [新增: XXX行]
+    ├── draft/
+    │   ├── 文件名.md [新增: XX行]
+    │   └── 文件名.md [新增: XX行]
+    └── images/
+        └── 图片名.png [新增]
+```
+
+---
+
+<!-- ============================================
+⚠️ 模板规范说明区域 - 请勿输出到最终文档 ⚠️
+============================================
+以下内容为模板使用规范和说明，仅用于指导如何填写模板，
+在使用模板生成最终文档时，应完全删除或忽略此部分内容。
+============================================ -->
+
+## 模板使用说明
+
+### 文档格式规范与检查清单
+
+#### 列表格式规范
+
+**功能需求描述：使用破折号 `-` + 加粗标题**
+
+```markdown
+- **功能名称**：功能描述
+- **业务规则**：
+  * 具体规则1
+  * 具体规则2
+```
+
+**技术需求内容：使用星号 `*`**
+
+```markdown
+* 技术要点1
+* 技术要点2
+* 技术要点3
+```
+
+**操作步骤：使用数字列表 `1. 2. 3.`**
+
+```markdown
+1. 第一步操作
+2. 第二步操作
+3. 第三步操作
+```
+
+#### 加粗格式规范
+
+**标题性内容：冒号前加粗**
+
+```markdown
+- **功能名称**：功能描述
+- **业务规则**：具体规则
+```
+
+**普通描述：冒号前不加粗**
+
+```markdown
+- 分析按钮：用户输入食物描述后点击分析
+- 确认按钮：用户确认当前结果并返回
+```
+
+**重要强调：整段加粗**
+
+```markdown
+**重要说明**：这是需要特别注意的内容
+**CRITICAL**：这是关键信息
+```
+
+#### 代码格式规范
+
+**行内代码：使用单个反引号**
+
+```markdown
+使用 `API接口` 进行数据交互
+```
+
+**代码块：使用三个反引号**
+
+```markdown
+```json
+{
+  "key": "value"
+}
+```
+
+```
+
+**占位符：使用中括号**
+```markdown
+[功能名称]、[参数描述]、[返回值]
+```
+
+#### 格式检查清单
+
+**列表格式检查**
+
+- [ ] 功能需求描述使用破折号 `-` + 加粗标题
+- [ ] 技术需求内容使用星号 `*`
+- [ ] 操作步骤使用数字列表 `1. 2. 3.`
+
+**加粗格式检查**
+
+- [ ] 标题性内容冒号前加粗（如：**功能名称**：）
+- [ ] 普通描述冒号前不加粗（如：分析按钮：）
+- [ ] 重要强调整段加粗（如：**重要说明**：）
+
+**整体格式检查**
+
+- [ ] 标题层级正确（# ## ### ####）
+- [ ] 段落间有空行分隔
+- [ ] 中括号占位符已替换为实际内容
+- [ ] 文档结构完整，章节齐全
+
+### 中括号使用规则
+
+**重要说明**：模板中的 `[内容]` 格式表示需要替换的占位符内容。在实际使用时：
+
+1. **替换原则**：将 `[内容]` 替换为具体的实际内容
+2. **格式要求**：替换后的内容**不要保留中括号**
+3. **示例对比**：
+   - ❌ 错误：`[功能名称]` → `[用户登录功能]`
+   - ✅ 正确：`功能名称` → `用户登录功能`
+   - ❌ 错误：`[功能描述]` → `[实现用户身份验证]`
+   - ✅ 正确：`功能描述` → `实现用户身份验证`
+
+### 链接格式规范
+
+**重要说明**：变动说明文档中的链接格式规范：
+
+**文件链接**：
+
+```markdown
+📄 查看文件 (./文件名.md)
+📄 查看完整文档 (../v2.1.0/文件名.md)
+```
+
+**章节行号链接**：
+
+```markdown
+📍 功能说明 → `章节名称:行号` (./文件名.md#L行号)
+📍 详细设计 → `3.1.1 页面设计:156` (./文件名.md#L156)
+```
+
+**图标使用**：
+
+- 📄 文件链接
+- 📍 位置链接（行号）
+- ⭐⭐⭐ 重要程度标识
+- ✅ 完成状态
+- 🔵 系统操作
+- 🟢 用户操作
+- 🟡 判断节点
+
+### 文档结构说明
+
+#### 必选章节（所有变动都需要）
+
+- **1. 变动概述**：必须明确版本对比、变动周期、总体统计
+- **2. Commit 历史**：必须包含所有相关commit信息
+- **3. 文档级变动详情**：必须详细说明每个文档的变动
+- **4. 功能维度变动分析**：必须从功能角度分析变动
+- **5. 产品策略分析**：必须包含战略定位和版本演进
+- **6. 附录**：必须包含统计表、命令等
+
+#### 可选章节（根据变动特点选择）
+
+- **3.1 文档级变动详情**：
+  - **修改文档**：当有文档被修改时使用
+    - 场景举例：功能优化、内容补充、结构调整
+    - **新增内容**：列出新增的章节、功能点（附带行号链接）
+    - **修改内容**：列出修改的内容（附带行号链接）
+    - **删除内容**：说明删除的内容
+  - **新增文档**：当有文档被新增时使用
+    - 场景举例：新功能需求、新版本需求、补充文档
+    - **文档规模**：标注文档总行数
+    - **包含内容**：列出主要章节并链接到具体行号
+    - **功能类型**：说明文档的功能类型
+  - **新增文件**：当有draft文件或图片被新增时使用
+    - 场景举例：草稿文档、设计图片、参考材料
+- **4. 功能维度变动分析**：
+  - **4.1 核心新功能**：当有重要新功能时使用
+    - 场景举例：全新功能模块、重大功能升级
+    - **功能定位**：说明功能在整体产品中的定位
+    - **新增内容**：详细列出功能模块，链接到文档具体位置
+    - **技术要求**：列出技术实现要点，链接到相关章节
+    - **开发复杂度**：预估工作量
+  - **4.2 核心功能优化**：当有功能被优化时使用
+    - 场景举例：功能改进、性能优化、用户体验提升
+    - **新增部分**：列出新增内容及行号链接
+    - **修改部分**：列出修改内容及行号链接
+    - **删除部分**：说明删除内容
+    - **开发影响**：预估工作量
+- **5. 产品策略分析**：
+  - **5.1 功能战略定位**：当需要分析功能战略价值时使用
+    - 场景举例：多功能协同、产品定位调整、商业化考虑
+  - **5.2 版本演进路径**：当涉及多版本管理时使用
+    - 场景举例：版本规划、功能迭代、产品路线图
+
+#### 省略规则举例
+
+- **纯文档优化场景**：
+  - 修改文档格式、调整章节结构、优化表述
+  - 可以省略：4.1核心新功能、5.1功能战略定位
+- **纯新增文档场景**：
+  - 新增需求文档、补充说明文档、添加参考材料
+  - 可以省略：4.2核心功能优化、5.2版本演进路径
+- **简单变动场景**：
+  - 小幅修改、格式调整、文案优化
+  - 可以省略：4.1核心新功能、4.2核心功能优化、5.1功能战略定位
+- **无功能变动场景**：
+  - 纯文档管理、格式统一、结构调整
+  - 可以省略：4.功能维度变动分析、5.产品策略分析
+
+### 忽略章节处理规范
+
+**重要说明**：当某个章节不适用于当前变动时，直接省略该章节，不要保留章节标题或添加任何标记。
+
+**处理原则**：
+
+- 不适用于当前变动的章节直接省略
+- 不需要保留章节标题结构
+- 保持文档简洁，只包含实际需要的内容
+
+### 关键要素
+
+- **变动导向**：围绕文档变动和功能影响
+- **链接清晰**：重要变动用链接展示具体位置
+- **统计准确**：提供准确的变动统计数据
+- **分析深入**：从功能维度和产品策略角度分析变动
+
+### 文档命名规范
+
+格式：`YYYYMMDD_需求文档变动说明_旧commit至新commit.md`
+
+示例：
+
+- `20251017_需求文档变动说明_90cad63至fa5a716.md`
+- `20251018_需求文档变动说明_v2.0.0至v2.1.0.md`
+- `20251019_需求文档变动说明_HEAD至main.md`