// 禅道(ZenTao) 测试用例（Testcase）管理 — 列出用例、查看用例详情、按产品/项目查询用例、执行用例。当用户说：'查询用例'、'用例列表'、'有哪些用例'、'testcase 列表'、'查看用例'、'用例详情'、'创建用例'、'新建 testcase'、'执行用例'、'用例结果'、'测试用例'、'禅道用例' 时触发。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | zentao-testcase |
| version | 1.2.0 |
| description | 禅道(ZenTao) 测试用例（Testcase）管理 — 列出用例、查看用例详情、按产品/项目查询用例、执行用例。当用户说：'查询用例'、'用例列表'、'有哪些用例'、'testcase 列表'、'查看用例'、'用例详情'、'创建用例'、'新建 testcase'、'执行用例'、'用例结果'、'测试用例'、'禅道用例' 时触发。 |
| metadata | {"requires":{"bins":["zentao-cli"],"envs":["ZENTAO_URL","ZENTAO_TOKEN"]},"cliHelp":"zentao-cli testcase --help"} |
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md，其中包含认证、环境变量和错误处理。
测试用例类型：ZenTao 测试用例有多种类型，包括功能测试、性能测试、接口测试、安全测试、并发测试、破坏性测试、安装测试等。查询时可按类型筛选。
状态判断：测试用例的状态包括 wait（等待）、normal（正常）、blocked（阻塞）、bypass（跳过）。其中 normal 表示用例执行通过。
严重性级别：测试用例的 severity 分为 1-4 级，1 为最严重（系统崩溃），4 为最低。
产品与项目：测试用例可以关联产品（product）或项目（project），也可以同时关联两者。查询时可以只指定产品或同时指定产品和项目。
友好输出：在输出测试用例详情时，建议同时输出用例的 URL 链接，便于用户直接点击查看。
| Status | Description | 说明 |
|---|---|---|
| wait | Waiting | 等待执行 |
| normal | Normal/Pass | 正常/通过 |
| blocked | Blocked | 阻塞 |
| bypass | Bypass/Skip | 跳过 |
| 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 | 其他 |
| Level | Name | Description |
|---|---|---|
| 1 | Critical | 系统崩溃或核心功能完全不可用 |
| 2 | Major | 主要功能失效 |
| 3 | Normal | 普通测试用例 |
| 4 | Minor | 轻微问题/界面测试 |
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# 列出产品 1 下的所有测试用例
zentao-cli testcase list --product 1
# 列出产品 1 下状态为正常的测试用例
zentao-cli testcase list --product 1 --status normal
# 列出产品 1 下项目 5 的所有测试用例
zentao-cli testcase list --product 1 --project 5
# 列出项目 5 的所有功能测试用例
zentao-cli testcase list --product 1 --project 5 --type feature
# 获取测试用例详细信息
zentao-cli testcase get 123
# 列出产品 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
| 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 | 预期结果（可选） |
| 错误码 | 说明 | 解决方案 |
|---|---|---|
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
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 子命令。