skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
imyuyu/zentao-cli62 installs

zentao-build

禅道(ZenTao) 版本/Build 管理 — 列出版本、获取版本详情、创建版本、关联 Story 和 Bug。当用户说:'查询版本'、'版本列表'、'build 列表'、'查看版本'、'版本详情'、'创建版本'、'新建 build'、'发布版本'、'版本信息'、'CI 版本'、'禅道版本' 时触发。

How do I install this agent skill?

npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-build
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill facilitates the management of ZenTao builds using a CLI tool. It is primarily safe but contains instructions that could lead to the exposure of sensitive credentials during troubleshooting and is susceptible to indirect prompt injection from data retrieved from the ZenTao server.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Build (版本)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、权限处理、配置说明

版本搜索技巧:先区分用户是否特地指定使用搜索 skill,以及是否真的提供了查询关键字(例如版本名称、关键词)。如果用户特地指定使用搜索 skill,或明确给出了查询关键字,则优先使用搜索。如果用户没有特地指定使用搜索 skill,且意图里没有查询关键字,只有范围条件(例如"某产品的版本"、"某项目的版本"),应优先使用 build list。

友好输出:在输出版本详情时,建议同时提取并输出命令返回结果中的相关链接字段(如果有),以便用户可以直接点击跳转查看详情。

Commands

Common Use Cases

列出版本

# 列出所有版本
zentao-cli build list

# 列出某项目的版本
zentao-cli build list --project 1

# 列出某产品的版本
zentao-cli build list --product 1

# 同时按项目和产品筛选
zentao-cli build list --project 1 --product 1

# 列出某执行的版本
zentao-cli build list --execution 5

获取版本详情

# 获取版本详情
zentao-cli build get 10

# 获取版本详情(JSON 格式)
zentao-cli build get 10 --format json

Output Fields

FieldTypeDescription
idu64Build ID
namestringBuild 名称(例如 "v1.0.0", "Build-2024-01-15")
productu64产品 ID
projectu64项目 ID
branchu64分支/平台 ID
scm_pathstringSCM 仓库路径
cistringCI 任务名称
pkgstring包路径
file_sizestring文件大小(字节)
generated_atstring构建时间戳
editorstring最后编辑者
created_bystring创建人
created_datestring创建时间
last_edited_bystring最后编辑者
last_edited_datestring最后编辑时间
storiesstring关联的需求数量
bugsstring关联的 Bug 数量

Error Handling

常见错误

错误码说明处理方式
ZEN_NOT_FOUND版本不存在检查 Build ID 是否正确
ZEN_AUTH_FAILED认证失败检查 ZENTAO_TOKEN 是否有效
ZEN_PARAM_MISSING缺少参数查看命令帮助确认必需参数

错误处理示例

# 查看认证状态
zentao-cli auth status

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

Examples

# 列出所有版本
zentao-cli build list

# 列出某项目的版本
zentao-cli build list --project 1

# 列出某产品的版本
zentao-cli build list --product 1

# 获取版本详情
zentao-cli build get 10

# 获取版本详情(JSON 格式)
zentao-cli build get 10 --format json

Gotchas

  1. Build ID 是全局唯一标识,不是本地展示编号
  2. 一个 Build 可能属于某个 Product 或 Project,筛选时注意区分
  3. 版本可能关联多个 Story 和 Bug,查看详情时可注意 stories 和 bugs 字段

权限说明

操作所需权限
build list项目/产品查看权限
build get项目/产品查看权限

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/imyuyu/zentao-cli/zentao-build">View zentao-build on skillZs</a>