@zzp123/mcp-zentao 1.8.3 → 1.8.5

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.5] - 2025-11-06
+
+### Improved
+- **优化 changeStory 工具参数说明**
+  - 为 `reviewer` 字段添加详细描述：说明其通常为必填字段，除非设置 `needNotReview=true` 跳过评审
+  - 为 `needNotReview` 字段添加说明：如果不提供 `reviewer` 则应设置为 `true`
+  - 为 `storyId` 参数添加描述，提升工具可读性
+  - 为工具本身添加整体说明："需求变更 - 支持对象或JSON字符串格式"
+
+### Technical
+- 改进 MCP 工具的参数描述，帮助 AI 助手更好地理解参数使用规则
+- 提升工具在 Claude Code 等 AI IDE 中的可用性
+
 ## [1.8.0] - 2025-11-06
 
 ### Changed

package/dist/api/zentaoApi.d.ts

@@ -45,16 +45,10 @@ export declare class ZentaoAPI {
     createPlan(productId: number, plan: CreatePlanRequest): Promise<Plan>;
     getProjects(page?: number, limit?: number): Promise<Project[]>;
     /**
-     * 修改需求（使用"更新需求（无需评审）"接口）
+     * 修改需求（使用 PUT /stories/:id 接口）
      *
-     * 此方法使用自定义接口 POST /stories/:id/update-without-review
-     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
-     *
-     * 适用场景：
-     * - 系统配置了强制评审，但某些自动化场景不需要评审
-     * - API调用更新需求时无法提供评审人员
-     * - 批量导入或同步需求数据时
-     * - 第三方系统集成时自动更新需求
+     * 此方法使用标准的"修改需求其他字段"接口（PUT），支持修改29个字段
+     * 自动处理评审人问题，避免"该研发需求需要评审，评审人员不能为空"的错误
      *
      * @param storyId 需求ID
      * @param update 需要更新的字段

package/dist/api/zentaoApi.js

@@ -607,16 +607,10 @@ export class ZentaoAPI {
         }
     }
     /**
-     * 修改需求（使用"更新需求（无需评审）"接口）
+     * 修改需求（使用 PUT /stories/:id 接口）
      *
-     * 此方法使用自定义接口 POST /stories/:id/update-without-review
-     * 该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误
-     *
-     * 适用场景：
-     * - 系统配置了强制评审，但某些自动化场景不需要评审
-     * - API调用更新需求时无法提供评审人员
-     * - 批量导入或同步需求数据时
-     * - 第三方系统集成时自动更新需求
+     * 此方法使用标准的"修改需求其他字段"接口（PUT），支持修改29个字段
+     * 自动处理评审人问题，避免"该研发需求需要评审，评审人员不能为空"的错误
      *
      * @param storyId 需求ID
      * @param update 需要更新的字段
@@ -624,10 +618,16 @@ export class ZentaoAPI {
      */
     async changeStory(storyId, update) {
         try {
-            console.log(`正在更新需求 ${storyId} (使用无需评审接口)...`);
-            // 使用 POST /stories/:id/update-without-review 接口
-            // 该接口会自动将当前用户设置为评审人员，绕过评审验证
-            const response = await this.request('POST', `/stories/${storyId}/update-without-review`, undefined, update);
+            console.log(`正在更新需求 ${storyId}...`);
+            // 自动处理评审人问题
+            const updateData = { ...update };
+            // 如果用户没有设置评审人，也没有指定无需评审，则自动跳过评审
+            if (!updateData.reviewer && updateData.needNotReview !== true) {
+                updateData.needNotReview = true;
+                console.log('自动设置needNotReview=true以跳过评审要求');
+            }
+            // 使用 PUT /stories/:id 接口
+            const response = await this.request('PUT', `/stories/${storyId}`, undefined, updateData);
             console.log('更新需求响应:', response);
             return response;
         }

package/dist/index.js

@@ -535,8 +535,8 @@ server.tool("getProjects", {
     };
 });
 // Add changeStory tool
-server.tool("changeStory", {
-    storyId: z.number(),
+server.tool("changeStory", "需求变更 - 支持对象或JSON字符串格式", {
+    storyId: z.number().describe("需求ID"),
     update: z.union([
         z.object({
             // 基本信息
@@ -563,7 +563,7 @@ server.tool("changeStory", {
             grade: z.number().optional(),
             // 人员相关
             mailto: z.array(z.string()).optional(),
-            reviewer: z.array(z.string()).optional(),
+            reviewer: z.array(z.string()).optional().describe("评审人员列表（通常为必填，除非设置needNotReview=true跳过评审）"),
             assignedTo: z.string().optional(),
             closedBy: z.string().optional(),
             feedbackBy: z.string().optional(),
@@ -571,7 +571,7 @@ server.tool("changeStory", {
             closedReason: z.enum(['done', 'subdivided', 'duplicate', 'postponed', 'willnotdo', 'cancel', 'bydesign']).optional(),
             duplicateStory: z.number().optional(),
             // 评审相关
-            needNotReview: z.boolean().optional(),
+            needNotReview: z.boolean().optional().describe("是否跳过评审，如果不提供reviewer则应设置为true"),
             // 通知相关
             notifyEmail: z.string().optional(),
             // 描述内容
@@ -581,16 +581,10 @@ server.tool("changeStory", {
             comment: z.string().optional()
         }),
         z.string()
-    ]).describe(`更新需求（无需评审）
-
-此工具使用自定义接口 POST /stories/:id/update-without-review
-该接口会自动绕过评审人员验证，避免"该研发需求需要评审，评审人员不能为空"的错误。
+    ]).describe(`更新需求（使用 PUT 接口）
 
-适用场景：
-- 系统配置了强制评审，但某些自动化场景不需要评审
-- API调用更新需求时无法提供评审人员
-- 批量导入或同步需求数据时
-- 第三方系统集成时自动更新需求
+此工具使用标准的"修改需求其他字段"接口（PUT /stories/:id），支持修改29个字段。
+自动处理评审人问题，无需手动设置 needNotReview。
 
 支持对象或JSON字符串格式。
         `.trim())

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zzp123/mcp-zentao",
-    "version": "1.8.3",
+    "version": "1.8.5",
     "description": "禅道项目管理系统的高级API集成包，提供任务管理、Bug跟踪等功能的完整封装，专为Cursor IDE设计的MCP扩展",
     "main": "dist/index.js",
     "type": "module",