Back to Details

zentao

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

zentao (ZenTao CLI)

zentao (ZenTao CLI)

When to use this skill

何时使用该技能

Use this skill when the user asks anything about 禅道 / ZenTao, including:
  • bugs: list, mine, get, create, resolve, assign, comment, close, activate
  • tasks: list, get, create, start, finish, pause, close
  • stories: list, get, create
  • todos: list, get, create, finish, close
  • products, programs, projects, executions
  • plans, releases, builds
  • test cases, test tasks, test suites
  • docs and doc libraries
  • users and departments
  • issues and risks
  • login, whoami, self-test, JSON export
Typical user asks include:
  • “帮我查禅道 bug / task / story / todo”
  • “看一下产品、项目、执行、版本、计划、构建”
  • “查测试单、测试用例、测试套件”
  • “看文档库 / 文档 / 部门 / 用户”
  • “查问题 / 风险”
  • “帮我登录禅道” / “验证禅道连接”
当用户询问任何与禅道 / ZenTao相关的内容时使用该技能，包括：
  • bugs：列表查询、我相关的、查询详情、创建、解决、指派、评论、关闭、激活
  • tasks：列表查询、查询详情、创建、开始、完成、暂停、关闭
  • stories：列表查询、查询详情、创建
  • todos：列表查询、查询详情、创建、完成、关闭
  • 产品、产品集、项目、执行
  • 计划、发布、构建
  • 测试用例、测试任务、测试套件
  • 文档和文档库
  • 用户和部门
  • 问题和风险
  • 登录、身份查询、自检、JSON导出
典型用户提问包括：
  • “帮我查禅道 bug / task / story / todo”
  • “看一下产品、项目、执行、版本、计划、构建”
  • “查测试单、测试用例、测试套件”
  • “看文档库 / 文档 / 部门 / 用户”
  • “查问题 / 风险”
  • “帮我登录禅道” / “验证禅道连接”

Installation

安装

bash
npx skills add leeguooooo/zentao-mcp -y -g
pnpm i -g @leeguoo/zentao-mcp
Fallbacks:
bash
npm i -g @leeguoo/zentao-mcp
npx -y @leeguoo/zentao-mcp --help
skills add
installs the skill definition; the CLI still needs to be available as 
zentao
in PATH for normal usage.
bash
npx skills add leeguooooo/zentao-mcp -y -g
pnpm i -g @leeguoo/zentao-mcp
备选安装方案：
bash
npm i -g @leeguoo/zentao-mcp
npx -y @leeguoo/zentao-mcp --help
skills add
会安装技能定义；正常使用时，仍需要确保系统PATH中存在可执行的
zentao
CLI程序。

Login

登录

bash
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
IMPORTANT: 
--zentao-url
usually must include 
/zentao
.
bash
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
重要注意事项：
--zentao-url
通常必须包含
/zentao
后缀。

Quick start

快速入门

bash
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
zentao self-test
bash
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
zentao self-test

Capability map

能力地图

Use the singular command for one record or a state-changing action, and the plural command for list queries.
bash
zentao login
zentao whoami
zentao self-test
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bug get|create|resolve|assign|comment|close|activate ...
zentao tasks list --execution 25
zentao task get|create|start|finish|pause|close ...
zentao stories list --product 3
zentao story get|create ...
zentao todos list|get|create|finish|close ...
zentao plans list|get ...
zentao releases list|get ...
zentao testcases list|get ...
zentao testtasks list|get ...
zentao testsuites list|get ...
zentao docs libs|list|get ...
zentao users list
zentao departments list
zentao issues list|get ...
zentao risks list|get ...
单条记录操作或状态变更类操作使用单数命令，列表查询使用复数命令。
bash
zentao login
zentao whoami
zentao self-test
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bug get|create|resolve|assign|comment|close|activate ...
zentao tasks list --execution 25
zentao task get|create|start|finish|pause|close ...
zentao stories list --product 3
zentao story get|create ...
zentao todos list|get|create|finish|close ...
zentao plans list|get ...
zentao releases list|get ...
zentao testcases list|get ...
zentao testtasks list|get ...
zentao testsuites list|get ...
zentao docs libs|list|get ...
zentao users list
zentao departments list
zentao issues list|get ...
zentao risks list|get ...

Auth and output rules

认证和输出规则

  • All commands can read credentials from saved login config.
  • Flags also work: 
    --zentao-url
    , 
    --zentao-account
    , 
    --zentao-password
  • Environment variables also work: 
    ZENTAO_URL
    , 
    ZENTAO_ACCOUNT
    , 
    ZENTAO_PASSWORD
  • Add 
    --json
    when the caller wants raw machine-readable output.
  • ZenTao URLs usually need the 
    /zentao
    suffix.
  • 所有命令都可以从已保存的登录配置中读取凭证
  • 也支持使用参数指定：
    --zentao-url
    、
    --zentao-account
    、
    --zentao-password
  • 也支持使用环境变量：
    ZENTAO_URL
    、
    ZENTAO_ACCOUNT
    、
    ZENTAO_PASSWORD
  • 当调用方需要原始的机器可读输出时，添加
    --json
    参数
  • ZenTao URL通常需要带有
    /zentao
    后缀

Bug commands

Bug命令

bash
zentao bugs list --product 6
zentao bugs mine --scope assigned --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title" [--severity 3] [--pri 2] [--type codeerror] [--steps "..."] [--assigned-to account] [--opened-build trunk]
zentao bug resolve --id 1329 --resolution fixed [--resolved-build trunk] [--assigned-to kelly] [--comment "..."]
zentao bug assign --id 1329 --assigned-to rd-yitong [--comment "..."]
zentao bug close --id 1329 [--comment "..."]
zentao bug activate --id 1329 [--assigned-to account] [--comment "..."]
zentao bug comment --id 1329 --comment "已确认，等待修复"
Resolution values: 
fixed
, 
bydesign
, 
duplicate
, 
postponed
, 
notrepro
, 
willnotfix
, 
tostory
, 
external
bash
zentao bugs list --product 6
zentao bugs mine --scope assigned --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title" [--severity 3] [--pri 2] [--type codeerror] [--steps "..."] [--assigned-to account] [--opened-build trunk]
zentao bug resolve --id 1329 --resolution fixed [--resolved-build trunk] [--assigned-to kelly] [--comment "..."]
zentao bug assign --id 1329 --assigned-to rd-yitong [--comment "..."]
zentao bug close --id 1329 [--comment "..."]
zentao bug activate --id 1329 [--assigned-to account] [--comment "..."]
zentao bug comment --id 1329 --comment "已确认，等待修复"
解决状态可选值：
fixed
、
bydesign
、
duplicate
、
postponed
、
notrepro
、
willnotfix
、
tostory
、
external

Task commands

任务命令

bash
zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name" [--assigned-to account] [--pri 3] [--estimate 8] [--type devel] [--desc "..."]
zentao task start --id 388 [--consumed 2] [--left 6]
zentao task finish --id 388 [--finished-date "2026-04-08"] [--consumed 8]
zentao task pause --id 388
zentao task close --id 388 [--comment "done"]
bash
zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name" [--assigned-to account] [--pri 3] [--estimate 8] [--type devel] [--desc "..."]
zentao task start --id 388 [--consumed 2] [--left 6]
zentao task finish --id 388 [--finished-date "2026-04-08"] [--consumed 8]
zentao task pause --id 388
zentao task close --id 388 [--comment "done"]

Story commands

需求命令

bash
zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title" [--spec "description"] [--pri 2] [--estimate 3] [--type story] [--assigned-to account]
bash
zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title" [--spec "description"] [--pri 2] [--estimate 3] [--type story] [--assigned-to account]

Todo commands

待办命令

bash
zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name" [--type custom] [--date 2026-04-08] [--begin 09:00] [--end 10:00] [--pri 3] [--desc "..."] [--assigned-to account]
zentao todos finish --id 1
zentao todos close --id 1
bash
zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name" [--type custom] [--date 2026-04-08] [--begin 09:00] [--end 10:00] [--pri 3] [--desc "..."] [--assigned-to account]
zentao todos finish --id 1
zentao todos close --id 1

Product, program, project, and execution commands

产品、产品集、项目和执行命令

bash
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list
bash
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list

Product plans and releases

产品计划和发布

bash
zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1
bash
zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1

Testing commands

测试命令

bash
zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1
bash
zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1

Organization & docs

组织与文档

bash
zentao users list
zentao departments list
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1
bash
zentao users list
zentao departments list
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1

Issues & risks

问题与风险

bash
zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1
bash
zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1

JSON output

JSON输出

All commands support 
--json
for full JSON payload:
bash
zentao whoami --json
zentao bugs list --product 6 --json
zentao task get --id 388 --json
zentao users list --json
zentao issues get --id 1 --json
所有命令都支持
--json
参数返回完整JSON负载：
bash
zentao whoami --json
zentao bugs list --product 6 --json
zentao task get --id 388 --json
zentao users list --json
zentao issues get --id 1 --json

Recommended execution pattern

推荐执行流程

When helping a user operationally, prefer this sequence:
  1. Ensure CLI exists: 
    zentao --help
  2. Ensure auth exists: 
    zentao whoami
  3. If auth may be broken, run: 
    zentao self-test
  4. Use the narrowest command that answers the request.
  5. Add 
    --json
    when the caller needs structured output for follow-up automation.
在帮助用户操作时，优先遵循以下顺序：
  1. 确认CLI已存在：
    zentao --help
  2. 确认认证信息有效：
    zentao whoami
  3. 如果认证可能失效，运行：
    zentao self-test
  4. 使用能够满足请求的最精准命令
  5. 当调用方需要结构化输出用于后续自动化操作时，添加
    --json
    参数