用途:这是禅道(ZenTao)的测试用例(Testcase v2)管理技能,通过 zentao-cli 命令行对测试用例进行查询、查看详情、创建、更新、删除以及记录执行结果。
使用前必读:开始前必须先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量和错误处理信息。
主要能力:
- 列出用例:zentao-cli testcase list --product 1,可按 --status(wait/normal/blocked/bypass)、--type(feature/performance/interface/security/concurrency/destructive/install/others)、--project 筛选,例如 zentao-cli testcase list --product 1 --project 5 --type feature。
- 查看详情:zentao-cli testcase get 123。
- 创建:zentao-cli testcase create --title "登录功能测试" --product 1 --type feature。
- 更新、删除、记录执行结果:如 zentao-cli testcase result <id> --result pass(注意不是旧的 execute 子命令)。
字段说明:用例包含 id、title、product、project(可选)、type、status、severity(1-4,1 最严重)、pri(0-5)、openedBy、version、precondition(可选)、steps(可选)、expected(可选)。输出详情时建议同时给出用例 URL 便于点击查看。
限制与注意:--product 在大多数情况下必需;project 为可选,用例可只关联产品也可同时关联产品与项目;注意区分 testcase 的 status 与 bug 的 status;用例有版本概念,每次修改版本递增;常见错误包括 ZEN_AUTH_FAILED、ZEN_NOT_FOUND、ZEN_CONFIG_INVALID、ZEN_API_ERROR、ZEN_PARAM_MISSING,可运行 zentao-cli auth status 或检查 ZENTAO_URL、ZENTAO_TOKEN。其他未在资料中说明的功能、收费或平台信息暂未提供。