ZenTao Project Management Skill (禅道-ZenTao 项目管理技能)

首先，感谢禅道团队多年的深耕与付出。没有你们孜孜不倦的耕耘和维护，就没有这款优秀的项目管理工具。禅道作为国内领先的开源项目管理解决方案，帮助无数团队提升了协作效率，这份贡献值得我们致以最诚挚的敬意。🙏

English Version | 英文版 (Primary)
Chinese Version | 中文版 (Below)

🇬🇧 English Version

Quick Start

This skill integrates both legacy ZenTao API and REST API, providing unified project management query interfaces.

Installation

Prerequisites:

• - Python 3.8+
• pip (Python package manager)

Install Dependencies:
CODEBLOCK0

Credentials Configuration

ZenTao API credentials are stored in the TOOLS.md file:

CODEBLOCK1

⚠️ Security Notice: Do not commit API credentials to version control or share them publicly.

Usage Examples

Query Product List
CODEBLOCK2

Query Project List
CODEBLOCK3

Query Stories List
CODEBLOCK4

Query Tasks List
CODEBLOCK5

Query Bugs List
CODEBLOCK6

Create Story (Requires Confirmation)
CODEBLOCK7

Create Task (Requires Confirmation)
CODEBLOCK8

Features

Query Operations (No Confirmation Required)

User

• - Get user list
• Get user info
• Get my personal info

Program

• - Get program list
• Get program info

Product

• - Get product list
• Get product info
• Get product teams
• Get product plans
• Get stories list
• Get bugs list
• Get releases list
• Get test cases list
• Get test tasks list
• Get feedbacks list
• Get tickets list

Project

• - Get projects list
• Get project info
• Get project stories
• Get executions list
• Get builds list

Execution

• - Get executions list
• Get execution info
• Get tasks list
• Get bugs list
• Get builds list

Task

• - Get tasks list
• Get task

Bug

• - Get bug

Build

• - Get build

Test Case

• - Get test case

Test Task

• - Get test task

Feedback

• - Get feedback

Ticket

• - Get ticket

Action Operations (Confirmation Required)

User Management

• - Create user
• Update user info
• Delete user

Program Management

• - Create program
• Update program
• Delete program

Product Management

• - Create product
• Update product
• Delete product
• Create product plan
• Update product plan
• Delete product plan
• Create story
• Update story
• Delete story
• Activate story
• Close story

Project Management

• - Create project
• Update project
• Delete project
• Create build
• Update build
• Delete build

Execution Management

• - Create execution
• Update execution
• Delete execution
• Create task
• Update task
• Delete task

Bug Management

• - Create bug
• Update bug
• Delete bug

Test Management

• - Create test case
• Update test case
• Delete test case
• Create test task
• Run test case

Feedback & Ticket

• - Create feedback
• Update feedback
• Delete feedback
• Create ticket
• Update ticket
• Delete ticket

Workflow

1. 1. Read Credentials - Get ZenTao API credentials from TOOLS.md
2. Parse Command - Parse user command and parameters
3. Authenticate - Get Token via REST API or Session via legacy API
4. Execute - Call corresponding API endpoints
5. Output - Return formatted results

API Documentation

REST API (Preferred)

• - Authentication: Token
• Endpoint: INLINECODE1
• Use Cases: Users, products, projects, executions, builds queries

Legacy API (Compatibility)

• - Authentication: Session/Cookie
• Endpoint: INLINECODE2
• Use Cases: Stories, tasks, bugs, releases queries

Output Format

Product List
CODEBLOCK9

Project List
CODEBLOCK10

Error Handling

• - Missing Credentials: Prompt user to configure ZenTao API credentials in TOOLS.md
• Authentication Failed: Check username and password
• API Connection Failed: Check network and API URL
• No Data: May be permission issue or no data in time range

Notes

1. 1. Configure ZenTao API credentials in TOOLS.md before first use
2. All create/update/delete operations require user confirmation
3. REST API is preferred, legacy API for compatibility
4. Query time range recommended not to exceed 1 year (large data volume)

🇨🇳 中文版

快速开始

本技能整合禅道老 API 和 REST API，提供统一的项目管理查询接口。

安装步骤

前置要求：

• - Python 3.8+
• pip (Python 包管理器)

安装依赖：
CODEBLOCK11

凭证配置

禅道 API 凭证存储在 TOOLS.md 文件中：

CODEBLOCK12

⚠️ 安全提醒： 不要将 API 凭证提交到版本控制或公开分享。

使用示例

查询产品列表
CODEBLOCK13

查询项目列表
CODEBLOCK14

查询需求列表
CODEBLOCK15

查询任务列表
CODEBLOCK16

查询缺陷列表
CODEBLOCK17

新建需求（需要确认）
CODEBLOCK18

新建任务（需要确认）
CODEBLOCK19

注意： 参数中的数字 ID（如产品 ID、执行 ID、需求 ID 等）可以直接使用对应的名称替代，系统会自动识别。
例如：产品=21 可以写成 INLINECODE5

功能列表

查询类（无需确认）

用户 User

• - 获取用户列表
• 获取用户信息
• 获取我的个人信息

项目集 Program

• - 获取项目集列表
• 获取项目集信息

产品 Product

• - 获取产品列表
• 获取产品信息
• 获取产品团队
• 获取产品计划列表
• 获取需求列表
• 获取 Bug 列表
• 获取发布列表
• 获取用例列表
• 获取测试单列表
• 获取反馈列表
• 获取工单列表

项目 Project

• - 获取项目列表
• 获取项目信息
• 获取项目需求列表
• 获取项目执行列表
• 获取项目版本列表

执行 Execution

• - 获取执行列表
• 获取执行信息
• 获取执行任务列表
• 获取执行 Bug 列表
• 获取执行版本列表

任务 Task

• - 获取任务列表
• 获取任务

缺陷 Bug

• - 获取 Bug

版本 Build

• - 获取版本

用例 TestCase

• - 获取用例

测试单 TestTask

• - 获取测试单

反馈 Feedback

• - 获取反馈

工单 Ticket

• - 获取工单

操作类（需要确认）

用户管理

• - 创建用户
• 修改用户信息
• 删除用户

项目集管理

• - 创建项目集
• 修改项目集
• 删除项目集

产品管理

• - 创建产品
• 修改产品
• 删除产品
• 创建产品计划
• 修改产品计划
• 删除产品计划
• 创建需求
• 修改需求
• 删除需求
• 激活需求
• 关闭需求

项目管理

• - 创建项目
• 修改项目
• 删除项目
• 创建版本
• 修改版本
• 删除版本

执行管理

• - 创建执行
• 修改执行
• 删除执行
• 创建任务
• 修改任务
• 删除任务

缺陷管理

• - 创建 Bug
• 修改 Bug
• 删除 Bug

测试管理

• - 创建用例
• 修改用例
• 删除用例
• 创建测试单
• 执行用例

反馈与工单

• - 创建反馈
• 修改反馈
• 删除反馈
• 创建工单
• 修改工单
• 删除工单

工作流程

1. 1. 读取凭证 - 从 TOOLS.md 获取禅道 API 凭证
2. 解析命令 - 解析用户命令和参数
3. 认证登录 - 使用 REST API 获取 Token 或老 API 获取 Session
4. 执行操作 - 调用对应 API 接口
5. 输出结果 - 返回格式化的结果

API 说明

REST API (优先使用)

• - 认证方式： Token
• 接口路径： INLINECODE6
• 适用场景： 用户、产品、项目、执行、版本等查询

老 API (兼容模式)

• - 认证方式： Session/Cookie
• 接口路径： INLINECODE7
• 适用场景： 需求、任务、缺陷、发布计划等

输出格式

产品列表
CODEBLOCK20

项目列表
CODEBLOCK21

错误处理

• - 凭证缺失： 提示用户在 TOOLS.md 中配置禅道 API 凭证
• 认证失败： 检查用户名密码是否正确
• API 连接失败： 检查网络连接和 API 地址
• 无数据返回： 可能是权限问题或时间范围内无数据

注意事项

1. 1. 首次使用需在 TOOLS.md 中配置禅道 API 凭证
2. 所有新增、新建、删除操作都需要用户确认
3. 建议优先使用 REST API，老 API 作为兼容
4. 查询时间范围建议不超过 1 年（数据量较大）

License | 许可证

MIT-0 · MIT No Attribution

Free to use, modify, and redistribute. No attribution required.

免费使用、修改和重新分发。无需署名。