imyuyu Testcase (v2)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md，其中包含认证、环境变量和错误处理。
测试用例类型：ZenTao 测试用例有多种类型，包括功能测试、性能测试、接口测试、安全测试、并发测试、破坏性测试、安装测试等。查询时可按类型筛选。
状态判断：测试用例的状态包括 wait（等待）、normal（正常）、blocked（阻塞）、bypass（跳过）。其中 normal 表示用例执行通过。
严重性级别：测试用例的 severity 分为 1-4 级，1 为最严重（系统崩溃），4 为最低。
产品与项目：测试用例可以关联产品（product）或项目（project），也可以同时关联两者。查询时可以只指定产品或同时指定产品和项目。
友好输出：在输出测试用例详情时，建议同时输出用例的 URL 链接，便于用户直接点击查看。
Testcase Status
| Status | Description | 说明 |
|---|---|---|
| wait | Waiting | 等待执行 |
| normal | Normal/Pass | 正常/通过 |
| blocked | Blocked | 阻塞 |
| bypass | Bypass/Skip | 跳过 |
Testcase Type
| Type | Description | 说明 |
|---|---|---|
| feature | Feature Test | 功能测试 |
| performance | Performance Test | 性能测试 |
| interface | Interface Test | 接口测试 |
| security | Security Test | 安全测试 |
| concurrency | Concurrency Test | 并发测试 |
| destructive | Destructive Test | 破坏性测试 |
| install | Installation Test | 安装测试 |
| others | Others | 其他 |
Testcase Severity Levels
| Level | Name | Description |
|---|---|---|
| 1 | Critical | 系统崩溃或核心功能完全不可用 |
| 2 | Major | 主要功能失效 |
| 3 | Normal | 普通测试用例 |
| 4 | Minor | 轻微问题/界面测试 |
Commands
testcase list— List test cases for a product/projecttestcase get— Get test case detailstestcase create— Create a test casetestcase update— Update a test casetestcase delete— Delete a test casetestcase result— Record test case execution result
Common Use Cases
场景 1：查询产品的所有测试用例
# 列出产品 1 下的所有测试用例
zentao-cli testcase list --product 1
# 列出产品 1 下状态为正常的测试用例
zentao-cli testcase list --product 1 --status normal
场景 2：按项目查询测试用例
# 列出产品 1 下项目 5 的所有测试用例
zentao-cli testcase list --product 1 --project 5
# 列出项目 5 的所有功能测试用例
zentao-cli testcase list --product 1 --project 5 --type feature
场景 3：获取测试用例详情
# 获取测试用例详细信息
zentao-cli testcase get 123
Examples
# 列出产品 1 下的所有测试用例
zentao-cli testcase list --product 1
# 列出状态为正常的测试用例
zentao-cli testcase list --product 1 --status normal
# 获取测试用例详情
zentao-cli testcase get 123
# 创建测试用例
zentao-cli testcase create --title "登录功能测试" --product 1 --type feature
Output Fields
| Field | Type | Description |
|---|---|---|
| id | u64 | 测试用例 ID |
| title | string | 测试用例标题 |
| product | u64 | 产品 ID |
| project | u64 | 项目 ID（可选） |
| type | string | 用例类型 |
| status | string | 用例状态 |
| severity | u8 | 严重程度（1-4） |
| pri | u8 | 优先级（0-5） |
| openedBy | string | 创建人 |
| version | u64 | 版本号 |
| precondition | string | 前置条件（可选） |
| steps | string | 测试步骤（可选） |
| expected | string | 预期结果（可选） |
Error Handling
常见错误
| 错误码 | 说明 | 解决方案 |
|---|---|---|
ZEN_AUTH_FAILED |
Token 无效或过期 | 检查 ZENTAO_TOKEN 配置 |
ZEN_NOT_FOUND |
测试用例不存在 | 检查用例 ID 是否正确 |
ZEN_CONFIG_INVALID |
配置无效 | 验证 ZENTAO_URL 和 ZENTAO_TOKEN |
ZEN_API_ERROR |
ZenTao API 返回错误 | 检查服务器状态或稍后重试 |
ZEN_PARAM_MISSING |
缺少必需参数 | 确保提供产品 ID |
错误处理示例
# 遇到 auth 错误时检查认证状态
zentao-cli auth status
# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN
Gotchas
product 参数：大多数情况下
--product是必需的。如果没有指定 product，API 可能无法返回正确结果。project 与 product 的关系：测试用例可以独立于项目存在（只关联 product），也可以同时关联项目和产品。查询时
--project是可选的。status 值：注意区分 testcase 的 status（wait/normal/blocked/bypass）和 bug 的 status（active/resolved/closed）。
version 字段：ZenTao 测试用例有版本概念，每次修改会用例版本递增。获取详情时可以查看是哪个版本的用例。
执行结果命令名：执行测试用例结果时使用
zentao-cli testcase result <id> --result pass，不是旧的execute子命令。