用途:面向禅道(ZenTao)的构建/版本(Build)管理,覆盖列出版本、获取版本详情、创建版本,并可关联 Story 和 Bug。触发场景包括查询版本、版本列表、build 列表、查看版本、版本详情、创建版本、新建 build、发布版本、版本信息、CI 版本、禅道版本。
主要能力与用法:命令包括 build list(列出版本)、build get(获取版本详情)、build create(创建版本)、build update(更新版本)、build delete(删除版本)。例如 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、zentao-cli build get 10 --format json。输出字段含 id、name、product、project、branch、scm_path、ci、pkg、file_size、generated_at、editor、created_by、created_date、last_edited_by、last_edited_date、stories、bugs。
使用前须知:开始前必须先用 Read 工具读取 ../zentao-shared/SKILL.md,其中含认证、权限处理与配置说明。搜索技巧:若用户特地指定搜索技能或提供查询关键字,优先使用搜索;若未指定且仅有范围条件(如某产品/项目的版本),优先使用 build list。输出详情时建议同时提取并输出返回结果中的相关链接字段,便于跳转查看。
限制与错误处理:Build ID 为全局唯一标识,并非本地展示编号;一个 Build 可能属于某 Product 或 Project,筛选时需区分;版本可关联多个 Story 与 Bug,可关注 stories、bugs 字段。常见错误:ZEN_NOT_FOUND(版本不存在,检查 Build ID)、ZEN_AUTH_FAILED(认证失败,检查 ZENTAO_TOKEN 是否有效)、ZEN_PARAM_MISSING(缺少参数,查看命令帮助)。可运行 zentao-cli auth status 查看认证状态,echo $ZENTAO_URL、echo $ZENTAO_TOKEN 验证配置。权限方面,build list 与 build get 均需项目/产品查看权限。其他版本管理能力细节暂未提供。