@guru-ai-product/ai-product-kit 0.2.251112184032 → 0.2.251113163244

package/mcp/.doc_cache/3eab19b804522d23_SKILL.md

@@ -0,0 +1,407 @@
+---
+name: initiative-planning
+description: Comprehensive workflow for evaluating, scoping, and approving new product initiatives.
+---
+
+# 立项规划
+
+> 🎯 **产品立项规划完整指南** - 从需求收集到需求文档撰写的关键桥梁，确保产品方向正确、资源合理分配
+
+## 📋 文档信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | v1.0 |
+| 适用范围 | 产品团队、项目经理、技术负责人、商业分析师 |
+
+## 🎯 指南价值
+
+本立项规划旨在为产品团队提供从需求收集到具体需求文档撰写之间的关键桥梁，通过系统化的立项规划流程，确保：
+
+- **战略对齐**：确保产品方向与公司战略目标一致
+- **可行性论证**：在投入大量资源前论证技术和商业可行性
+- **资源规划**：合理评估和分配开发资源
+- **风险控制**：提前识别和规避主要风险
+- **结构化思考**：将复杂的产品构想转化为清晰的规划框架
+- **决策支持**：为立项决策提供充分的分析依据
+
+## 🚀 适用场景
+
+- 新产品立项前的整体规划
+- 重大功能模块的可行性评估
+- 技术架构选型和规划
+- 商业模式验证和规划
+- 项目投资决策支持
+- 基于需求收集结果进行产品立项规划
+
+## 🔄 立项规划流程
+
+### 整体流程
+
+```
+需求收集 → 立项规划 → 需求文档撰写 → 需求评审
+    ↓         ↓           ↓            ↓
+市场洞察 → 整体规划 → 详细需求 → 开发实施
+```
+
+### 核心阶段
+
+1. **市场与商业分析**：基于需求收集结果，进行深度的市场和商业价值分析
+2. **产品规划**：确定产品的核心功能、用户体验和差异化策略
+3. **技术规划**：进行技术架构设计和技术选型
+4. **商业化规划**：设计商业模式和变现策略
+5. **SWOT分析**：全面分析优势劣势、机会威胁，制定综合策略
+
+## 📚 文档结构
+
+### 标准文档结构
+
+```
+立项规划文档
+├── 1. 市场与商业分析
+├── 2. 产品规划
+├── 3. 技术规划
+├── 4. 商业化规划
+└── 5. SWOT分析
+```
+
+### 各部分内容要点
+
+**市场与商业分析**
+
+- 基于需求收集的市场机会分析
+- 商业价值评估和盈利模式初步设计
+- 竞争优势和差异化策略
+
+**产品规划**
+
+- 核心功能和用户体验规划
+- 产品路线图和迭代策略
+- 用户价值主张和产品定位
+
+**技术规划**
+
+- 技术架构设计和选型建议
+- 技术可行性分析
+- 技术资源需求评估
+
+**商业化规划**
+
+- 商业模式设计和验证
+- 变现策略和市场推广
+- 合作伙伴和生态建设
+
+**SWOT分析**
+
+- 优势劣势分析及应对策略
+- 机会威胁识别及把握方法
+- 综合策略制定和优先级排序
+
+## 📋 模板库
+
+- **[市场与商业分析模板](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/a3328dcce1521943_市场与商业分析模板.md)** - 市场机会和商业价值评估
+- **[产品规划模板](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/1e4a829f0abddb00_产品规划模板.md)** - 产品功能和体验规划
+- **[技术规划模板](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/da8f4d40a1e8f36a_技术规划模板.md)** - 技术架构和选型规划
+- **[商业化规划模板](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/8f981c56b3d4b17d_商业化规划模板.md)** - 商业模式和变现策略
+- **[SWOT分析模板](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/8f420425062dcb93_SWOT分析模板.md)** - 优势劣势机会威胁分析及策略制定
+
+## 🔧 使用流程
+
+### 准备阶段
+
+1. **收集输入材料**
+   - 需求收集报告和用户洞察
+   - 市场分析和竞品研究结果
+   - 技术调研和可行性分析
+   - 商业目标和战略方向
+
+2. **确定规划范围**
+   - 明确立项的产品或功能范围
+   - 设定规划的时间周期
+   - 识别关键利益相关者
+
+3. **组建规划团队**
+   - 产品经理：负责整体规划协调
+   - 技术负责人：负责技术规划部分
+   - 商业分析师：负责商业分析部分
+   - 项目经理：负责实施规划部分
+
+### 撰写阶段
+
+#### 步骤1：市场与商业分析
+
+基于需求收集结果，深入分析市场机会和商业价值：
+
+```markdown
+## 市场与商业分析
+
+### 市场机会分析
+- 基于需求收集的市场规模和增长潜力
+- 目标用户群体的痛点和需求验证
+- 市场时机和窗口期分析
+
+### 商业价值评估
+- 预期收入和盈利模式
+- 投资回报率（ROI）分析
+- 成本效益分析
+
+### 竞争优势分析
+- 基于竞品分析的差异化策略
+- 核心竞争力和护城河
+- 市场定位和价值主张
+```
+
+#### 步骤2：产品规划
+
+将用户需求转化为具体的产品规划：
+
+```markdown
+## 产品规划
+
+### 核心功能规划
+- 基于用户痛点的核心功能设计
+- 功能优先级和MVP范围
+- 用户体验和交互设计要点
+
+### 产品路线图
+- 分阶段的功能发布计划
+- 关键里程碑和验证节点
+- 迭代策略和反馈机制
+
+### 产品定位
+- 目标用户群体定义
+- 产品价值主张
+- 品牌定位和差异化策略
+```
+
+#### 步骤3：技术规划
+
+进行技术架构设计和选型：
+
+```markdown
+## 技术规划
+
+### 技术架构设计
+- 系统架构和技术选型
+- 关键技术组件和依赖
+- 性能和扩展性考虑
+
+### 技术可行性论证
+- 技术实现难度评估
+- 技术风险和挑战
+- 技术团队能力匹配
+
+### 技术资源需求
+- 开发人员技能要求
+- 技术基础设施需求
+- 第三方服务和工具需求
+```
+
+#### 步骤4：商业化规划
+
+设计商业模式和变现策略：
+
+```markdown
+## 商业化规划
+
+### 商业模式设计
+- 价值创造和价值传递
+- 收入模式和定价策略
+- 成本结构和盈利模式
+
+### 变现策略
+- 短期和长期变现路径
+- 用户付费意愿和价格敏感度
+- 多元化收入来源
+
+### 市场推广
+- 用户获取策略和渠道
+- 品牌建设和营销策略
+- 合作伙伴和生态建设
+```
+
+#### 步骤5：SWOT分析
+
+进行综合的SWOT分析：
+
+```markdown
+## SWOT分析
+
+### 优势分析
+- 技术优势、团队优势、资源优势
+- 优势利用和放大策略
+- 优势转化为竞争力的方法
+
+### 劣势分析
+- 技术劣势、团队劣势、资源劣势
+- 劣势改进和补强策略
+- 劣势规避和风险控制
+
+### 机会分析
+- 市场机会、技术机会、政策机会
+- 机会把握和抓取策略
+- 机会创造和价值转化
+
+### 威胁分析
+- 竞争威胁、市场威胁、技术威胁
+- 威胁防范和应对策略
+- 威胁转化为机会的可能性
+
+### 综合策略
+- SO、ST、WO、WT组合策略
+- 策略优先级排序
+- 实施建议和行动计划
+```
+
+### 整合阶段
+
+1. **一致性检查**：确保各部分内容逻辑一致
+2. **完整性验证**：检查是否覆盖所有关键要素
+3. **可行性评估**：验证整体规划的可执行性
+4. **风险平衡**：确保风险和收益的合理平衡
+
+## 💡 最佳实践
+
+### 规划建议
+
+- 基于需求收集结果，保持与前期研究的一致性
+- 注重可行性论证，避免过度理想化
+- 平衡创新性和风险控制
+- 考虑资源约束和时间限制
+- 使用数据驱动的方法，避免主观臆测
+- 保持结构化思考，突出关键要点
+
+### 团队协作
+
+- 跨职能团队参与，确保多角度分析
+- 建立清晰的决策流程和责任分工
+- 定期沟通和反馈，及时调整规划
+- 文档化决策过程，便于后续追溯
+- 充分讨论和达成共识
+- 记录不同观点和分歧
+
+### 质量控制
+
+- 确保分析的全面性和深度
+- 验证数据和假设的可靠性
+- 评估规划的可执行性
+- 检查各部分内容的一致性
+- 使用统一的文档模板
+- 提供清晰的导航和索引
+
+## ❓ 常见问题
+
+### 规划深度问题
+
+**Q1：立项规划的详细程度如何把握？**
+A：立项规划应该：
+
+- 比需求收集更具体，但比需求文档更宏观
+- 重点关注可行性和整体方向
+- 避免过度细化具体实现细节
+- 为后续需求文档提供明确指导
+
+**Q2：如何平衡创新性和可行性？**
+A：建议策略：
+
+- 分阶段论证创新想法
+- 设置可行性论证节点
+- 准备备选方案
+- 控制创新风险的范围
+
+### 团队协作问题
+
+**Q3：如何协调不同职能团队的观点？**
+A：协调方法：
+
+- 建立共同的目标和成功标准
+- 定期举行跨职能讨论会
+- 记录和处理分歧意见
+- 寻求上级决策支持
+
+**Q4：如何确保规划的可执行性？**
+A：保证措施：
+
+- 基于团队实际能力制定计划
+- 设置现实可达的里程碑
+- 预留风险缓冲时间
+- 定期检查和调整计划
+
+## 📊 输出规范
+
+### 交付物清单
+
+**主要交付物**
+
+- 立项规划文档
+- 关键分析图表
+- 风险评估矩阵
+- 实施计划甘特图
+
+**支撑材料**
+
+- 市场分析报告
+- 技术可行性分析
+- 财务预测模型
+- 竞品对比分析
+
+### 质量标准
+
+**准确性**
+
+- 数据和分析基于可靠来源
+- 假设和预测有合理依据
+- 避免过度乐观或悲观
+
+**完整性**
+
+- 覆盖所有关键分析维度
+- 考虑主要风险和挑战
+- 提供充分的决策信息
+
+**可执行性**
+
+- 规划具体可操作
+- 资源需求现实可行
+- 时间安排合理可达
+
+**一致性**
+
+- 各部分内容逻辑一致
+- 目标和策略相互支撑
+- 风险和收益相匹配
+
+## 🔗 相关资源
+
+### 前置文档
+
+- [需求收集](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/db70562fc59f1658_SKILL.md)
+
+### 后续文档
+
+- [需求文档](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/e1451d5b65894789_SKILL.md)
+- [需求评审](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/da2c3d4d7b8957af_SKILL.md)
+
+### 外部资源
+
+- [指南文档规范](/Users/wuchong/Develop/AI_Product_Kit/mcp/.doc_cache/5b91334295d6ad31_SKILL.md)
+
+## 📞 获取帮助
+
+如遇到问题，请参考：
+
+1. 本文档中的常见问题部分
+2. 查看相关模板文档
+3. 联系技术支持团队
+
+---
+
+**注意事项**：
+
+- 立项规划应基于扎实的需求收集结果
+- 重视可行性论证，避免盲目立项
+- 保持规划的灵活性，根据实际情况调整
+- 确保所有利益相关者的参与和共识
+
+**最后更新**：2025-08-01  
+**版本**：v1.0

package/mcp/.doc_cache/4b671afde6bb1fa8_/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`
+
+该文档展示了完整的变动说明格式，包括：
+
+- 清晰的文档结构
+- 详细的变动说明
+- 完整的链接系统
+- 准确的统计数据
+- 有价值的分析内容