mcpField
Z
zentao-testcase

zentao-testcase

github.com/imyuyuテスト・品質362 回インストール22 週間前に更新
リポジトリ

zentao-testcase について

zentao-testcaseは、zentao-cliでZenTaoのテストケースを管理するスキルです。ケースの検索・絞り込み、詳細確認、編集、実行結果の記録に対応し、製品やプロジェクトのテスト業務に使えます。

主な機能

  1. 01テストケースの一覧表示と絞り込み
  2. 02ケース詳細の取得
  3. 03ケースの作成・更新・削除
  4. 04実行結果の記録
  5. 05状態・種類・製品・プロジェクトでの絞り込み

活用シーン

  1. 01製品またはプロジェクトのケース確認
  2. 02状態やテスト種類によるケース検索
  3. 03合格などの実行結果の記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-testcase

インストール後、Claude Code で/zentao-testcaseを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
zentao-testcase-create.md
zentao-testcase-delete.md
zentao-testcase-execute.md
zentao-testcase-get.md
zentao-testcase-list.md
zentao-testcase-result.md
zentao-testcase-update.md

詳細

テストケース（v2）

重要 — 開始前に、必ず Read ツールを使用して ../zentao-shared/SKILL.md を読み込んでください。認証、環境変数、エラー処理について記載されています。

テストケースの種類：ZenTao のテストケースには、機能テスト、性能テスト、インターフェーステスト、セキュリティテスト、並行テスト、破壊的テスト、インストールテストなど、さまざまな種類があります。検索時に種類で絞り込めます。

状態の判定：テストケースの状態には、wait（待機）、normal（正常）、blocked（ブロック）、bypass（スキップ）があります。このうち normal は、テストケースの実行に合格したことを示します。

重要度レベル：テストケースの severity は 1～4 のレベルに分かれており、1 が最も重大（システムクラッシュ）、4 が最も低いレベルです。

製品とプロジェクト：テストケースは製品（product）またはプロジェクト（project）に関連付けることができ、両方に関連付けることもできます。検索時には製品だけを指定するか、製品とプロジェクトの両方を指定できます。

使いやすい出力：テストケースの詳細を出力する際は、ユーザーが直接クリックして確認できるよう、テストケースの URL リンクも併せて出力することをお勧めします。

テストケースの状態

状態説明説明
wait待機中実行待ち
normal正常／合格正常／合格
blockedブロックブロック
bypassバイパス／スキップスキップ

テストケースの種類

種類説明説明
feature機能テスト機能テスト
performance性能テスト性能テスト
interfaceインターフェーステストインターフェーステスト
securityセキュリティテストセキュリティテスト
concurrency並行テスト並行テスト
destructive破壊的テスト破壊的テスト
installインストールテストインストールテスト
othersその他その他

テストケースの重要度レベル

レベル名前説明
1重大システムクラッシュまたは中核機能が完全に利用不可
2重要主要機能の障害
3通常一般的なテストケース
4軽微軽微な問題／画面テスト

コマンド

よくあるユースケース

シナリオ 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

例

# 列出产品 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

出力フィールド

フィールド型説明
idu64テストケース ID
titlestringテストケースのタイトル
productu64製品 ID
projectu64プロジェクト ID（任意）
typestringテストケースの種類
statusstringテストケースの状態
severityu8重要度（1～4）
priu8優先度（0～5）
openedBystring作成者
versionu64バージョン番号
preconditionstring前提条件（任意）
stepsstringテスト手順（任意）
expectedstring期待される結果（任意）

エラー処理

よくあるエラー
エラーコード説明解決策
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

注意事項

  1. product パラメーター：ほとんどの場合、--product は必須です。product を指定しないと、API が正しい結果を返さないことがあります。

  2. project と product の関係：テストケースはプロジェクトとは独立して存在（product のみと関連付け）することも、プロジェクトと製品の両方に関連付けることもできます。検索時に --project の指定は任意です。

  3. status の値：テストケースの status（wait/normal/blocked/bypass）とバグの status（active/resolved/closed）を混同しないようにしてください。

  4. version フィールド：ZenTao のテストケースにはバージョンの概念があり、変更するたびにテストケースのバージョンが増加します。詳細を取得すると、どのバージョンのテストケースかを確認できます。

  5. 実行結果のコマンド名：テストケースの実行結果を記録するには、旧 execute サブコマンドではなく、zentao-cli testcase result <id> --result pass を使用してください。

コメント

Markdown 対応