Agent skill

Zentao Manager

by HuangPuStar in HuangPuStar/FenixAgent

通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

MITAuto-check passed

Install Zentao Manager

skills CLI
$ npx skills add HuangPuStar/FenixAgent --skill zentao-manager -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HuangPuStar/FenixAgent zentao-manager --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HuangPuStar/FenixAgent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/zentao-manager .claude/skills/zentao-manager && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
zentao-manager
GitHub stars
552
Used in
1 other repo
Token cost
~2.5k tokens
SKILL.md length
439 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

  • SKILL.md covers 前置准备, 命令格式, 模块与操作速查 and AI 使用策略, plus 6 more sections
  • Calls npm; needs ZENTAO_PASSWORD and ZENTAO_TOKEN

What it does

Zentao Manager is an agent skill from HuangPuStar/FenixAgent. 通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MIT.

Example prompts

  • “/zentao-manager”

Requirements

  • Node.js
  • A credential in ZENTAO_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit da5eb54. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ZENTAO_PASSWORD
    • ZENTAO_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Zentao Manager loads about 2.5k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 439 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HuangPuStar/FenixAgent at commit da5eb54, republished under its MIT licence (© HuangPuStar). 439 words, ~2,456 tokens.

Download SKILL.mdSave it as .claude/skills/zentao-manager/SKILL.md (or your agent's skills folder).
name
zentao-manager
description
通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。
license
MIT
metadata.author
Sun Hao <sunhao@chandao.com>
metadata.repository
https://github.com/easysoft/zentao-cli.git
metadata.keywords
zentao, 禅道, cli, project-management
metadata.version
0.1.7

禅道 Manager

通过 zentao 命令行工具查询和操作禅道数据。CLI 自动处理认证、分页,支持工作区上下文和数据过滤/排序。

前置准备

安装
bash
npm install -g zentao-cli
# 或 bun install -g zentao-cli
# 或 pnpm install -g zentao-cli
# 或免安装运行:npx zentao-cli

如果用户没有安装,引导用户进行全局安装使用,如果系统存在 bun 或 pnpm 则优先使用 bun 或 pnpm 进行全局安装。

认证

首次执行任意 zentao 命令会自动提示登录。也可显式登录:

bash
zentao login -s https://zentao.example.com -u admin -p 123456

环境变量(优先级低于命令行参数):

变量说明
ZENTAO_URL禅道服务地址
ZENTAO_ACCOUNT用户账号
ZENTAO_PASSWORD密码
ZENTAO_TOKEN直接指定 Token(有此变量可省略密码)

登录成功后凭证缓存在 ~/.config/zentao/zentao.json,后续无需重复登录。

凭证安全
  • 用户尚未登录时,不要在对话里收集账号密码。让用户直接在终端执行 zentao login,或执行任意 zentao 命令触发首次自动登录提示,由用户自行输入凭证。
  • 严禁读取本地凭证:ZENTAO_PASSWORD / ZENTAO_TOKEN 环境变量、~/.config/zentao/zentao.json 配置文件。所有禅道数据均通过 zentao 命令获取,凭证由 CLI 内部处理。

命令格式

使用简写方式(推荐):

操作命令
列表zentao <module>
详情zentao <module> <id>
创建zentao <module> create --field=value
更新zentao <module> update <id> --field=value
删除zentao <module> delete <id>
动作zentao <module> <action> <id>
帮助zentao <module> help

也支持 --data='JSON' 传入 JSON 数据。

模块与操作速查

模块名中文支持的操作
program项目集CRUD
product产品CRUD
project项目CRUD
execution执行/迭代CRUD
story需求CRUD + activate / change / close
epic业务需求CRUD + activate / change / close
requirement用户需求CRUD + activate / change / close
bugBugCRUD + activate / close / resolve
task任务CRUD + activate / close / finish / start
testcase测试用例CRUD
testtask测试单CUD(按产品/项目/执行查列表)
productplan产品计划CUD(按产品查列表)
build版本CUD(按项目/执行查列表)
release发布CUD(按产品查列表)
feedback反馈CRUD + activate / close
ticket工单CRUD + activate / close
system应用CU(按产品查列表)
user用户CRUD
file附件编辑名称 + 删除(⚠️ 不支持上传)

CRUD = 列表 + 详情 + 创建 + 更新 + 删除;CUD = 无独立列表接口,需指定所属范围

列表范围参数

部分模块的列表需要指定所属范围:

bash
zentao story --product=1                # 产品 #1 的需求
zentao bug --product=1                  # 产品 #1 的 Bug
zentao task --execution=1               # 执行 #1 的任务
zentao execution --project=5            # 项目 #5 的执行
zentao build --project=5                # 项目 #5 的版本
zentao testtask --product=1             # 产品 #1 的测试单
zentao release --product=1              # 产品 #1 的发布
zentao productplan --product=1          # 产品 #1 的计划
zentao feedback --product=1             # 产品 #1 的反馈
zentao ticket --product=1               # 产品 #1 的工单

设置工作区后可省略这些参数(见下方工作区章节)。

AI 使用策略

输出格式
  • 展示给用户:不加 --format 参数,默认输出 Markdown 表格(列表)或列表(单个对象)
  • 需要程序化处理:加 --format=json,返回结构化 JSON
交互确认

AI 场景下执行删除操作时加 --yes 跳过确认提示:

bash
zentao bug delete 1 --yes
不知道 ID 时

先查列表获取 ID,再操作具体对象:

bash
zentao product --pick=id,name           # 查看产品列表
zentao bug --product=1 --pick=id,title  # 查看 Bug 列表
zentao bug 42                           # 查看具体 Bug
写操作前确认

执行创建、更新、删除等写操作前,先向用户确认操作内容。用户明确要求不确认时可跳过。

更新操作自动补全

执行 update 时,CLI 会先 GET 当前对象,把用户未显式传入的字段用现值填充后再 PUT,避免禅道 PUT 覆盖未提交字段导致清空。因此只需传想改的字段即可,无需手动先查再传完整参数。

数据处理

摘取字段
bash
zentao product --pick=id,name,status
过滤
bash
zentao bug --product=1 --filter='status:active'
zentao bug --product=1 --filter='severity<=2,pri<=2'    # AND
zentao bug --product=1 --filter='status:active' --filter='status:resolved'  # OR

支持的运算符:: 等于、!= 不等于、> < >= <=、~ 包含、!~ 不包含。

模糊搜索
bash
zentao bug --product=1 --search=登录 --search-fields=title,steps
排序
bash
zentao bug --product=1 --sort=pri_asc,severity_asc
分页
bash
zentao bug --product=1 --page=1 --recPerPage=50
zentao bug --product=1 --all            # 获取全部
zentao bug --product=1 --limit=10       # 只取前 10 条

常用操作示例

查看进行中的项目和执行
bash
zentao project --filter='status:doing' --pick=id,name,status
zentao execution --project=5 --pick=id,name,status
创建需求并关联计划
bash
zentao story create --product=1 --title="需求标题" --assignedTo=admin --pri=3
zentao story update 11 --title="需求标题" --plan=1
创建并解决 Bug
bash
zentao bug create --product=1 --title="Bug标题" --severity=2 --pri=2 --type=codeerror --openedBuild=trunk
zentao bug resolve 42
创建、启动并完成任务
bash
zentao task create --execution=1 --name="任务名" --type=devel --assignedTo=admin --estimate=4
zentao task start 100
# 注意:必填 --currentConsumed(本次消耗)、--realStarted、--finishedDate,日期必须带时间
zentao task finish 100 --currentConsumed=4 --realStarted="2026-07-15 09:00:00" --finishedDate="2026-07-15 18:00:00"
查看帮助
bash
zentao bug help          # 查看 Bug 模块的参数和操作
zentao story update help # 查看需求更新操作的参数和操作
zentao help              # 查看所有命令
Show full SKILL.md (205 more words)Show less

意图识别

用户意图CLI 命令
所有产品/项目/项目集zentao product / zentao project / zentao program
进行中的项目zentao project --filter='status:doing'
某产品的 Bugzentao bug --product=<id>
某执行的任务zentao task --execution=<id>
创建/新增 Bugzentao bug create ...
解决 Bugzentao bug resolve <id>
关闭 Bugzentao bug close <id>
激活 Bugzentao bug activate <id>
创建需求zentao story create ...
变更/关闭/激活需求zentao story change/close/activate <id>
业务需求zentao epic ...(同 story)
用户需求zentao requirement ...(同 story)
创建/启动/完成/关闭任务zentao task create/start/finish/close ...
测试用例zentao testcase ...
测试单zentao testtask ...
产品计划zentao productplan ...
版本/Buildzentao build ...
发布zentao release ...
反馈zentao feedback ...
工单zentao ticket ...
用户列表zentao user
当前用户信息zentao profile

错误处理

错误码含义处理方式
E1001未登录/凭证缺失执行 zentao login
E1004Token 失效执行 zentao login 重新登录
E2001模块不存在执行 zentao help 查看可用模块
E2002对象不存在检查 ID 是否正确
E2003缺少必要参数执行 zentao <module> help 或 zentao <module> <action> help 查看操作参数
E2006无权限提示用户检查权限
E2008服务端业务校验失败查看返回 JSON 里的 message 字段定位具体原因(如日期/必填字段校验)
E2009参数值无效必填参数未提供,执行 zentao <module> <action> help 查看必填项
E5001请求超时检查网络或禅道服务状态

踩坑记录

  • file 模块不支持上传附件:只支持编辑名称 + 删除,上传附件需到禅道 Web 端手动操作
  • task finish 必填参数:官方示例 --consumed=4 有误——必填的是 --currentConsumed、--realStarted、--finishedDate,日期必须带时间(YYYY-MM-DD HH:mm:ss),纯日期会报"实际完成不能小于实际开始"
  • 任务无原生评审状态:需要评审时只能通过 --assignedTo 重新指派,不能走状态流转
  • CLI 参数名不一致:task 用 --name,bug 用 --title;task finish 用 --currentConsumed(非 --consumed)
  • 搜索必须配合 --search-fields:--search=关键词 单独使用可能无效
  • 模糊搜索可能匹配不全:搜不到时尝试缩短关键词,或直接列表 + --pick 人工筛选

注意事项

  • 不确定模块参数时,先执行 zentao <module> help 查看帮助,不确定操作参数时,先执行 zentao <module> <action> help 查看帮助
  • browseType 常用值:all(全部)、doing(进行中)、closed(已关闭)
  • 多账号切换:zentao profile 查看和切换账号

© HuangPuStar, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/zentao-manager of HuangPuStar/FenixAgent.

Open the folder on GitHubat commit da5eb54

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in HuangPuStar/FenixAgent, which our catalogue first saw on October 7, 2026.

Similar skills

  • At Zentao

    kairyou/agent-tools

    Handle ZenTao (禅道) Bugs and Tasks end to end, including updating or writing back an item after code changes, managing Task status and hours, and reading linked Stories.

    178 GitHub stars~4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

More from HuangPuStar/FenixAgent

  • Auto Devflow

    HuangPuStar/FenixAgent

    A skill your agent uses when starting an issue, bugfix, feature, or refactor that should be driven by multiple coordinated subagents: explore → plan → code → review, with the main agent acting as…

    552 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Agent Platform API

    HuangPuStar/FenixAgent

    RCS Platform API 完整参考。Agent 通过 curl + jq 调用 REST API 操作平台资源:环境、工作流、配置、任务、知识库、组织等。

    552 GitHub stars~565 tokensUpdated yesterday
    Auto-check: notes
  • Fenix Code Review

    HuangPuStar/FenixAgent

    执行 FenixAgent 项目专用代码审查。手动触发,默认审查已暂存改动,或按用户提供的文件路径、提交范围、分支 diff 范围进行审查,并生成审查报告。

    552 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Show HTML Or Picture

    HuangPuStar/FenixAgent

    当需要把本地 HTML 或图片文件展示给前端时使用。优先引用当前工作目录下的 user/ 目录中的文件;如果文件在其他位置,先复制到当前工作目录的 user/ 再展示。路径由前端自动改写为 /fs/ 路由代理,Agent 只需输出 user/ 相对路径即可。最终只输出可直接渲染的相对路径片段:HTML 输出 iframe,图片输出 Markdown 图片;路径不能是绝对路径,也不能以 /…

    552 GitHub stars~475 tokensUpdated yesterday
    Auto-check passed
  • Skill Creator

    HuangPuStar/FenixAgent

    帮助用户创建、编辑和优化 Agent Skill 指令文件。当用户提到"创建 skill"、"写技能"、"编辑 skill"、"优化技能"、"新建技能"或需要生成 SKILL.md 文件时使用。

    552 GitHub stars~469 tokensUpdated yesterday
    Auto-check passed

Questions about Zentao Manager

What does Zentao Manager do?

通过 zentao 命令行工具查询和操作禅道(ZenTao)数据,覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。. Zentao Manager is an agent skill from HuangPuStar/FenixAgent.

How do I install Zentao Manager in Claude Code?

Run `npx skills add HuangPuStar/FenixAgent --skill zentao-manager -a claude-code`. Or copy the skill folder (.claude/skills/zentao-manager in HuangPuStar/FenixAgent) into .claude/skills/zentao-manager in your project. Claude Code loads it when a task matches its description.

How do I install Zentao Manager in Codex?

Run `npx skills add HuangPuStar/FenixAgent --skill zentao-manager -a codex`. Or copy the skill folder (.claude/skills/zentao-manager in HuangPuStar/FenixAgent) into .agents/skills/zentao-manager in your project. Codex loads it when a task matches its description.

Can I use Zentao Manager in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HuangPuStar/FenixAgent --skill zentao-manager -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zentao-manager, .gemini/skills/zentao-manager, .github/skills/zentao-manager and .opencode/skills/zentao-manager in your project.

What does Zentao Manager need to run?

Going by SKILL.md and its folder, Zentao Manager needs the command-line tools its instructions call (npm) and credentials named ZENTAO_PASSWORD and ZENTAO_TOKEN. Our summary lists: Node.js; A credential in ZENTAO_TOKEN.

Does Zentao Manager access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Zentao Manager safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Zentao Manager use?

Zentao Manager is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zentao Manager use?

About 2.5k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Zentao Manager?

Skills that share tags, products or a category with Zentao Manager: At Zentao (kairyou/agent-tools, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zentao Manager?

HuangPuStar (a GitHub organization) maintains it in HuangPuStar/FenixAgent, which has 552 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

Source: HuangPuStar/FenixAgent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.