skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
imyuyu/zentao-cli63 installs

zentao-testcase

禅道(ZenTao) 测试用例(Testcase)管理 — 列出用例、查看用例详情、按产品/项目查询用例、执行用例。当用户说:'查询用例'、'用例列表'、'有哪些用例'、'testcase 列表'、'查看用例'、'用例详情'、'创建用例'、'新建 testcase'、'执行用例'、'用例结果'、'测试用例'、'禅道用例' 时触发。

How do I install this agent skill?

npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-testcase
view source ↗

Is 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

StatusDescription说明
waitWaiting等待执行
normalNormal/Pass正常/通过
blockedBlocked阻塞
bypassBypass/Skip跳过

Testcase Type

TypeDescription说明
featureFeature Test功能测试
performancePerformance Test性能测试
interfaceInterface Test接口测试
securitySecurity Test安全测试
concurrencyConcurrency Test并发测试
destructiveDestructive Test破坏性测试
installInstallation Test安装测试
othersOthers其他

Testcase Severity Levels

LevelNameDescription
1Critical系统崩溃或核心功能完全不可用
2Major主要功能失效
3Normal普通测试用例
4Minor轻微问题/界面测试

Commands

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

FieldTypeDescription
idu64测试用例 ID
titlestring测试用例标题
productu64产品 ID
projectu64项目 ID(可选)
typestring用例类型
statusstring用例状态
severityu8严重程度(1-4)
priu8优先级(0-5)
openedBystring创建人
versionu64版本号
preconditionstring前置条件(可选)
stepsstring测试步骤(可选)
expectedstring预期结果(可选)

Error Handling

常见错误

错误码说明解决方案
ZEN_AUTH_FAILEDToken 无效或过期检查 ZENTAO_TOKEN 配置
ZEN_NOT_FOUND测试用例不存在检查用例 ID 是否正确
ZEN_CONFIG_INVALID配置无效验证 ZENTAO_URL 和 ZENTAO_TOKEN
ZEN_API_ERRORZenTao API 返回错误检查服务器状态或稍后重试
ZEN_PARAM_MISSING缺少必需参数确保提供产品 ID

错误处理示例

# 遇到 auth 错误时检查认证状态
zentao-cli auth status

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

Gotchas

  1. product 参数:大多数情况下 --product 是必需的。如果没有指定 product,API 可能无法返回正确结果。

  2. project 与 product 的关系:测试用例可以独立于项目存在(只关联 product),也可以同时关联项目和产品。查询时 --project 是可选的。

  3. status 值:注意区分 testcase 的 status(wait/normal/blocked/bypass)和 bug 的 status(active/resolved/closed)。

  4. version 字段:ZenTao 测试用例有版本概念,每次修改会用例版本递增。获取详情时可以查看是哪个版本的用例。

  5. 执行结果命令名:执行测试用例结果时使用 zentao-cli testcase result <id> --result pass,不是旧的 execute 子命令。

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>