@guru-ai-product/ai-product-kit 0.2.251118120602 → 0.2.251118160757

package/README.md

@@ -7,28 +7,12 @@ Looking for the Chinese version? See `README_CN.md`.
 ## 📁 Repository Structure
 
 ```text
-ROOT/
-├── AGENTS.md                   # Single source of truth for agent guardrails and workflow rules
-├── skills/                     # Canonical lifecycle Skills and reusable guides
-│   ├── aipk_init_project/      # Project bootstrap workflow plus AGENTS enforcement scripts
-│   ├── aipk_requirements-intake/ # Research and intake automation workflows
-│   ├── aipk_requirements-documentation/ # PRD drafting and iteration templates
-│   ├── aipk_requirements-changes/ # Change management templates and prompts
-│   ├── aipk_initiative-planning/ # Initiative evaluation and scoping playbooks
-│   ├── aipk_update-requirements-from-design/ # Align requirements to design mockups
-│   ├── aipk_format-requirement-pages-with-design/ # Table-based layout for design+text pages
-│   ├── aipk_aso-new-release/     # ASO content and store asset guidance
-│   ├── aipk_development/         # Engineering playbooks and implementation templates
-│   ├── aipk_skill_generate/      # Standards for creating or extending Skills
-│   └── aipk_tool_prompts/        # Reusable AI prompt blocks referenced by other Skills
-├── docs/                       # Legacy landing pages and shared standards referenced by Skills
-├── mcp/                        # MCP local service (Node, entry `mcp/src/server.js`), documentation, and tests
-├── bin/                        # Distribution-ready CLI entry points (e.g., `ai-product-kit.js`)
-├── tools/                      # Unified build scripts via `tools/build_package`
-├── scripts/                    # Helper utilities invoked by Skills and templates
-├── todos/                      # Working drafts and in-progress notes
-├── test/                       # Automated coverage for CLI helpers and scripts
-└── README*.md                  # Repository entry points (English + Chinese)
+PACKAGE_ROOT/
+├── README.md / README_CN.md    # English / Chinese entry points (this file)
+├── package.json                # NPM package manifest
+├── bin/                        # Distribution-ready CLI entry points
+├── mcp/                        # MCP server implementation + templates
+└── skills/                     # Canonical lifecycle Skills and reusable guides
 ```
 
 **Documentation Standards**: All documentation follows the standards defined in [`docs/guide_writing_standard/SKILL.md`](docs/guide_writing_standard/SKILL.md), covering document structure, content organization, formatting, and template writing guidelines.

package/mcp/.doc_cache/04980c3595edbf2d_SKILL.md

@@ -0,0 +1,218 @@
+---
+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. 跟踪问题解决进度直至评审通过

package/mcp/.doc_cache/04e80f12d73851a2_/346/214/207/345/215/227/346/226/207/346/241/243/346/240/207/345/207/206/346/250/241/346/235/277.md

@@ -0,0 +1,59 @@
+# [文档标题]
+
+## 文档信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | v1.0 |
+| 适用范围 | [目标用户群体] |
+
+## 1. 概述
+
+### 1.1 [工具/流程]价值
+
+[描述核心价值和优势]
+
+### 1.2 适用场景
+
+[说明适用的具体场景]
+
+## 2. [主要内容]
+
+### 2.1 [子章节]
+
+[详细内容]
+
+### 2.2 [子章节]
+
+[详细内容]
+
+## 3. [实操指南]
+
+### 3.1 [操作步骤]
+
+[具体步骤说明]
+
+### 3.2 [最佳实践]
+
+[经验总结和建议]
+
+## 4. 常见问题
+
+### 4.1 [问题分类]
+
+**Q1：[具体问题]**
+A：[解决方案]
+
+## 5. 最佳实践总结
+
+[关键要点和经验总结]
+
+## 6. 附录
+
+### 6.1 [相关资源]
+
+[工具链接、参考资料等]
+
+### 6.2 [参考资料]
+
+[相关文档和学习资源]

package/mcp/.doc_cache/07cc092c31fd7015_/345/267/245/345/205/267/344/275/277/347/224/250/346/214/207/345/215/227/346/250/241/346/235/277.md

@@ -0,0 +1,106 @@
+# [工具名称]使用指南
+
+## 文档信息
+
+| 项目 | 内容 |
+|------|------|
+| 版本号 | v1.0 |
+| 适用范围 | [目标用户群体] |
+
+## 1. 概述
+
+### 1.1 工具价值
+
+[描述工具的核心价值和优势]
+
+### 1.2 适用场景
+
+[说明工具适用的具体场景]
+
+## 2. 工具介绍
+
+### 2.1 核心功能
+
+[详细介绍工具的核心功能]
+
+### 2.2 技术特点
+
+[说明工具的技术特点和优势]
+
+### 2.3 集成架构
+
+[描述工具的集成架构和系统要求]
+
+## 3. 使用流程
+
+### 3.1 完整工作流程
+
+[描述完整的工作流程步骤]
+
+### 3.2 质量控制检查点
+
+[说明质量控制的关键检查点]
+
+## 4. 模板库
+
+### 4.1 [模板类型1]
+
+[提供具体的模板内容]
+
+### 4.2 [模板类型2]
+
+[提供具体的模板内容]
+
+## 5. 实操指南
+
+### 5.1 最佳实践
+
+[总结使用工具的最佳实践]
+
+### 5.2 优化技巧
+
+[提供优化使用效果的技巧]
+
+### 5.3 结果验证方法
+
+[说明如何验证使用结果]
+
+## 6. 案例演示
+
+### 6.1 [案例类型1]
+
+详见：[工具名称]/案例1.md
+
+### 6.2 [案例类型2]
+
+详见：[工具名称]/案例2.md
+
+## 7. 常见问题
+
+### 7.1 [问题分类1]
+
+**Q1：[具体问题]**
+A：[解决方案]
+
+### 7.2 [问题分类2]
+
+**Q1：[具体问题]**
+A：[解决方案]
+
+## 8. 最佳实践总结
+
+[总结关键要点和经验]
+
+## 9. 附录
+
+### 9.1 工具对比表
+
+[提供相关工具的对比分析]
+
+### 9.2 成本预算参考
+
+[提供成本预算的参考信息]
+
+### 9.3 相关资源链接
+
+[提供相关的资源和参考链接]

package/mcp/.doc_cache/09ac9834a831e8b5_/346/212/200/346/234/257/346/226/271/346/241/210/350/257/204/344/274/260/344/270/216/345/217/257/350/241/214/346/200/247/345/210/206/346/236/220/346/250/241/346/235/277.md

@@ -0,0 +1,72 @@
+# 技术方案评估与可行性分析
+
+## 研究目标
+全面评估技术方案的可行性、风险和实施成本，为技术决策提供数据支撑和专业建议。
+
+## 背景信息
+### 技术背景
+- **项目类型**：{PROJECT_TYPE}
+- **技术栈要求**：{TECH_STACK_REQUIREMENTS}
+- **性能指标**：{PERFORMANCE_REQUIREMENTS}
+- **预算约束**：{BUDGET_CONSTRAINTS}
+- **时间限制**：{TIMELINE_CONSTRAINTS}
+
+## 研究范围
+### 核心研究问题
+1. 不同技术方案的优缺点和适用场景是什么？
+2. 各方案的实施难度、开发成本和维护成本如何？
+3. 技术方案的可扩展性和未来发展潜力如何？
+4. 存在哪些技术风险和潜在问题？如何规避？
+
+### 分析维度
+- **技术可行性**：技术成熟度、实现难度、兼容性
+- **成本效益分析**：开发成本、运维成本、ROI 评估
+- **风险评估**：技术风险、时间风险、资源风险
+- **性能评估**：响应时间、并发能力、资源消耗
+
+## 特定分析要求
+### 技术方案对比
+- 对比主流技术方案的架构设计和实现方式
+- 分析各方案在性能、安全性、可维护性方面的差异
+- 评估技术栈的学习曲线和团队适配度
+
+### 实施可行性评估
+- 评估现有团队的技术能力和经验匹配度
+- 分析所需的技术资源和基础设施要求
+- 估算开发周期和里程碑节点
+
+### 风险识别与应对
+- 识别技术实施过程中的关键风险点
+- 分析风险发生的概率和影响程度
+- 制定风险应对策略和备选方案
+
+## 输出要求
+### 技术评估报告
+1. **方案对比矩阵**：多维度技术方案比较表
+2. **可行性分析**：详细的实施可行性评估
+3. **成本预算**：开发和运维成本估算
+4. **风险清单**：风险识别和应对措施
+
+### 技术建议
+- 推荐的技术方案和实施路径
+- 技术架构设计建议
+- 团队技能提升建议
+- 项目实施时间规划
+
+## 关键评估指标
+- **技术成熟度**：技术稳定性和社区支持度
+- **开发效率**：开发速度和代码质量
+- **系统性能**：响应时间、吞吐量、资源利用率
+- **可维护性**：代码可读性、模块化程度、文档完整性
+- **可扩展性**：水平扩展能力、垂直扩展潜力
+
+## 技术调研要点
+### 核心技术调研
+- 主流框架和库的特性对比
+- 数据库选型和性能基准测试
+- 部署方案和运维工具评估
+
+### 生态系统分析
+- 技术社区活跃度和支持情况
+- 第三方工具和插件生态
+- 长期技术发展趋势分析