mcpField
M
migrate-to-testomatio

migrate-to-testomatio

github.com/testomatioテスト・品質1660 回インストール6 日前に更新
リポジトリ

migrate-to-testomatio について

他のテスト管理システムから Testomat.io へテストスイートを移行するチーム向けのガイドです。移行範囲、移行元、API の利用可否に応じて、UI インポート、変換スクリプト、API スクリプトを選びます。

主な機能

  1. 01テストケースと追加データの範囲確認
  2. 02移行元に応じた方法の選択
  3. 03CSV/XLSX の変換とインポート
  4. 04実行履歴や添付ファイルの API 移行
  5. 05移行後の件数と形式の確認

活用シーン

  1. 01TestRail のケースを Testomat.io にインポート
  2. 02Testmo の実行結果や添付ファイルを移行
  3. 03他システムのテストケース出力を変換
  4. 04未対応システム向けの移行方法を設計

インストール

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

$npx skills add https://github.com/testomatio/skills --skill migrate-to-testomatio

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

同梱ファイル

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

references/
CSV_MIGRATION.md
CUSTOM_MIGRATION.md
TESTMO_MIGRATION.md
TESTRAIL_MIGRATION.md
XRAY_MIGRATION.md

詳細

Testomat.io に移行する

UI インポート、API 移行スクリプト、または CSV コンバーターを使用して、別の TMS から Testomat.io にテストスイートを移行します。

対象範囲の確認（最初に質問）

  • 移行方法を選ぶ前に、ユーザーに移行する内容を確認してください。テストケースのみか、実行履歴／結果、添付ファイル／スクリーンショット、自動化実行、マイルストーン、不具合／課題のリンク、カスタムフィールドも含むかを尋ねます。
  • テストケースのみと決めつけないでください。「テストケースのみが必要ですか。それとも実行／結果と添付ファイルも必要ですか？」と明示的に確認してください。
  • 回答を記録し、その内容に応じて案内してください。テストケース以外を含む場合は、API スクリプトの方法を選びます（CSV では移行できません）。

方法を選ぶ

  • 移行元を特定します。まだ指定されていない場合に限り、TMS 名を尋ねてください。
  • 最適な取得方法を積極的に確認します。対象範囲に必要な場合、またはデータセットが大きい場合は、CSV エクスポートよりライブ API アクセスを優先します。CSV は手軽な代替手段であり、完全な移行の既定の方法ではありません。
  • 早い段階で API アクセスの有無を尋ねます。「移行元のインスタンスに管理者／API アクセス（URL と API トークン）がありますか？」アクセスできる場合は、CSV エクスポートも可能であっても、API スクリプトの方法を使用します。
  • 入力方法を特定します。API アクセスが可能なライブインスタンスか、エクスポート済みの CSV／XLSX ファイルかを確認します。
  • 移行元に応じて案内します。
    • TestRail + API アクセス、テスト数が 1000 件超、または添付ファイル／実行履歴が必要な場合：API 移行スクリプト（TESTRAIL_MIGRATION.md）。
    • TestRail、テスト数が 1000 件未満、添付ファイルが不要な場合：組み込みの UI インポート（CSV または Imports ウィンドウの TestRail API オプション）。
    • Testmo + API アクセス、または実行履歴／結果／添付ファイルが必要な場合：Testmo REST API による API 移行（TESTMO_MIGRATION.md、TestRail スクリプトを参考に作成）。
    • XRay (Jira)：Testomat.io CSV を生成する移行スクリプト（XRAY_MIGRATION.md）。
    • Testmo、QMetry、TestCaseLabs、Allure TestOps のエクスポートファイルで、テストケースのみ、添付ファイル不要の場合：CSV コンバータースクリプト（CSV_MIGRATION.md）。
    • Qase、QTest、Zephyr、その他の TMS のエクスポートファイル：スクリプトを使わず、UI から直接 CSV をインポート（CSV_MIGRATION.md）。
    • 未対応、またはサポートが正常に機能しない TMS：カスタムコンバーターまたは API スクリプトを作成（CUSTOM_MIGRATION.md）。
  • CSV の制限事項：CSV／XLSX で移行できるのはテストケースのみです。実行結果／履歴、添付ファイル／スクリーンショット、自動化実行、マイルストーンは移行できません。これらのいずれかが必要な場合は、API 移行の方法に切り替えてください。
  • スクリーンショットやファイル添付が必要な場合は、API スクリプトの方法を使用します。CSV インポートでは添付ファイルを作成できません。
  • コンバーターの出力列を決して推測で作成しないでください。変換後のファイルは常に形式 Testomat.io でインポートします。
  • API スクリプトには、移行元の認証情報と Testomat.io General Token が必要です。トークンをハードコードせず、.env を使用してください。

対象範囲

  • 移行対象はデフォルトでテストケースです。実行履歴、結果／履歴、添付ファイル、自動化実行、マイルストーン、不具合、要件は API で追加移行できます。ユーザーが必要とする項目を確認してください（「対象範囲の確認」を参照）。
  • テストケースをアップロードした後にのみ、実行結果をアップロードしてください。
  • Testomat.io に対応する項目がないユーザーフィールドを、黙って破棄してはいけません。ラベル／タグにマッピングするか、コンバータースクリプトを拡張してください。

ワークフロー

  • インポート先として、空の Testomat.io プロジェクトを作成します。
  • 移行元へのアクセスを取得します。API 認証情報（TestRail／XRay／Testmo の方法）またはエクスポートファイル（CSV の方法）を用意します。
  • 選択した方法を実行します。
    • API スクリプトの方法：リポジトリを一時ディレクトリにクローンし、.env を設定して、ドライランを実行した後、完全な移行を実行します。
    • CSV の方法：コンバーターがある場合は変換してから、UI 経由でインポートします。
    • カスタムの方法：先にコンバーターまたは API スクリプトを作成し、上記の該当する方法に従います。
  • いずれの場合も、UI インポートは次の手順で完了します。Tests タブ > (...) > 他の TMS からインポート > Import > Import from CSV > 変換元の形式を選択 > Choose file > Create。
  • 確認します。Tests ページの件数、スイートのネスト、ステップの書式、優先度／タグをチェックします。
  • 移行後のクリーンアップとして、detect-duplicate-test-cases と improve-test-cases を提案します。

参考資料

  • TESTRAIL_MIGRATION.md — TestRail の UI オプション、API スクリプトの環境変数、テストランと添付ファイルの移行。
  • TESTMO_MIGRATION.md — TestRail スクリプトを参考にした、Testmo REST API の移行（ケース、テストラン、結果、添付ファイル）。
  • XRAY_MIGRATION.md — XRay のトークン抽出、環境変数、フォルダー単位のインポート。
  • CSV_MIGRATION.md — コンバータースクリプト、UI からの直接インポート、Testomat.io 固有の XLSX 列。
  • CUSTOM_MIGRATION.md — サポート対象外または動作しない TMS に対応するカスタムコンバーターまたは API v2 スクリプト。

コメント

Markdown 対応