zentao (ZenTao CLI)
When to use this skill
Use this skill when the user asks anything about 禅道 / ZenTao, including:
- bugs: list, mine, stats, 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”
- “统计一下 bug 解决率” / “看看各产品的 bug 解决情况”
- “看一下产品、项目、执行、版本、计划、构建”
- “查测试单、测试用例、测试套件”
- “看文档库 / 文档 / 部门 / 用户”
- “查问题 / 风险”
- “帮我登录禅道” / “验证禅道连接”
Installation
npx skills add leeguooooo/zentao-mcp -y -g
pnpm i -g @leeguoo/zentao-mcpFallbacks:
npm i -g @leeguoo/zentao-mcp
npx -y @leeguoo/zentao-mcp --helpskills add installs the skill definition; the CLI still needs to be available as zentao in PATH for normal usage.
Login
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoamiIMPORTANT: --zentao-url usually must include /zentao.
Quick start
zentao login --zentao-url="https://zentao.example.com/zentao" --zentao-account="leo" --zentao-password="***"
zentao whoami
zentao self-testCapability map
Use the singular command for one record or a state-changing action, and the plural command for list queries.
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 bugs stats --product-ids 1,2 --group-by product|person [--from DATE] [--to DATE]
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
--jsonwhen the caller wants raw machine-readable output. - ZenTao URLs usually need the
/zentaosuffix.
Bug commands
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
Bug stats
# 按产品统计解决率
zentao bugs stats --product-ids 1,2 --group-by product
# 按人员统计解决率（按实际解决人 resolvedBy 分组）
zentao bugs stats --product-ids 1,2 --group-by person
# 按产品统计指定时间段内的解决数量
zentao bugs stats --product-ids 1,2 --group-by product --from 2026-01-01 --to 2026-04-09
# 按人员统计指定时间段内的解决数量
zentao bugs stats --product-ids 1,2 --group-by person --from 2026-03-01 --to 2026-03-31
# JSON 输出
zentao bugs stats --product-ids 1,2 --group-by product --json--product-ids必填，逗号分隔--group-by支持product或person，默认product- 不指定
--from/--to时输出解决率；指定时间段时输出该期间的解决数量 - 人员维度按
resolvedBy（实际解决人）分组
Task commands
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
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
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 1Product, program, project, and execution commands
zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions listProduct plans and releases
zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1Testing commands
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 1Organization & docs
zentao users list
zentao departments list
zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1Issues & risks
zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1JSON output
All commands support --json for full JSON payload:
zentao whoami --json
zentao bugs list --product 6 --json
zentao task get --id 388 --json
zentao users list --json
zentao issues get --id 1 --jsonRecommended execution pattern
When helping a user operationally, prefer this sequence:
- Ensure CLI exists:
zentao --help - Ensure auth exists:
zentao whoami - If auth may be broken, run:
zentao self-test - Use the narrowest command that answers the request.
- Add
--jsonwhen the caller needs structured output for follow-up automation.