mcp-probe-kit 2.3.0 → 2.3.1

package/build/tools/add_feature.js

@@ -62,38 +62,27 @@ const PROMPT_TEMPLATE = `# 添加新功能指南
 
 **功能描述**: {description}
 
-**输出文件**:
-- \`{docs_dir}/specs/{feature_name}/requirements.md\` - 需求文档
-- \`{docs_dir}/specs/{feature_name}/design.md\` - 设计文档
-- \`{docs_dir}/specs/{feature_name}/tasks.md\` - 任务清单
-
 ---
 
 ## 📋 前置检查
 
-### 步骤 1: 检查项目上下文
+### 检查项目上下文
 
-**操作**:
 1. 检查文件 \`{docs_dir}/project-context.md\` 是否存在
-2. 如果存在：
-   - 读取文件内容
-   - 提取技术栈、架构模式、编码规范等信息
-   - 在后续文档生成中参考这些信息
-3. 如果不存在：
-   - 显示提示："建议先运行 init_project_context 工具生成项目上下文"
-   - 可以继续生成文档，但内容会更通用
+2. 如果存在，读取并参考其中的技术栈、架构模式、编码规范
+3. 如果不存在，建议先运行 \`init_project_context\` 工具
+
+---
 
-### 步骤 2: 创建目录
+## 📝 创建文档
 
-**操作**:
-1. 创建目录 \`{docs_dir}/specs/{feature_name}/\`
-2. 如果目录已存在，询问用户是否覆盖
+请在 \`{docs_dir}/specs/{feature_name}/\` 目录下创建以下三个文件：
 
----
+### 文件 1: requirements.md
 
-## 📝 生成 requirements.md
+**文件路径**: \`{docs_dir}/specs/{feature_name}/requirements.md\`
 
-在 \`{docs_dir}/specs/{feature_name}/requirements.md\` 中生成以下内容：
+**文件内容**（请将以下模板保存为该文件，并根据功能描述智能填充标记为 [填写] 的部分）:
 
 \`\`\`markdown
 # 需求文档：{feature_name}
@@ -104,33 +93,33 @@ const PROMPT_TEMPLATE = `# 添加新功能指南
 
 ## 术语定义
 
-- **[术语1]**: [定义]
-- **[术语2]**: [定义]
+- **[术语1]**: [填写：定义]
+- **[术语2]**: [填写：定义]
 
 ---
 
 ## 需求列表
 
-### 需求 1: [需求标题]
+### 需求 1: [填写：需求标题]
 
-**用户故事:** 作为 [角色]，我想要 [功能]，以便 [目标]。
+**用户故事:** 作为 [填写：角色]，我想要 [填写：功能]，以便 [填写：目标]。
 
 #### 验收标准
 
-1. WHEN [触发条件] THEN 系统 SHALL [响应]
-2. WHILE [状态条件] THE 系统 SHALL [响应]
-3. IF [异常条件] THEN 系统 SHALL [处理方式]
+1. WHEN [填写：触发条件] THEN 系统 SHALL [填写：响应]
+2. WHILE [填写：状态条件] THE 系统 SHALL [填写：响应]
+3. IF [填写：异常条件] THEN 系统 SHALL [填写：处理方式]
 
 ---
 
-### 需求 2: [需求标题]
+### 需求 2: [填写：需求标题]
 
-**用户故事:** 作为 [角色]，我想要 [功能]，以便 [目标]。
+**用户故事:** 作为 [填写：角色]，我想要 [填写：功能]，以便 [填写：目标]。
 
 #### 验收标准
 
-1. THE 系统 SHALL [响应]
-2. WHEN [触发条件] THE 系统 SHALL [响应]
+1. THE 系统 SHALL [填写：响应]
+2. WHEN [填写：触发条件] THE 系统 SHALL [填写：响应]
 
 ---
 
@@ -151,19 +140,19 @@ const PROMPT_TEMPLATE = `# 添加新功能指南
 ## 非功能需求
 
 ### 性能要求
-- [性能相关需求]
+- [填写：性能相关需求]
 
 ### 安全要求
-- [安全相关需求]
+- [填写：安全相关需求]
 
 ### 兼容性要求
-- [兼容性相关需求]
+- [填写：兼容性相关需求]
 
 ---
 
 ## 依赖关系
 
-- [列出与其他功能的依赖]
+- [填写：列出与其他功能的依赖]
 
 ---
 
@@ -171,22 +160,13 @@ const PROMPT_TEMPLATE = `# 添加新功能指南
 *创建时间: [当前时间]*
 \`\`\`
 
-### requirements.md 编写指南
-
-1. **功能概述**: 用 2-3 句话描述功能的目的和价值
-2. **术语定义**: 定义文档中使用的专业术语
-3. **需求列表**: 
-   - 每个需求有独立的标题
-   - 包含用户故事（As a... I want... So that...）
-   - 验收标准使用 EARS 格式
-4. **非功能需求**: 性能、安全、兼容性等
-5. **依赖关系**: 与其他功能或模块的依赖
-
 ---
 
-## 📐 生成 design.md
+### 文件 2: design.md
+
+**文件路径**: \`{docs_dir}/specs/{feature_name}/design.md\`
 
-在 \`{docs_dir}/specs/{feature_name}/design.md\` 中生成以下内容：
+**文件内容**（请将以下模板保存为该文件，并根据功能描述和项目上下文智能填充标记为 [填写] 的部分）:
 
 \`\`\`markdown
 # 设计文档：{feature_name}
@@ -205,27 +185,27 @@ const PROMPT_TEMPLATE = `# 添加新功能指南
 
 | 类别 | 选择 | 理由 |
 |------|------|------|
-| [类别] | [技术] | [选择理由] |
+| [填写：类别] | [填写：技术] | [填写：选择理由] |
 
 ### 架构设计
 
-[描述功能的架构设计，参考项目现有架构]
+[填写：描述功能的架构设计，参考项目现有架构]
 
 \\\`\\\`\\\`
-[架构图或流程图，使用 ASCII 或 Mermaid]
+[填写：架构图或流程图，使用 ASCII 或 Mermaid]
 \\\`\\\`\\\`
 
 ---
 
 ## 数据模型
 
-[如果功能涉及数据存储，描述数据模型]
+[填写：如果功能涉及数据存储，描述数据模型]
 
 ### 数据结构
 
 \\\`\\\`\\\`typescript
-interface [ModelName] {
-  [field]: [type];
+interface [填写：ModelName] {
+  [填写：field]: [填写：type];
 }
 \\\`\\\`\\\`
 
@@ -233,32 +213,32 @@ interface [ModelName] {
 
 ## API 设计
 
-[如果功能涉及 API，描述 API 设计]
+[填写：如果功能涉及 API，描述 API 设计]
 
 ### 接口定义
 
 | 方法 | 路径 | 描述 |
 |------|------|------|
-| [GET/POST/...] | [/path] | [描述] |
+| [填写：GET/POST/...] | [填写：/path] | [填写：描述] |
 
 ---
 
 ## 文件结构
 
-[描述功能涉及的文件和目录]
+[填写：描述功能涉及的文件和目录]
 
 \\\`\\\`\\\`
 [项目目录]/
-├── [新增文件1]
-├── [新增文件2]
-└── [修改文件]
+├── [填写：新增文件1]
+├── [填写：新增文件2]
+└── [填写：修改文件]
 \\\`\\\`\\\`
 
 ### 文件说明
 
 | 文件 | 用途 |
 |------|------|
-| [文件路径] | [用途说明] |
+| [填写：文件路径] | [填写：用途说明] |
 
 ---
 
@@ -268,27 +248,27 @@ interface [ModelName] {
 
 | 依赖 | 版本 | 用途 |
 |------|------|------|
-| [依赖名] | [版本] | [用途] |
+| [填写：依赖名] | [填写：版本] | [填写：用途] |
 
 ### 内部依赖
 
-- [列出依赖的内部模块]
+- [填写：列出依赖的内部模块]
 
 ---
 
 ## 设计决策
 
-### 决策 1: [决策标题]
+### 决策 1: [填写：决策标题]
 
-**问题**: [描述面临的问题]
+**问题**: [填写：描述面临的问题]
 
 **选项**:
-1. [选项 A]: [描述]
-2. [选项 B]: [描述]
+1. [填写：选项 A]: [填写：描述]
+2. [填写：选项 B]: [填写：描述]
 
-**决策**: 选择 [选项]
+**决策**: 选择 [填写：选项]
 
-**理由**: [解释选择的理由]
+**理由**: [填写：解释选择的理由]
 
 ---
 
@@ -296,7 +276,7 @@ interface [ModelName] {
 
 | 风险 | 影响 | 缓解措施 |
 |------|------|----------|
-| [风险描述] | [高/中/低] | [缓解措施] |
+| [填写：风险描述] | [填写：高/中/低] | [填写：缓解措施] |
 
 ---
 
@@ -304,20 +284,13 @@ interface [ModelName] {
 *创建时间: [当前时间]*
 \`\`\`
 
-### design.md 编写指南
-
-1. **技术方案**: 基于项目上下文选择合适的技术
-2. **架构设计**: 遵循项目现有的架构模式
-3. **数据模型**: 如果涉及数据，定义清晰的数据结构
-4. **API 设计**: 如果涉及 API，遵循项目的 API 规范
-5. **文件结构**: 遵循项目的目录组织方式
-6. **设计决策**: 记录重要的技术决策和理由
-
 ---
 
-## 📋 生成 tasks.md
+### 文件 3: tasks.md
+
+**文件路径**: \`{docs_dir}/specs/{feature_name}/tasks.md\`
 
-在 \`{docs_dir}/specs/{feature_name}/tasks.md\` 中生成以下内容：
+**文件内容**（请将以下模板保存为该文件，并根据需求和设计智能生成任务清单）:
 
 \`\`\`markdown
 # 任务清单：{feature_name}
@@ -332,42 +305,42 @@ interface [ModelName] {
 
 ### 阶段 1: 准备工作
 
-- [ ] 1.1 [任务标题]
-  - [具体操作说明]
-  - _需求: [对应的需求编号]_
+- [ ] 1.1 [填写：任务标题]
+  - [填写：具体操作说明]
+  - _需求: [填写：对应的需求编号]_
 
-- [ ] 1.2 [任务标题]
-  - [具体操作说明]
-  - _需求: [对应的需求编号]_
+- [ ] 1.2 [填写：任务标题]
+  - [填写：具体操作说明]
+  - _需求: [填写：对应的需求编号]_
 
 ---
 
 ### 阶段 2: 核心实现
 
-- [ ] 2.1 [任务标题]
-  - [具体操作说明]
-  - _需求: [对应的需求编号]_
+- [ ] 2.1 [填写：任务标题]
+  - [填写：具体操作说明]
+  - _需求: [填写：对应的需求编号]_
 
-- [ ] 2.2 [任务标题]
-  - [具体操作说明]
+- [ ] 2.2 [填写：任务标题]
+  - [填写：具体操作说明]
   - 依赖: 任务 2.1
-  - _需求: [对应的需求编号]_
+  - _需求: [填写：对应的需求编号]_
 
 ---
 
 ### 阶段 3: 集成测试
 
-- [ ] 3.1 [任务标题]
-  - [具体操作说明]
-  - _需求: [对应的需求编号]_
+- [ ] 3.1 [填写：任务标题]
+  - [填写：具体操作说明]
+  - _需求: [填写：对应的需求编号]_
 
 ---
 
 ## 检查点
 
-- [ ] 阶段 1 完成后：[验证内容]
-- [ ] 阶段 2 完成后：[验证内容]
-- [ ] 阶段 3 完成后：[验证内容]
+- [ ] 阶段 1 完成后：[填写：验证内容]
+- [ ] 阶段 2 完成后：[填写：验证内容]
+- [ ] 阶段 3 完成后：[填写：验证内容]
 
 ---
 
@@ -375,13 +348,13 @@ interface [ModelName] {
 
 | 文件 | 操作 | 说明 |
 |------|------|------|
-| [文件路径] | 新建/修改 | [说明] |
+| [填写：文件路径] | 新建/修改 | [填写：说明] |
 
 ---
 
 ## 依赖任务
 
-- [列出依赖的其他任务或功能]
+- [填写：列出依赖的其他任务或功能]
 
 ---
 
@@ -389,20 +362,16 @@ interface [ModelName] {
 *创建时间: [当前时间]*
 \`\`\`
 
-### tasks.md 编写指南
-
-1. **任务分阶段**: 按逻辑顺序组织任务
-2. **任务粒度**: 每个任务应在 2-4 小时内完成
-3. **依赖关系**: 明确标注任务之间的依赖
-4. **需求追溯**: 每个任务关联对应的需求
-5. **检查点**: 每个阶段结束后有验证点
-6. **文件清单**: 列出所有涉及的文件变更
-
 ---
 
-## ✅ 检查清单
+## ✅ 完成后检查
+
+**请确认以下文件已创建**:
+- [ ] \`{docs_dir}/specs/{feature_name}/requirements.md\` - 需求文档已创建
+- [ ] \`{docs_dir}/specs/{feature_name}/design.md\` - 设计文档已创建
+- [ ] \`{docs_dir}/specs/{feature_name}/tasks.md\` - 任务清单已创建
 
-生成所有文档后，请验证以下内容：
+**内容质量检查**:
 
 ### requirements.md 检查
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "AI-Powered Development Toolkit - MCP Server with 39 practical tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "type": "module",
   "main": "build/index.js",