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

package/mcp/.doc_cache/341909c063335dd2_/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/mcp/.doc_cache/3e0dfd0a1b9f6ce7_/344/272/247/345/223/201/351/234/200/346/261/202/345/217/221/347/216/260/344/270/216/351/252/214/350/257/201/346/250/241/346/235/277.md

@@ -0,0 +1,53 @@
+# 产品需求发现与验证
+
+## 研究目标
+深度挖掘 {PRODUCT_TYPE} 领域的用户需求，验证产品假设，识别未被满足的需求机会。
+
+## 背景信息
+### 产品背景
+- **产品类型**：{PRODUCT_TYPE}
+- **目标用户**：{TARGET_USERS}
+- **当前阶段**：{DEVELOPMENT_STAGE}
+- **核心假设**：{CORE_ASSUMPTIONS}
+
+## 研究范围
+### 核心研究问题
+1. 目标用户群体的核心痛点和未被满足的需求是什么？
+2. 现有解决方案的不足之处在哪里？
+3. 用户对新功能或改进的接受度和期望如何？
+4. 不同用户细分群体的需求差异是什么？
+
+### 重点分析维度
+- **用户行为模式**：使用场景、频率、习惯
+- **痛点层次分析**：表面痛点 vs 深层需求
+- **解决方案评估**：现有产品的优缺点分析
+- **需求优先级**：基于用户价值和实现难度的排序
+
+## 特定分析要求
+### 用户反馈分析
+- 分析应用商店评论中的高频关键词和情感倾向
+- 识别用户投诉和建议的主要类别
+- 提取用户对竞品功能的评价和期望
+
+### 行为数据洞察
+- 分析用户留存率和活跃度数据的影响因素
+- 识别用户流失的关键节点和原因
+- 研究成功产品的用户增长模式
+
+### 市场机会识别
+- 对比分析不同产品的功能覆盖度
+- 识别功能空白和创新机会
+- 评估新需求的市场规模和可行性
+
+## 输出要求
+### 需求分析报告
+1. **用户需求地图**：按优先级和实现难度的需求矩阵
+2. **痛点分析**：详细的用户痛点分类和影响评估
+3. **机会识别**：具体的产品改进和创新机会
+4. **验证建议**：需求验证的具体方法和指标
+
+### 可执行建议
+- 优先开发的功能列表及理由
+- 用户研究的具体执行计划
+- 产品迭代的时间线和里程碑
+- 风险评估和应对策略