@guru-ai-product/ai-product-kit 0.2.251117163427 → 0.2.251117191453

package/skills/aipk_requirements/SKILL.md

@@ -1,243 +0,0 @@
----
-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/review/SKILL.md

@@ -1,218 +0,0 @@
----
-name: requirements-review
-description: AI-assisted review workflow for validating requirement documents against quality and risk criteria.
----
-
-# 需求评审
-
-## 概述
-
-本指南专门用于指导如何使用 AI 工具进行需求文档评审，基于《需求文档》中的评审章节，提供标准化的 AI 评审流程和检查清单。
-
-## 第一部分：AI 需求评审 Prompt 模板
-
-### AI 角色设定与评审框架
-
-```
-你是一位资深产品经理，拥有丰富的产品需求分析和评审经验。请基于提供的需求文档，从以下维度进行全面分析和评审：
-
-**评审维度：**
-
-1. **清晰性评审**
-   - 语言表述是否简洁明了，避免模糊和歧义
-   - 术语使用是否标准化和一致
-   - 是否提供了具体的例子和场景说明
-
-2. **完整性评审**
-   - 是否覆盖了所有必要的产品方面
-   - 边界条件和异常情况是否充分考虑
-   - 约束和限制是否明确说明
-
-3. **可验证性评审**
-   - 需求是否可测试和可量化
-   - 验收标准是否明确具体
-   - 是否避免了主观和无法量化的描述
-
-4. **一致性评审**
-   - 文档内部逻辑是否一致
-   - 与其他产品文档是否保持一致
-   - 格式和模板使用是否统一
-
-5. **风险评估**
-   - 识别潜在的技术风险和业务风险
-   - 评估需求的可行性和实现难度
-   - 分析需求之间是否存在冲突或矛盾
-
-**评审输出要求：**
-
-请按照以下结构提供评审结果：
-
-### 总体评价
-- 文档质量等级：[优秀/良好/需改进/不合格]
-- 核心问题摘要
-
-### 详细评审结果
-
-#### 1. 清晰性问题
-- [具体问题描述]
-- [改进建议]
-
-#### 2. 完整性问题
-- [具体问题描述]
-- [改进建议]
-
-#### 3. 可验证性问题
-- [具体问题描述]
-- [改进建议]
-
-#### 4. 一致性问题
-- [具体问题描述]
-- [改进建议]
-
-#### 5. 风险识别
-- [技术风险]
-- [业务风险]
-- [风险缓解建议]
-
-### 优先级建议
-- 必须修改：[高优先级问题列表]
-- 建议修改：[中优先级问题列表]
-- 可选优化：[低优先级问题列表]
-
-### 后续行动建议
-- [具体的改进步骤和建议]
-
----
-
-**请基于以上框架，对以下需求文档进行评审：**
-
-[在此处粘贴需求文档内容]
-```
-
-## 第二部分：需求评审 Checklist
-
-### 基础质量检查
-
-#### 文档结构与格式
-
-- [ ] 文档标题、版本、作者等基本信息完整
-- [ ] 文档结构清晰，章节划分合理
-- [ ] 使用统一的格式和模板
-- [ ] 术语表完整且标准化
-
-#### 产品战略一致性
-
-- [ ] 需求是否符合产品目标和策略？
-- [ ] 与产品愿景和核心价值主张是否一致？
-- [ ] 目标用户定义是否清晰准确？
-
-### 需求质量检查
-
-#### 清晰性检查
-
-- [ ] 需求是否清晰、具体且无歧义？
-- [ ] 语言表述是否简洁明了？
-- [ ] 是否提供了具体的例子和场景？
-- [ ] 术语使用是否一致和标准化？
-
-#### 完整性检查
-
-- [ ] 是否所有必要的功能都已包含？
-- [ ] 边界条件和异常情况是否充分考虑？
-- [ ] 约束和限制是否明确说明？
-- [ ] 非功能需求是否充分定义？
-
-#### 可验证性检查
-
-- [ ] 需求是否可测试和可量化？
-- [ ] 验收标准是否明确具体？
-- [ ] 是否避免了主观和无法量化的描述？
-- [ ] 成功指标是否可衡量？
-
-#### 一致性检查
-
-- [ ] 需求之间是否存在冲突或矛盾？
-- [ ] 文档内部逻辑是否一致？
-- [ ] 与其他产品文档是否保持一致？
-- [ ] 优先级设置是否合理？
-
-### 可行性与风险评估
-
-#### 技术可行性
-
-- [ ] 需求是否可实现且符合技术约束？
-- [ ] 技术依赖是否明确识别？
-- [ ] 性能要求是否现实可达？
-- [ ] 安全和隐私要求是否充分考虑？
-
-#### 业务可行性
-
-- [ ] 优先级是否合理设置？
-- [ ] 资源需求是否现实？
-- [ ] 时间计划是否可行？
-- [ ] 成本效益是否合理？
-
-#### 风险识别
-
-- [ ] 是否识别了主要技术风险？
-- [ ] 是否识别了主要业务风险？
-- [ ] 是否提供了风险缓解措施？
-- [ ] 依赖关系是否清晰标识？
-
-### 用户体验检查
-
-#### 用户需求匹配
-
-- [ ] 是否真正解决了用户痛点？
-- [ ] 用户场景描述是否完整？
-- [ ] 用户流程是否合理顺畅？
-- [ ] 是否考虑了不同用户角色的需求？
-
-#### 交互设计
-
-- [ ] 用户界面要求是否明确？
-- [ ] 交互流程是否清晰？
-- [ ] 可用性要求是否充分？
-- [ ] 无障碍访问是否考虑？
-
-### 评审流程检查
-
-#### 利益相关者参与
-
-- [ ] 是否邀请了所有必要的利益相关者？
-- [ ] 产品、设计、开发、测试团队是否都参与？
-- [ ] 业务利益相关者是否参与？
-- [ ] 用户代表是否参与（如可能）？
-
-#### 评审记录
-
-- [ ] 评审意见是否完整记录？
-- [ ] 问题和建议是否明确分类？
-- [ ] 后续行动计划是否制定？
-- [ ] 责任人和时间节点是否明确？
-
-### 最终确认
-
-#### 质量标准
-
-- [ ] 文档是否达到发布标准？
-- [ ] 所有关键问题是否已解决？
-- [ ] 利益相关者是否达成共识？
-- [ ] 是否获得必要的批准？
-
-#### 后续计划
-
-- [ ] 变更管理流程是否建立？
-- [ ] 文档维护责任是否明确？
-- [ ] 后续评审计划是否制定？
-- [ ] 实施跟踪机制是否建立？
-
----
-
-**使用说明：**
-
-1. 在评审过程中逐项检查上述清单
-2. 对于未通过的项目，记录具体问题和改进建议
-3. 根据问题严重程度设定优先级
-4. 制定具体的改进行动计划
-5. 跟踪问题解决进度直至评审通过