ZenTao Skill：禅道项目管理系统的高效集成工具

在项目管理的日常工作中，禅道（ZenTao）作为一款广受欢迎的开源项目管理系统，被众多团队用于任务管理、Bug 追踪、项目协作等场景。但在实际使用中，我们常常需要通过自动化的方式来对接禅道的功能，提升工作效率。今天要介绍的ZenTao Skill就是这样一款工具，它为禅道 18.x + 版本提供了完整的 RESTful API 集成支持，帮助我们轻松实现禅道功能的自动化调用。

项目介绍

ZenTao Skill 是一个基于 easysoft/go-zentao SDK 开发的禅道集成工具，专门为禅道开源版 18.5 及以上版本设计，支持禅道所有主要模块的操作，包括任务管理、Bug 管理、项目管理等。通过这个工具，我们可以通过命令行或者自定义代码的方式，与禅道的 RESTful API 进行交互，实现项目管理任务的自动化。

配置说明

在使用 ZenTao Skill 之前，我们需要先进行简单的配置，创建一个config.json文件，用于存储禅道服务器的连接信息：

{
  "url": "http://your-zentao-url",
  "username": "your-username",
  "password": "your-password"
}

将这个文件放在 ZenTao Skill 的根目录下，就可以完成基础的配置，工具会通过这个文件的信息连接到你的禅道服务器。

使用示例

ZenTao Skill 在go-zentao/example/目录中提供了多个可直接运行的示例程序，覆盖了任务管理、Bug 管理等常见场景，下面我们来详细介绍这些示例的使用方法。

任务管理示例

任务管理示例位于go-zentao/example/tasks/目录下，这个示例可以帮助我们完成任务的查询、创建和状态操作。

任务查询

我们可以通过不同的参数来筛选任务：

• 查看所有任务：

cd go-zentao/example/tasks && go run main.go

• 只查看未完成的任务（wait/doing 状态）：

cd go-zentao/example/tasks && go run main.go -incomplete

• 按状态筛选任务：

cd go-zentao/example/tasks && go run main.go -status doing

• 按优先级筛选任务（优先级 1-4）：

cd go-zentao/example/tasks && go run main.go -priority 3

• 按项目 ID 筛选任务：

cd go-zentao/example/tasks && go run main.go -project 20

• 查看帮助信息：

cd go-zentao/example/tasks && go run main.go -h

创建任务

我们可以通过以下命令创建新的任务：

cd go-zentao/example/tasks && go run main.go -create 24 -name "实现登录功能" -pri 2 -estimate 8

其中-create参数指定要在哪个执行中创建任务，-name是任务名称，-pri是任务优先级，-estimate是预估的工作时长。

任务状态操作

我们可以对任务进行多种状态操作：

• 开始任务：

cd go-zentao/example/tasks && go run main.go -start 123 -comment "开始工作"

• 完成任务：

cd go-zentao/example/tasks && go run main.go -finish 123 -consumed 8 -comment "任务完成"

• 暂停任务：

cd go-zentao/example/tasks && go run main.go -pause 123

• 继续任务：

cd go-zentao/example/tasks && go run main.go -continue 123

• 关闭任务：

cd go-zentao/example/tasks && go run main.go -close 123

Bug 管理示例

Bug 管理示例位于go-zentao/example/bugs/目录下，这个示例可以帮助我们查询和确认 Bug。

查询 Bug

我们可以通过以下命令查看分配给当前用户的所有 Bug：

cd go-zentao/example/bugs && go run main.go

这个命令会按产品组织 Bug，并显示 Bug 的 ID、标题、状态、严重程度、优先级等详细信息。

确认 Bug

我们可以通过以下命令确认指定的 Bug，并更新 Bug 的信息：

cd go-zentao/example/bugs && go run main.go -confirm 456 -pri 1 -type codeerror -status active -assignedTo tx

其中-confirm参数指定要确认的 Bug ID，-pri是优先级，-type是 Bug 类型，-status是 Bug 状态，-assignedTo是分配的用户。

功能特点

1. 完整的模块支持：支持禅道的所有主要模块，包括任务、Bug、项目、执行、产品等。

2. 灵活的筛选功能：提供了丰富的筛选参数，可以根据状态、优先级、项目等条件快速筛选数据。

3. 基于官方 SDK：使用禅道官方的easysoft/go-zentao SDK，保证了 API 交互的稳定性和兼容性。

4. 命令行友好：提供了简洁的命令行接口，方便我们快速执行操作，也可以集成到自动化脚本中。

5. 支持 Token 认证：推荐使用基于 Token 的认证方式，相比会话认证更加安全和稳定。

注意事项

1. 权限要求：确保你的禅道用户具有适当的权限，否则可能无法执行某些操作。

2. 版本兼容性：这个工具适用于禅道 18.x 及以上版本，使用前请确认你的禅道版本是否符合要求。

3. 开源版限制：某些功能可能在禅道开源版本中不可用，具体可以参考禅道的官方 API 文档。

4. 认证方式：推荐使用 Token 认证，相比会话认证更加安全，也更适合自动化场景。

总结

ZenTao Skill 是一个非常实用的禅道集成工具，它可以帮助我们轻松实现禅道功能的自动化调用，提升项目管理的效率。无论是日常的任务管理、Bug 追踪，还是自动化的项目集成，这个工具都能为我们提供有力的支持。如果你正在使用禅道进行项目管理，不妨试试这个工具，相信它会为你的工作带来不少便利。

相关链接：

• 禅道官方 API 文档：https://www.zentao.net/book/api.html

• go-zentao SDK GitHub 仓库：https://github.com/easysoft/go-zentao

• ZenTao Skill 项目仓库：https://github.com/tongxin-77/zentao-skill.git

（注：文档部分内容可能由 AI 生成）