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

package/README.md

@@ -18,9 +18,9 @@ ROOT/
 │   ├── 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/                        # Archived automation service source, documentation, and tests
+├── 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/                      # Release automation such as `publish-package.sh`
+├── 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
@@ -53,41 +53,41 @@ ROOT/
 
 ## 🛠️ Usage Guide
 
-### 1. 📦 Installation
+AI Product Kit provides two ways to access its capabilities: **Traditional Skills** and **MCP (Model Context Protocol) Server**.
 
-First-time setup - install AI Product Kit:
+### 🔍 Choosing Between Skills and MCP
 
-```bash
-# Run from your project root directory
-npx @guru-ai-product/ai-product-kit@latest ai-product-kit
-```
+| Method | Best For | How It Works |
+|--------|----------|--------------|
+| **Skills** | Full project lifecycle, document templating, collaborative workflows, and IDE/CLI agents that operate inside your repository (Cursor, Codex, Claude Code, Gemini CLI) | Downloads skill bundles to `.claude/skills/` directory for agent access |
+| **MCP** | Real-time skill queries, programmatic access, tool integration, and agents that run outside the project workspace (e.g., Cherry Studio) | Runs a server that provides skills as tools via Model Context Protocol |
+
+> Choose **one** mode per project. Do not copy both templates or mix the automation blocks.
+
+### 📋 Using Skills (Traditional Method)
 
-This downloads the Skill bundle (templates, scripts, and `GURU_AI.md` files) to your working tree.
+Skills provide templates, checklists, and guidance for each phase of the product lifecycle. They are downloaded to your local project and accessed by agents through the file system.
 
-### 2. 🔄 Update
+#### 1. 📦 Installation & Update
 
-Get the latest version when updates are available:
+First-time setup or update to the latest version:
 
 ```bash
-# Run from your project root directory
+# Install or update Skills from your project root directory
 npx @guru-ai-product/ai-product-kit@latest ai-product-kit
 ```
 
-This downloads the newest Skill bundle (templates, scripts, and `GURU_AI.md` files) to your working tree.
+This downloads the Skill bundle (templates, scripts, and `GURU_AI.md` files) to `.claude/skills/` in your working tree.
 
-### 3. 🚀 Initialization
-
-Initialize your project with the init-project Skill:
+#### 2. 🚀 Initialize Your Project (Skills Mode)
 
 ```text
-init project based on ./.claude/skills/aipk_init_project
+Initialize my project in SKILLS mode using ./.claude/skills/aipk_init_project.
 ```
 
-This sets up your project with the canonical workflow and all necessary documentation templates.
-
-### 4. 📋 Using Skills
+#### 3. 📋 Using Skills
 
-After initialization, you can use any Skill to accelerate your workflow:
+After initialization, use any Skill to accelerate your workflow:
 
 ```text
 Please write a PRD for feature X using the AI Product Kit template
@@ -95,9 +95,98 @@ Please write a PRD for feature X using the AI Product Kit template
 
 Each Skill provides specific templates, checklists, and guidance for that phase of the product lifecycle.
 
-## 🚀 Quick Start
+### ⚡ Using MCP Server
+
+The MCP Server makes AI Product Kit skills available as tools through the Model Context Protocol. Configure your preferred MCP client to connect to the server.
+
+#### 1. 🔧 Configure MCP Client
+
+Add this configuration to your MCP client so you can access AI Product Kit skills:
+
+##### Option A: Using npx (Recommended)
+
+**Codex CLI** – add the entry below to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.ai_product_kit]
+command = "npx"
+args = ["-y", "@guru-ai-product/ai-product-kit@latest", "ai-product-kit-mcp"]
+timeout = 60
+```
+
+**Cursor IDE** – add to your settings.json or via GUI:
+
+```json
+{
+  "mcpServers": {
+    "ai-product-kit": {
+      "command": "npx",
+      "args": ["-y", "@guru-ai-product/ai-product-kit@latest", "ai-product-kit-mcp"]
+    }
+  }
+}
+```
+
+**Other MCP Clients** – use the same pattern:
+- Command: `npx`
+- Arguments: `["-y", "@guru-ai-product/ai-product-kit@latest", "ai-product-kit-mcp"]`
+
+##### Option B: Using Local Installation
+
+If you install the package locally:
+
+```bash
+npm install @guru-ai-product/ai-product-kit
+```
+
+Then configure with:
+
+```json
+{
+  "mcpServers": {
+    "ai-product-kit": {
+      "command": "./node_modules/.bin/ai-product-kit-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+#### 3. 🛠️ Available Tools
+
+Once configured, the MCP Server provides the `product_kit_skill` tool:
+
+- **Tool Name**: `product_kit_skill`
+- **Purpose**: Retrieve any AI Product Kit skill guide or template
+- **Parameters**:
+  - `skill_name` (string, required) - Name of the skill to retrieve (e.g., `aipk_requirements`)
+
+The tool returns:
+- `skill_name`: The requested skill name
+- `description`: Skill description from the SKILL.md file
+- `cache_path`: Absolute path to cached content (for subsequent reading)
+
+#### 4. 🚀 Initialize Your Project with MCP
+
+```text
+Initialize my project in MCP mode.
+Use the product_kit_skill tool
+```
+
+#### 5. 📚 Supported Skills
+
+All AI Product Kit skills are available via MCP:
+- `aipk_init_project` - Project bootstrapping
+- `aipk_requirements` - Requirements discovery and documentation
+- `aipk_design` - Design workflows and automation
+- `aipk_development` - Engineering playbooks
+- `aipk_operations` - Post-launch operations
+- `aipk_skill_generate` - Skill creation standards
+- `aipk_tool_prompts` - Reusable AI prompt catalog
+
+### 🚀 Quick Start
 
-Agents already know where each Skill lives because the mappings are declared in `AGENTS.md`. Use prompts like these to get moving quickly:
+Agents already know where each Skill lives because the mappings are declared in `AGENTS.md`. Use prompts like these:
 
 1.
 
@@ -108,7 +197,7 @@ Agents already know where each Skill lives because the mappings are declared in
 2.
 
    ```text
-   Review the current launch checklist and tell me what’s missing for the beta cut.
+   Review the current launch checklist and tell me what's missing for the beta cut.
    ```
 
 3.
@@ -123,11 +212,11 @@ Agents already know where each Skill lives because the mappings are declared in
 2. **Execute the script** – from `ROOT` run:
 
    ```bash
-   tools/publish-package.sh --version <version>
+   node tools/build_package publish --version <version>
    ```
 
-   Optionally pass `--tag beta` or `--dry-run`; the script performs the necessary validations (auth checks, `npm pack --dry-run`, Skill sync) before publishing.
-3. **Follow the prompts** – the script syncs Skills, runs `npm pack --dry-run`, and then publishes with `npm publish --access public`.
+   Optionally pass `--tag beta` or `--dry-run`; the script performs the necessary validations (auth checks, `npm pack --dry-run`, Skill + MCP sync) before publishing.
+3. **Follow the prompts** – the script regenerates the MCP server & `MCP Skill Invocation` tables, syncs filesystem Skills, runs `npm pack --dry-run`, and then publishes with `npm publish --access public`.
 
 > Ensure you have the necessary permissions on the npm org before running the script.
 

package/bin/mcp-server.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+/**
+ * AI Product Kit MCP Server 启动脚本
+ * 用于启动 Model Context Protocol Server
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+// 获取项目根目录
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+const MCP_SERVER_PATH = path.join(PROJECT_ROOT, 'mcp', 'src', 'server.js');
+
+console.log('Starting AI Product Kit MCP Server...');
+console.log(`Server path: ${MCP_SERVER_PATH}\n`);
+
+// 启动 MCP Server
+const server = spawn('node', [MCP_SERVER_PATH], {
+  stdio: 'inherit',
+  cwd: path.join(PROJECT_ROOT, 'mcp', 'src')
+});
+
+// 处理退出事件
+server.on('close', (code) => {
+  if (code !== 0) {
+    console.error(`\nMCP Server exited with code ${code}`);
+    process.exit(code);
+  }
+});
+
+server.on('error', (err) => {
+  console.error('Failed to start MCP Server:', err.message);
+  process.exit(1);
+});
+
+// 优雅退出
+process.on('SIGINT', () => {
+  console.log('\nShutting down MCP Server...');
+  server.kill('SIGINT');
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  console.log('\nShutting down MCP Server...');
+  server.kill('SIGTERM');
+  process.exit(0);
+});

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. **风险清单**：风险识别和应对措施
+
+### 技术建议
+- 推荐的技术方案和实施路径
+- 技术架构设计建议
+- 团队技能提升建议
+- 项目实施时间规划
+
+## 关键评估指标
+- **技术成熟度**：技术稳定性和社区支持度
+- **开发效率**：开发速度和代码质量
+- **系统性能**：响应时间、吞吐量、资源利用率
+- **可维护性**：代码可读性、模块化程度、文档完整性
+- **可扩展性**：水平扩展能力、垂直扩展潜力
+
+## 技术调研要点
+### 核心技术调研
+- 主流框架和库的特性对比
+- 数据库选型和性能基准测试
+- 部署方案和运维工具评估
+
+### 生态系统分析
+- 技术社区活跃度和支持情况
+- 第三方工具和插件生态
+- 长期技术发展趋势分析