@guru-ai-product/ai-product-kit 0.1.251112172507

package/skills/aipk_requirements/changes/template//351/234/200/346/261/202/345/217/230/345/212/250/350/257/264/346/230/216/347/224/237/346/210/220Prompt.md

@@ -0,0 +1,349 @@
+# 需求变动说明生成Prompt
+
+## 基础Prompt
+
+```
+请看下当前<版本目录>的需求和<commit-hash>这个commit的差异，并形成一个变动说明文档。
+
+要求：
+1. 对比这两个commit之间的所有文件变化（不仅仅是这个commit涉及的文件，而是这个commit之后的所有文件的状态）
+2. 详细说明每个文档的新增、修改、删除内容
+3. 所有的修改说明希望能链接到具体的位置（文件名和行号）
+4. 在第3、4节中具体说明都做了哪些变动、新增、去除，便于跟踪变化
+5. 使用📄表示文件链接，📍表示位置链接
+6. 生成统计表格汇总变动情况
+7. 章节序号要连续正确
+8. 在标题上增加对比的两段日期的说明
+
+文档结构要求：
+- 第1节：变动概述
+- 第2节：Commit历史
+- 第3节：文档级变动详情（详细说明新增、修改、删除内容及具体位置）
+- 第4节：功能维度变动分析（从功能角度分析变动）
+- 第5节：产品策略分析
+- 第6节：附录（统计表、命令等）
+
+不要包含：
+- 开发影响评估章节
+- 待确认事项章节
+- 建议后续行动章节
+```
+
+## 增强Prompt（包含更多细节）
+
+```
+我需要生成一份需求文档变动说明，对比<旧commit>和<新commit>（或HEAD）之间的变化。
+
+### 分析要求：
+
+1. **识别所有变更文件**
+   - 使用 git diff --stat 和 git diff --name-status 识别变更的文件
+   - 区分修改(M)、新增(A)、删除(D)的文件
+   - 分版本目录（如v2.0.0、v2.1.0）组织
+
+2. **详细分析每个文件**
+   - 对于修改的文件：
+     * 使用 git diff 查看具体变更
+     * 使用 grep "^## |^### " 获取章节结构
+     * 使用 grep -n 定位关键内容的行号
+     * 详细列出新增的章节、功能点（附带行号链接）
+     * 详细列出修改的内容（附带行号链接）
+     * 说明删除的内容
+   
+   - 对于新增的文件：
+     * 获取文档的章节结构
+     * 列出主要章节并链接到具体行号
+     * 标注文档规模（总行数）
+     * 说明文档的功能类型
+
+3. **生成文档结构**
+
+**第1节 - 变动概述**：
+- 标题下方用引用块显示：变动周期（起止日期）、对比版本（commit号）
+- 对比版本信息（commit号、日期、提交信息）
+- 总体统计（文件数、行数变化）
+
+**第2节 - Commit历史**：
+- 列出期间所有commit
+- 每个commit包含：hash、日期、提交信息、变更文件概要
+
+**第3节 - 文档级变动详情**：
+按版本目录组织，对每个文档：
+- 添加📄文件链接
+- 标注变动量（+/-行数）
+- **新增内容**：列表形式，重要项用📍链接到具体行号
+- **修改内容**：列表形式，重要项用📍链接到具体行号
+- **删除内容**：说明删除的内容
+
+**第4节 - 功能维度变动分析**：
+- 4.1 核心新功能：列出新增的重要功能，每个功能包含：
+  * 📄文档链接
+  * 功能定位
+  * 新增内容（各功能模块用📍链接）
+  * 技术要求（用📍链接）
+  * 开发复杂度预估
+  
+- 4.2 核心功能优化：列出优化的功能，包含：
+  * 📄文档链接
+  * 新增部分（用📍链接）
+  * 修改部分（用📍链接）
+  * 删除部分
+  * 开发影响预估
+
+**第5节 - 产品策略分析**：
+- 功能战略定位（创作能力、用户增长、商业化）
+- 版本演进路径
+
+**第6节 - 附录**：
+- 完整变更文件清单
+- 变动统计汇总表（markdown表格）
+- Commit详情
+- Git命令
+- 文档结构树状图
+
+### 格式要求：
+
+1. **链接格式**：
+   - 文件链接：`📄 查看文件 (./文件名.md)` 或 `📄 查看完整文档 (../vX.X.X/文件名.md)`
+   - 行号链接：`📍 说明文字 → \`章节名称:行号\` (./文件名.md#L行号)`
+
+2. **图标使用**：
+   - 📄 文件链接
+   - 📍 位置链接
+   - ⭐⭐⭐ / ⭐⭐ / ⭐ 重要程度
+
+3. **表格格式**：
+   ```markdown
+   | 类型 | 数量 | 行数 |
+   |------|------|------|
+   | 修改文档 | X个 | +XXX/-XX |
+   ```
+
+4. **章节序号**：确保连续，无跳跃
+
+5. **引用块**：标题下方的关键信息用 `>` 引用
+
+### 输出文档
+
+文档命名：`YYYYMMDD_需求文档变动说明_<旧commit>至<新commit>.md`
+保存位置：`../../vX.X.X/`
+
+请开始分析并生成变动说明文档。
+
+```
+
+## 分步执行Prompt（适合复杂场景）
+
+### Step 1: 收集变更信息
+
+```
+
+第一步：收集变更信息
+
+请执行以下命令并记录结果：
+
+1. 查看变更文件列表：
+   git diff --name-status <旧commit>..<新commit> -- "../../requirements"
+
+2. 查看变更统计：
+   git diff --stat <旧commit>..<新commit> -- "../../requirements"
+
+3. 查看commit历史：
+   git log --oneline <旧commit>..<新commit>
+
+4. 对每个commit查看详情：
+   git show --stat <commit-hash>
+
+请整理并告诉我：
+
+- 有哪些文件被修改了？（M）
+- 有哪些文件是新增的？（A）
+- 有哪些文件被删除了？（D）
+- 每个文件的行数变化
+- 涉及的commit数量和信息
+
+```
+
+### Step 2: 分析修改的文档
+
+```
+
+第二步：分析修改的文档
+
+对于每个被修改的文档（标记为M），请：
+
+1. 查看文档的章节结构：
+   grep -n "^## |^### |^#### " 文档路径
+
+2. 查看具体变更：
+   git diff <旧commit>..<新commit> -- "文档路径"
+
+3. 对每个文档生成变动说明，包括：
+   - 📄 文件链接
+   - 变动量（+X行/-Y行）
+   - **新增内容**：
+     - 新增的章节（章节名 + 行号链接）
+     - 新增的功能点（描述 + 行号链接）
+   - **修改内容**：
+     - 修改的章节（章节名 + 行号链接）
+     - 修改的内容描述
+   - **删除内容**：
+     - 删除的内容说明
+
+请分析：<文档名>
+
+```
+
+### Step 3: 分析新增的文档
+
+```
+
+第三步：分析新增的文档
+
+对于每个新增的文档（标记为A），请：
+
+1. 查看文档章节结构：
+   grep -n "^## |^### |^#### " 文档路径
+
+2. 查看文档行数：
+   wc -l 文档路径
+
+3. 生成文档说明，包括：
+   - 📄 文件链接
+   - 文档规模（总行数）
+   - **包含内容**（主要章节，每个章节链接到行号）：
+     - 📍 章节1 → [`章节名称:行号`](路径#L行号)
+     - 📍 章节2 → [`章节名称:行号`](路径#L行号)
+   - 功能类型说明
+
+请分析：<文档名>
+
+```
+
+### Step 4: 生成完整文档
+
+```
+
+第四步：生成完整的变动说明文档
+
+基于前面收集的信息，生成完整文档，结构如下：
+
+# [版本] 需求文档变动说明
+
+> **变动周期**: <起始日期> → <结束日期>（X天）  
+> **对比版本**: `<旧commit>` → `<新commit>`
+
+## 1. 变动概述
+
+[填入：版本信息、统计数据]
+
+## 2. Commit 历史
+
+[填入：每个commit的信息]
+
+## 3. 文档级变动详情
+
+[填入：每个文档的详细变动]
+
+## 4. 功能维度变动分析
+
+[填入：功能级别的分析]
+
+## 5. 产品策略分析
+
+[填入：战略层面的分析]
+
+## 6. 附录
+
+[填入：统计表、命令等]
+
+请生成完整文档。
+
+```
+
+## 质量检查Prompt
+
+```
+
+请检查刚生成的变动说明文档，确认：
+
+1. **链接有效性**：
+   - [ ] 所有📄文件链接路径正确
+   - [ ] 所有📍行号链接格式正确（使用#L前缀）
+   - [ ] 相对路径使用正确（./同级，../上级）
+
+2. **内容完整性**：
+   - [ ] 所有修改的文档都有新增、修改、删除说明
+   - [ ] 重要功能点都有行号链接
+   - [ ] 统计数据准确（文件数、行数）
+   - [ ] Commit信息完整
+
+3. **格式规范**：
+   - [ ] 章节序号连续（1,2,3,4,5,6）
+   - [ ] 图标使用正确（📄📍⭐）
+   - [ ] 表格格式正确
+   - [ ] 代码块正确标记
+
+4. **可读性**：
+   - [ ] 结构清晰
+   - [ ] 描述准确
+   - [ ] 重点突出
+
+请指出发现的问题并修正。
+
+```
+
+## 使用示例
+
+### 示例1：基础使用
+
+```
+
+请看下当前v2.0.0的需求和90cad63faefa9edd7957c256493ae144bd4de5b5这个commit的差异，
+并形成一个变动说明文档。
+
+要求按照标准格式，包含详细的变动说明和具体位置链接。
+
+```
+
+### 示例2：多版本对比
+
+```
+
+请对比../../目录下v2.0.0和v2.1.0两个版本，
+在commit 90cad63 到 HEAD 之间的所有变化，生成变动说明文档。
+
+需要：
+
+1. 分别说明两个版本的变化
+2. v2.1.0是新增的版本目录，需要特别标注
+3. 所有重要变动都要有具体位置链接
+
+```
+
+### 示例3：重点功能分析
+
+```
+
+生成需求变动说明，重点分析以下功能的变化：
+
+1. Draw to Video功能（新增）
+2. 积分签到系统（新增）
+3. 多模式视频生成平台（大幅更新）
+4. 付费方案优化（新增）
+
+对每个功能详细说明：
+
+- 功能模块及具体位置
+- 技术实现要求及位置
+- 开发工作量预估
+
+```
+
+## 注意事项
+
+1. **确保git仓库状态**：在分析前确认本地仓库是最新的
+2. **行号可能变化**：如果文档被修改，行号可能不准确，需要重新确认
+3. **相对路径**：注意文档之间的相对路径关系
+4. **图片文件**：图片文件标注类型和用途，不需要行号
+5. **draft文件**：draft文件简要说明即可，不需要详细分析

package/skills/aipk_requirements/changes/template//351/234/200/346/261/202/345/217/230/345/212/250/350/257/264/346/230/216/347/224/237/346/210/220/346/214/207/345/215/227.md

@@ -0,0 +1,292 @@
+# 需求变动说明文档生成指南
+
+## 一、目标
+
+为两个git commit之间的需求文档变更生成一份详细的变动说明文档，帮助团队成员快速了解：
+
+- 哪些文档发生了变化
+- 具体新增、修改、删除了什么内容
+- 每个变动的具体位置（可点击跳转）
+- 变动对开发和产品的影响
+
+## 二、准备工作
+
+### 2.1 确定对比版本
+
+```bash
+# 查看最近的commit历史
+git log --oneline -20
+
+# 确定要对比的两个commit
+# 例如：90cad63 (旧版本) 和 HEAD (新版本)
+```
+
+### 2.2 获取变更信息
+
+```bash
+# 查看两个版本之间的所有文件变更
+git diff --stat <旧commit>..<新commit>
+
+# 查看文件状态（新增A、修改M、删除D）
+git diff --name-status <旧commit>..<新commit>
+
+# 查看具体文件的变更
+git diff <旧commit>..<新commit> -- "路径/文件名.md"
+
+# 查看commit历史
+git log --oneline <旧commit>..<新commit>
+```
+
+### 2.3 收集文档结构信息
+
+```bash
+# 获取文档的章节结构（使用grep）
+grep "^## |^### |^#### " 文件路径.md
+
+# 查找特定内容的行号
+grep -n "关键词" 文件路径.md
+```
+
+## 三、生成步骤
+
+### 3.1 创建文档基本信息
+
+1. **文档命名**：`YYYYMMDD_需求文档变动说明_<旧commit>至<新commit>.md`
+2. **标题设置**：
+   - 主标题：说明涉及的版本
+   - 副标题：标注变动周期和对比版本
+
+### 3.2 编写变动概述（第1节）
+
+包含内容：
+
+- 对比版本信息（commit号、日期、提交信息）
+- 变动周期（起止日期、天数）
+- 总体变动统计（文件数、行数、新增文档数）
+
+### 3.3 记录Commit历史（第2节）
+
+对每个commit记录：
+
+- Commit号和日期
+- 提交信息
+- 变更文件列表及行数统计
+
+### 3.4 详细分析文档变动（第3节）
+
+**分版本说明**（如v2.0.0、v2.1.0）：
+
+#### 对于修改的文档
+
+- 添加文档链接
+- 标注变动量（+X行 / -Y行）
+- **新增内容**：列出新增的章节、功能点，并链接到具体行号
+- **修改内容**：说明优化和调整的部分，并链接到具体行号
+- **删除内容**：说明删除的内容及原因
+
+#### 对于新增的文档
+
+- 添加文档链接
+- 标注文档规模（总行数）
+- 列出文档包含的主要章节，每个章节链接到具体行号
+- 标注功能类型（如：新功能、商业化优化、用户运营等）
+
+### 3.5 功能维度分析（第4节）
+
+#### 核心新功能（4.1）
+
+对每个新功能：
+
+- 添加文档链接
+- 功能定位（创作能力、用户留存、商业化等）
+- **新增内容**：详细列出功能模块，链接到文档具体位置
+- **技术要求**：列出技术实现要点，链接到相关章节
+- **开发复杂度**：预估工作量
+
+#### 核心功能优化（4.2）
+
+对优化的功能：
+
+- 添加文档链接
+- **新增部分**：列出新增内容及行号链接
+- **修改部分**：列出修改内容及行号链接
+- **删除部分**：说明删除内容
+- **开发影响**：预估工作量
+
+### 3.6 产品策略分析（第5节）
+
+- 功能战略定位（创作能力、用户增长、商业化）
+- 版本演进路径（各版本的定位和重点）
+
+### 3.7 附录信息（第6节）
+
+- 完整变更文件清单
+- 变动统计汇总表
+- Commit详情
+- 查看差异的git命令
+- 文档结构树状图
+
+## 四、关键要点
+
+### 4.1 链接格式
+
+**文件链接**：
+
+```markdown
+📄 查看文件 (./文件名.md)
+📄 查看完整文档 (../v2.1.0/文件名.md)
+```
+
+**章节行号链接**：
+
+```markdown
+📍 功能说明 → `章节名称:行号` (./文件名.md#L行号)
+📍 详细设计 → `3.1.1 页面设计:156` (./文件名.md#L156)
+```
+
+### 4.2 使用图标
+
+- 📄 文件链接
+- 📍 位置链接（行号）
+- ⭐⭐⭐ 重要程度标识
+- ✅ 完成状态
+- 🔵 系统操作
+- 🟢 用户操作
+- 🟡 判断节点
+
+### 4.3 表格格式
+
+```markdown
+| 类型 | 数量 | 行数 |
+|------|------|------|
+| 修改文档 | 2个 | +471/-102 |
+| 新增文档 | 3个 | 1196行 |
+| **合计** | **5个** | **+1725/-112** |
+```
+
+### 4.4 代码块格式
+
+```markdown
+```bash
+git diff --stat 90cad63..HEAD
+```
+
+```
+
+## 五、质量检查清单
+
+- [ ] 所有修改的文档都有详细的新增、修改、删除说明
+- [ ] 重要功能点都有具体的行号链接
+- [ ] 所有链接都可以正确跳转
+- [ ] 章节序号连续无误
+- [ ] 统计数据准确（文件数、行数）
+- [ ] Commit信息完整（hash、日期、作者、提交信息）
+- [ ] 文档结构清晰，易于阅读
+- [ ] 使用了适当的图标和格式化
+- [ ] 包含了开发工作量预估
+- [ ] 提供了产品策略分析
+
+## 六、AI Prompt 示例
+
+```
+
+请看下当前<版本目录>的需求和<commit-hash>这个commit的差异，
+并形成一个变动说明文档。
+
+要求：
+
+1. 对比这两个commit之间的所有文件变化
+2. 详细说明每个文档的新增、修改、删除内容
+3. 所有的修改说明希望能链接到具体的位置（文件名和行号）
+4. 删除第5、7、8节，在第3、4节中具体说明变动、新增、去除
+5. 使用📄表示文件链接，📍表示位置链接
+6. 生成统计表格汇总变动情况
+7. 章节序号要连续正确
+8. 在标题上增加对比的两段日期的说明
+
+```
+
+## 七、工具和技巧
+
+### 7.1 快速获取章节结构
+
+```bash
+# 获取二级标题
+grep "^## " 文件.md
+
+# 获取三级标题
+grep "^### " 文件.md
+
+# 获取所有标题并显示行号
+grep -n "^#" 文件.md
+```
+
+### 7.2 快速定位关键词
+
+```bash
+# 查找关键词并显示行号
+grep -n "关键词" 文件.md
+
+# 查找关键词并显示上下文
+grep -C 3 "关键词" 文件.md
+```
+
+### 7.3 批量处理
+
+```bash
+# 查看多个文件的变更
+for file in $(git diff --name-only 90cad63..HEAD -- "../../requirements"); do
+  echo "=== $file ==="
+  git diff --stat 90cad63..HEAD -- "$file"
+done
+```
+
+## 八、常见问题
+
+### Q1: 如何确定重要程度？
+
+A: 根据以下标准：
+
+- ⭐⭐⭐ 新增重要功能、重大修改（>300行）
+- ⭐⭐ 中等功能优化、新增文档（100-300行）
+- ⭐ 小幅优化、格式调整（<100行）
+
+### Q2: 链接失效怎么办？
+
+A:
+
+- 确保行号准确（使用grep -n查找）
+- 相对路径要正确（同目录./，上级目录../）
+- GitHub渲染需要使用#L前缀
+
+### Q3: 如何处理删除的文件？
+
+A:
+
+- 在变更清单中标注[已删除]
+- 说明删除原因
+- 如有替代方案，说明替代文件
+
+### Q4: 如何预估开发工作量？
+
+A: 考虑因素：
+
+- 功能复杂度（界面、交互、算法）
+- 技术依赖（新技术、第三方库）
+- 接口数量
+- 测试难度
+- 一般按2-3人日/100行代码估算
+
+## 九、示例参考
+
+参考文档：
+
+- `20251017_需求文档变动说明_90cad63至fa5a716.md`
+
+该文档展示了完整的变动说明格式，包括：
+
+- 清晰的文档结构
+- 详细的变动说明
+- 完整的链接系统
+- 准确的统计数据
+- 有价值的分析内容