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

package/skills/aipk_requirements/SKILL.md

@@ -0,0 +1,243 @@
+---
+name: requirements
+description: Central repository for requirement discovery, documentation, review, and change management assets.
+---
+
+# 需求阶段资料库
+
+## 1. 概述
+
+本文档库是产品需求收集与管理的核心枢纽，旨在为产品团队提供一套完整、标准化的需求工作流程。这里汇集了从市场研究、用户洞察到需求文档撰写及评审的全流程指南、工具和模板。
+
+通过遵循本库定义的规范，团队可以：
+
+- **提升效率**：利用先进的工具和标准化的模板，快速进行需求收集与分析。
+- **保证质量**：通过统一的文档规范和评审流程，确保需求文档的清晰、完整和一致。
+- **促进协作**：为产品、研发、设计等团队提供共同的语言和协作基础。
+
+## 2. 文档结构
+
+本目录包含以下核心部分，请根据您的需要查阅：
+
+### 2.1 [需求收集](./intake/)
+
+本部分提供了进行高效需求研究所需的工具、方法论和模板。内容涵盖市场分析、竞品追踪、用户洞察等。
+
+- **核心文档**: `[需求收集](./intake/SKILL.md)` - 详细介绍了如何结合使用 Gemini DeepResearch 和各类数据平台进行深度研究。
+
+### 2.2 [立项规划](./initiative_planning/)
+
+本部分提供了产品立项阶段的规划方法和工具，帮助团队在项目启动前进行全面的分析和规划。
+
+- **核心文档**: `[立项规划](./initiative_planning/SKILL.md)` - 详细介绍了如何进行产品立项规划。
+
+### 2.3 [需求文档与迭代](./documentation/)
+
+> ⚠️ 重要：在开始任何需求文档撰写前，请先查看模板选择指南
+
+本部分提供了需求文档模板和需求迭代模板的统一指南，帮助正确选择适合的模板类型。
+
+- **核心文档**: `[需求文档与迭代模板指南](./documentation/SKILL.md)` - 包含模板选择决策树、确认流程和两个模板的执行流程。
+- **适用场景**:
+  - 需求文档模板：新产品开发（从0到1）、重大功能模块开发、需要完整产品规划的场景
+  - 需求迭代模板：现有功能优化迭代、小功能新增或修改、基于现有产品的功能改进
+
+### 2.4 [需求评审](./review/)
+
+本部分详细说明了需求评审的流程、标准和最佳实践，以确保需求的有效性、可行性和商业价值。
+
+- **核心文档**: `[需求评审](./review/SKILL.md)` - 指导团队如何进行高效的需求评审会议。
+
+## 3. 工作流程建议
+
+一个标准的需求处理流程如下：
+
+1. **立项规划**: 遵循 `[立项规划](./initiative_planning/)` 的方法进行产品立项前的全面分析和规划。
+
+   **Prompt 模板示例：**
+
+   ```md
+   你是一位资深的产品战略专家，需要基于项目背景进行全面的立项规划分析。
+
+   **项目背景**: {项目的基本背景和目标}
+   **产品定位**: {产品的初步定位}
+   **目标市场**: {目标市场描述}
+
+   请参考以下指南和模板进行立项规划：
+   - 立项指南: ./initiative_planning/SKILL.md
+   - SWOT分析模板: ./initiative_planning/template/SWOT分析模板.md
+   - 产品规划模板: ./initiative_planning/template/产品规划模板.md
+   - 技术规划模板: ./initiative_planning/template/技术规划模板.md
+   - 商业化规划模板: ./initiative_planning/template/商业化规划模板.md
+
+   **输出要求**:
+   1. 进行SWOT分析，识别项目的优势、劣势、机会和威胁
+   2. 制定详细的产品规划和技术规划
+   3. 设计商业化策略和盈利模式
+   4. 评估项目可行性和风险
+   5. 输出完整的立项规划文档
+
+   请开始你的立项规划分析。
+
+   ```
+
+2. **研究与发现**: 遵循 `[需求收集](./intake/)` 的方法进行市场和用户研究，发现机会点。
+
+   **Prompt 模板示例：**
+
+   ```md
+   你是一位资深的产品经理和市场研究专家。请基于以下信息进行深度的产品需求发现与验证：
+
+   **研究目标**: {具体的研究目标，如"分析K12在线教育市场的用户痛点"}
+   **目标用户**: {目标用户群体描述}
+   **产品领域**: {产品所属领域}
+   **基本假设**: {初步的产品假设或需求}
+
+   请参考以下指南和模板进行研究：
+   - 需求收集指南: ./intake/SKILL.md
+   - 产品需求发现与验证模板: ./intake/template/产品需求发现与验证模板.md
+   - 市场机会评估与竞争分析模板: ./intake/template/市场机会评估与竞争分析模板.md
+   - 深度用户行为与需求洞察模板: ./intake/template/深度用户行为与需求洞察模板.md
+
+   **输出要求**:
+   1. 使用 Gemini DeepResearch 等工具进行深度市场调研
+   2. 分析竞品情况和市场机会
+   3. 识别用户痛点和需求缺口
+   4. 提供数据支撑的洞察结论
+   5. 输出结构化的研究报告
+
+   请开始你的研究分析。
+
+   ```
+
+3. **撰写与定义**: 遵循 `[需求文档](./documentation/)` 的规范，将需求撰写成结构化的文档。
+
+   **Prompt 模板示例：**
+
+   ```md
+   你是一位经验丰富的产品经理，需要基于第2步"研究与发现"的产出结果，将研究发现转化为标准化的产品需求文档。
+
+   **前期研究成果**（来自第2步产出）:
+   {研究报告内容} - 请在此处引用第2步"研究与发现"环节产出的完整研究报告内容，包括市场分析、竞品分析、用户洞察、痛点识别等关键发现
+
+   **基础信息**:
+   - 产品名称: {产品名称}
+   - 目标用户: {目标用户群体}
+   - 核心功能: {核心功能描述}
+
+   请严格按照以下指南和模板，基于上述研究成果撰写需求文档：
+   - 撰写指南: ./documentation/SKILL.md
+   - 需求文档模板: ./documentation/template/index.md
+   - 产品定位模板: ./documentation/template/1_产品定位与分析.md
+   - 功能需求模板: ./documentation/template/2_功能需求.md
+   - 用户界面模板: ./documentation/template/4_用户界面与体验.md
+   - 技术架构模板: ./documentation/template/5_技术架构与实施计划.md
+   - 运营计划模板: ./documentation/template/6_运营计划.md
+   - 风险评估模板: ./documentation/template/7_风险评估与成功指标.md
+   
+   **埋点需求规范**（如需求中包含埋点设计）:
+   - 埋点规范文档: ./documentation/template/埋点规范文档.md - **必读**：优先复用已有事件和参数名
+
+   **输出要求**:
+   请严格按照以下指南和模板撰写需求文档：
+
+   1. **基于研究报告的产品定位与市场分析**
+   2. **针对发现痛点的详细功能需求规格说明**
+   3. **符合用户洞察的界面与体验设计要求**
+   4. **可执行的技术架构与实施计划**
+   5. **完整的运营计划与推广策略**
+   6. **全面的风险评估与成功指标**
+   7. **符合团队协作标准的文档格式**
+
+   确保需求文档与前期研究发现保持一致，并基于提供的模板结构撰写完整的产品需求文档。
+
+   **注意：具体的文档输出规范请参考 ./documentation/SKILL.md 中的"文档输出规范"部分。**
+
+   ```
+
+4. **评审与确认**: 遵循 `[需求评审](./review/)` 的流程，对需求文档进行评审，达成共识。
+
+   **Prompt 模板示例：**
+
+   ```md
+   你是一位资深的产品评审专家，需要基于第3步"撰写与定义"的产出结果，对已完成的产品需求文档进行全面的评审和确认。
+
+   **待评审的需求文档**（来自第3步产出）:
+   {需求文档内容} - 请在此处引用第3步"撰写与定义"环节产出的完整需求文档内容，包括产品定位、功能需求、用户体验设计、实施计划等所有章节
+
+   **评审范围**: {评审的具体范围，如功能完整性、技术可行性等}
+   **参与角色**: {评审参与的角色，如产品、技术、设计、运营等}
+
+   请参考以下评审指南，基于上述需求文档进行系统性评审：
+   - 评审指南: ./review/SKILL.md
+
+   **评审维度**:
+   1. **需求完整性**: 检查需求描述是否完整、清晰、无歧义
+   2. **商业价值**: 评估需求的商业价值和优先级合理性
+   3. **技术可行性**: 分析技术实现的可行性和复杂度
+   4. **用户体验**: 评估用户体验设计的合理性
+   5. **资源评估**: 确认开发资源和时间安排的合理性
+   6. **风险识别**: 识别潜在风险和应对措施
+   7. **一致性检查**: 确认需求文档与前期研究发现的一致性
+
+   **输出要求**:
+   1. 基于具体需求文档内容的结构化评审意见和建议
+   2. 需求优先级的确认或调整建议
+   3. 技术实现方案的确认
+   4. 明确的后续行动计划
+   5. 各方达成的共识记录
+
+   请基于提供的需求文档内容进行详细评审，并提供具体的评审报告。
+   ```
+
+5. **迭代管理**: 参见 2.3 需求文档与迭代，迭代为文档流程的一部分。根据适用场景选择模板：
+   - **需求文档模板**：适用于新产品开发（从0到1）、重大功能模块开发、需要完整产品规划的场景
+   - **需求迭代模板**：适用于现有功能优化迭代、小功能新增或修改、基于现有产品的功能改进
+
+   **Prompt 模板示例：**
+
+   ```md
+   你是一位资深的产品经理，需要基于前期研究和现有产品状态，撰写需求迭代文档。请根据场景选择合适模板：
+   - 如果是新产品或重大功能模块：使用需求文档模板
+   - 如果是现有功能优化或小功能改进：使用需求迭代模板
+
+   **迭代背景**: {迭代的具体背景和原因}
+   **目标功能**: {需要迭代的功能模块}
+   **用户反馈或研究数据**: {用户反馈、数据分析结果或前期研究产出}
+
+   请参考以下指南和模板进行迭代规划：
+   - 需求文档与迭代指南: ./documentation/SKILL.md
+   - 需求文档模板: ./documentation/template/index.md（适用于新产品/重大功能）
+   - 需求迭代模板: ./documentation/template/需求迭代模板.md（适用于功能优化/小功能改进）
+   
+   **埋点需求规范**（如需求中包含埋点设计，如需求迭代模板的3.6节）:
+   - 埋点规范文档: ./documentation/template/埋点规范文档.md - **必读**：优先复用已有事件和参数名
+
+   **输出要求**:
+   1. 分析当前功能的问题和优化机会（或新功能需求）
+   2. 制定具体的迭代方案和实施计划
+   3. 评估迭代的预期效果和风险
+   4. 输出结构化的迭代文档
+
+   请开始你的迭代规划分析。
+
+   ```
+
+---
+
+## 4. 埋点需求规范
+
+当需求文档中包含埋点设计（如需求迭代模板的3.6节）时，**必须参考埋点规范文档**：
+
+- **埋点规范文档**: [`./documentation/template/埋点规范文档.md`](./documentation/template/埋点规范文档.md) - **必读**：包含已定义事件库和参数库，确保复用已有事件和参数名
+
+**重要原则**：
+
+1. 优先复用规范文档中的已有事件名和参数名
+2. 新增事件或参数时，必须严格遵循命名规范
+3. 确保埋点方案的一致性和可复用性
+
+---
+**相关资源**:
+
+- [指南文档总规范](../../docs/guide_writing_standard/SKILL.md)

package/skills/aipk_requirements/changes/SKILL.md

@@ -0,0 +1,196 @@
+---
+name: requirements-changes
+description: Templates, prompts, and procedures for documenting and reviewing requirement changes.
+---
+
+# 需求变动说明生成工具包
+
+## 执行指南
+
+**重要提示**: 本指南专为自动化文档生成设计，请严格按照以下规则执行：
+
+### 执行原则
+
+1. **严格遵循模板结构**: 使用模板时，必须完全按照模板的章节结构和内容格式，不得添加模板中未定义的章节
+2. **内容完整性**: 模板中的所有章节都必须填写，不得跳过任何部分
+3. **格式一致性**: 保持与模板相同的标题层级、编号格式和内容组织方式
+4. **无额外内容**: 禁止在模板基础上添加任何额外的章节、说明或注释
+
+### 模板使用流程
+
+1. **结构遵循**: 严格按照模板的章节结构填写，不得添加或删除章节
+2. **内容填写**: 逐章节填写实质性内容，确保每个章节都有明确的信息
+3. **格式保持**: 保持与模板相同的标题层级、编号格式和内容组织方式
+4. **质量检查**: 完成所有章节后，检查是否遗漏任何模板定义的章节
+
+### 模板使用要求
+
+- 必须填写所有主要章节（变动概述、Commit历史、文档级变动详情、功能维度变动分析、产品策略分析、附录）
+- 根据变动特点选择适用的子章节，不适用的章节使用 `*略*` 标记
+- 每个子部分都要有详细的变动说明
+- 保持文档简洁，专注于核心内容
+
+### 模板内容处理规则
+
+1. **标题处理**: 将模板标题中的 `[版本号]` 替换为具体的版本信息
+2. **占位符处理**: 将模板中的 `[内容]` 替换为实际内容，替换后不要保留中括号
+3. **条件内容**: 根据变动特点选择适用的子章节，不适用的章节使用 `*略*` 标记
+4. **可选内容**: 模板中标注为"可选"的内容，根据项目实际情况决定是否填写
+5. **示例内容**: 模板中的示例内容应替换为实际项目相关内容
+
+### 质量检查清单
+
+- [ ] 文档标题已替换为具体的版本信息
+- [ ] 所有模板章节都已填写
+- [ ] 没有添加模板外的章节
+- [ ] 标题层级与模板一致
+- [ ] 内容格式与模板保持一致
+- [ ] 没有多余的说明或注释
+- [ ] 所有占位符已替换为实际内容
+- [ ] 不适用的章节已使用 `*略*` 标记
+- [ ] 条件内容已根据实际情况处理
+
+---
+
+## 工具包说明
+
+本文件夹包含统一的需求变动说明生成工具包，适用于所有场景的需求文档变更管理。
+
+## 工具包使用
+
+### [需求变动说明文档模板](./template/需求变动说明文档模板.md)
+
+**适用场景**:
+
+- 所有需求文档变更（重大功能、小功能、快速修复等）
+- 跨团队协作项目
+- 需要详细文档记录的项目
+- 正式的产品迭代
+
+**特点**:
+
+- 结构完整，涵盖变动概述、Commit历史、文档级变动详情等各个方面
+- 包含详细的功能维度变动分析、产品策略分析说明
+- 提供完整的统计汇总和附录信息
+- 适合长期项目管理和文档归档
+- **文档标题**: 使用 `[版本号] 需求文档变动说明` 格式，应用时替换为具体的版本信息
+
+### [需求变动说明生成指南](./template/需求变动说明生成指南.md)
+
+**用途**：完整的生成指南文档，包含方法论和最佳实践
+
+**包含内容**：
+
+- 生成目标和准备工作
+- 详细的分步骤生成指导
+- 链接格式、图标使用等规范
+- 质量检查清单
+- 常见问题解答
+- 工具和技巧
+- 示例参考
+
+**适用场景**：
+
+- 第一次生成变动说明时阅读
+- 需要了解完整流程和规范
+- 遇到问题时查找解决方案
+
+### [需求变动说明生成Prompt](./template/需求变动说明生成Prompt.md)
+
+**用途**：AI辅助生成的Prompt集合
+
+**包含内容**：
+
+- 基础Prompt（快速生成）
+- 增强Prompt（详细要求）
+- 分步执行Prompt（复杂场景）
+- 质量检查Prompt
+- 使用示例
+
+**适用场景**：
+
+- 使用AI辅助生成文档
+- 自动化生成基础内容
+- 提高生成效率
+
+## 文件命名规范
+
+### 文档文件命名
+
+**格式**: `YYYYMMDD_需求文档变动说明_旧commit至新commit.md`
+
+**示例**:
+
+- `20251017_需求文档变动说明_90cad63至fa5a716.md`
+- `20251018_需求文档变动说明_v2.0.0至v2.1.0.md`
+- `20251019_需求文档变动说明_HEAD至main.md`
+
+**命名规则**:
+
+- **日期**: 使用8位数字格式（YYYYMMDD），表示变动说明创建日期
+- **功能模块**: 固定为"需求文档变动说明"
+- **变动描述**: 简洁描述本次变动的版本范围，使用commit hash或版本号
+
+### 文档标题格式
+
+**格式**: `[版本号] 需求文档变动说明`
+
+**示例**:
+
+- `v2.1.0 需求文档变动说明`
+- `v2.0.0至v2.1.0 需求文档变动说明`
+- `90cad63至fa5a716 需求文档变动说明`
+
+## 使用建议
+
+### 模板使用原则
+
+1. **统一标准**: 所有需求变动说明都使用统一模板，确保文档格式一致性
+2. **灵活应用**: 根据变动特点选择适用的子章节，不适用的章节使用 `*略*` 标记
+3. **内容完整**: 确保所有必填章节都有实质性内容
+4. **格式规范**: 严格按照模板的格式要求填写内容
+
+### 模板定制
+
+- 可根据项目特点调整模板结构
+- 可添加项目特定的字段和检查项
+- 可结合团队工作流程优化模板
+
+## 版本管理
+
+- 模板版本号格式: v主版本.次版本
+- 重大变更升级主版本号
+- 小幅调整升级次版本号
+- 保持向后兼容性
+
+## 反馈建议
+
+如有模板改进建议，请通过以下方式反馈：
+
+- 提交Issue到项目仓库
+- 发送邮件给文档维护者
+- 在团队会议中讨论
+
+---
+
+## AI Agent 执行总结
+
+**核心原则**: 严格按照模板结构执行，不添加、不删除、不修改模板定义的章节结构。
+
+**执行步骤**:
+
+1. 逐章节填写内容，替换所有占位符
+2. 根据变动特点选择适用的子章节，不适用的使用 `*略*` 标记
+3. 处理条件内容和可选内容
+4. 进行质量检查，确保符合所有要求
+
+**关键提醒**:
+
+- 模板是标准化的文档结构，任何偏离都会影响文档的一致性和可读性
+- 专注于内容质量，而非结构创新
+- 如有疑问，优先遵循模板而非添加额外说明
+
+---
+
+**最后更新**: 2025-10-17
+**维护者**: 需求文档管理团队

package/skills/aipk_requirements/changes/template/index.md

@@ -0,0 +1,30 @@
+# 需求变动说明索引（模板）
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | {{版本号}} |
+| 状态 | {{状态: 草稿/审核中/已批准}} |
+| 负责人 | {{负责人}} |
+| 里程碑 | {{里程碑}} |
+
+---
+
+## 需求变动说明
+
+| 变动说明名称 | 文件路径 | 版本范围 | 状态 |
+|-------------|----------|----------|------|
+| {{变动说明名称}} | ./{{YYYYMMDD}}_需求文档变动说明_{{旧commit}}至{{新commit}}.md | {{版本范围}} | {{状态}} |
+| {{变动说明名称}} | ./{{YYYYMMDD}}_需求文档变动说明_{{旧commit}}至{{新commit}}.md | {{版本范围}} | {{状态}} |
+| {{变动说明名称}} | ./{{YYYYMMDD}}_需求文档变动说明_{{旧commit}}至{{新commit}}.md | {{版本范围}} | {{状态}} |
+
+> 提示：对应文档应基于 `./需求变动说明文档模板.md` 生成，文档标题使用 `[版本号] 需求文档变动说明` 格式。
+
+---
+
+## 备注
+
+- 文件命名：`YYYYMMDD_需求文档变动说明_旧commit至新commit.md`
+- 文档标题：使用 `[版本号] 需求文档变动说明` 格式，落地时替换为具体的版本信息
+- 表格可按需增删行；未涉及的条目可留空或删除