@zzp123/mcp-zentao 1.18.3 → 1.18.5

package/CHANGELOG.md

@@ -5,6 +5,68 @@ 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.18.5] - 2025-01-17
+
+### Fixed
+- **修复角色版本命令缺失问题** 🔧
+  - 添加 `zentao`、`zentao-pm`、`zentao-qa`、`zentao-dev` 四个命令入口
+  - 之前版本只有 `mcp-zentao` 一个命令，导致角色版本无法使用
+  - 现在用户可以根据需要选择不同角色的命令
+
+### Changed
+- 更新 package.json 的 bin 配置，支持所有角色版本命令
+- `zentao` - 完整版（91个工具）
+- `zentao-pm` - 产品经理版（39个工具）
+- `zentao-qa` - 测试工程师版（26个工具）
+- `zentao-dev` - 开发工程师版（38个工具）
+
+### Technical
+- 将 bin 从单一入口改为多入口配置
+- 所有角色版本的编译文件都已包含在发布包中
+
+### Migration
+```bash
+# 现在可以使用不同的命令
+zentao           # 完整版
+zentao-pm        # 产品经理版
+zentao-qa        # 测试工程师版
+zentao-dev       # 开发工程师版
+```
+
+## [1.18.4] - 2025-01-17
+
+### Fixed
+- **修复 MCP stdio 协议污染问题** 🔧
+  - 删除所有 `console.log` / `console.error` / `console.warn` 语句（240+ 处）
+  - MCP stdio 服务器的 stdout 仅用于 JSON-RPC 通信，任何日志输出都会破坏协议
+  - 保留 2 处关键错误输出到 stderr（配置加载失败、MCP 启动失败）
+  - 错误处理通过 `throw Error` 自动传递给 MCP 客户端
+
+### Changed
+- 所有调试日志已移除，不再污染 stdout
+- MCP 服务器启动失败时输出到 stderr 并正确退出
+- 配置文件加载失败时输出到 stderr
+
+### Impact
+- **协议兼容性**: 完全符合 MCP stdio 协议规范
+- **稳定性**: 避免因日志输出导致的协议解析失败
+- **性能**: 减少 I/O 开销，提升响应速度
+- **代码量**: 删除约 240 行日志代码
+
+### Technical
+- 清理 `src/api/zentaoApi.ts` 中的 176 处日志
+- 清理 `src/index.ts` 中的 91 处日志
+- 清理 `src/index-dev.ts` 中的 38 处日志
+- 清理 `src/index-pm.ts` 中的 39 处日志
+- 清理 `src/index-qa.ts` 中的 26 处日志
+- 优化 `src/config.ts` 的错误输出到 stderr
+- 保留关键启动错误处理，输出格式：`[FATAL]` / `[ERROR]`
+
+### Migration
+- 无需用户操作，升级后自动生效
+- 错误信息会通过 MCP 客户端（Claude Desktop）正确显示
+- 开发调试推荐使用官方 MCP Inspector 工具
+
 ## [1.18.3] - 2025-01-12
 
 ### Fixed

package/README.md

@@ -79,6 +79,45 @@ npm install @zzp123/mcp-zentao -g
 - ✅ 文件上传
 </details>
 
+## 🎯 Claude Code Skills
+
+**新功能！** 现在提供 Claude Code Skills 支持，让你通过自然语言更便捷地使用禅道功能。
+
+### 什么是 Skills？
+
+Skills 是 Claude Code 的功能扩展，通过它你可以：
+- 用自然语言描述需求，无需记住命令
+- 智能化的任务管理和状态更新
+- 更友好的交互体验
+
+### 可用的 Skills
+
+目前提供以下 Skills：
+
+| Skill | 适用角色 | 功能 | 文档 |
+|-------|---------|-----|------|
+| **zentao-dev** | 开发工程师 | 任务管理、Bug解决、项目管理 | [文档](./.claude/skills/zentao-dev/) |
+
+### 如何使用 Skills？
+
+1. **安装 MCP 服务器**（如果还没安装）：
+   ```bash
+   npm install -g @zzp123/mcp-zentao
+   ```
+
+2. **配置 Claude Desktop**（参考下方 MCP 配置）
+
+3. **在 Claude Code 中使用**：
+   ```
+   你：查看我今天的任务
+   AI：[显示任务列表]
+
+   你：开始处理任务 #123
+   AI：✓ 任务已更新为"进行中"状态
+   ```
+
+详细使用指南请查看 [Skills 文档](./.claude/skills/zentao-dev/README.md)
+
 ## 📋 版本历史
 
 查看完整的版本更新历史，请访问 [CHANGELOG.md](./CHANGELOG.md)