Zentao Build

Build (版本)

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

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

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

Commands

• build list — List builds/versions
• build get — Get build details
• build create — Create a build
• build update — Update a build
• build delete — Delete a build

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

Error Handling

常见错误

错误处理示例

# 查看认证状态
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 字段

权限说明