zentao-testcase
禅道(ZenTao) 测试用例(Testcase)管理 — 列出用例、查看用例详情、按产品/项目查询用例、执行用例。当用户说:'查询用例'、'用例列表'、'有哪些用例'、'testcase 列表'、'查看用例'、'用例详情'、'创建用例'、'新建 testcase'、'执行用例'、'用例结果'、'测试用例'、'禅道用例' 时触发。
How do I install this agent skill?
npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-testcaseIs this agent skill safe to install?
- Gen Agent Trust Hubfail
The skill manages ZenTao test cases but contains troubleshooting instructions that could lead to the exposure of sensitive authentication tokens in logs. It also processes external data from a ZenTao instance, creating an attack surface for indirect prompt injection.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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子命令。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/imyuyu/zentao-cli/zentao-testcase">View zentao-testcase on skillZs</a>