syncing-testlink

プロジェクトフォルダからテストケースを TestLink に同期します。テストスイートの作成、HTML フォーマット対応のケースのインポート、テストプランの構築、ケースの割り当てを行います。

進捗チェックリスト

以下をコピーして進捗を追跡してください:

- [ ] ステップ 1: 前提条件を検証
- [ ] ステップ 2: TestLink プロジェクトを一覧表示し、ターゲットを確認
- [ ] ステップ 3: テストスイート + シナリオごとの子スイートを作成
- [ ] 検証: スイート ID と名前
- [ ] ステップ 4: テストケースを同期(差分: スキップ/更新/作成)
- [ ] 検証: スイートごとの作成/更新/スキップ件数
- [ ] ステップ 5: テストプランを作成し、全ケースを追加
- [ ] ステップ 6: 件数がローカルと一致することを確認
- [ ] 検証: 件数一致(合格/不合格) + テストプラン ID

ステップ

ステップ 1: 前提条件を検証

以下を確認してください:

• test_cases/README.md が存在する
• 最低 1 つの test_cases/TS-XX_*.md ファイルが存在する

ステップ 2: プロジェクトを一覧表示してターゲットを確認

testlink-mcp:list_projects を使用して、利用可能なプロジェクトを表示します。ユーザーにターゲットプロジェクトの確認を求めます。

ステップ 3: テストスイートを作成

/tl-create-suite を実行して、プロジェクト名に基づいた親テストスイートを作成し、次に各 TS-XX シナリオの子スイートを作成します。

MCP ツール: testlink-mcp:create_test_suite

検証

作成されたすべてのスイート ID と名前を一覧表示します。階層構造が正しいことを確認してください。

ステップ 4: テストケースを同期

各 TS-XX ファイルに対して /tl-create-case を実行します。HTML フォーマットルールについては /tl-format を使用してください。

作成する前に、差分ロジックを使用してローカルテストケースを TestLink と比較してください:

• 一致 (すべてのフィールドが同じ) → スキップ
• 相違 (名前は一致するがフィールドが異なる) → 異なるフィールドのみ更新
• 新規 (TestLink で名前が見つからない) → HTML フォーマット対応で作成

比較フィールド: name、summary、preconditions、steps.actions、steps.expected_results

作成後、前提条件が適用されたことを確認します。空の場合は更新してください。

MCP ツール: testlink-mcp:create_test_case、testlink-mcp:update_test_case、testlink-mcp:list_test_cases_in_suite

検証

スイートごとに以下を報告します:

• 作成: N
• 更新: N
• スキップ(既に一致): N

ステップ 5: テストプランを作成してケースを割り当て

/tl-create-plan を実行してテストプランを作成します。プレーンテキストを使用してください(notes フィールドでは HTML を使用しません)。

/tl-add-case-to-plan を実行して、作成/既存のすべてのテストケースをプランに追加します。

MCP ツール: testlink-mcp:create_test_plan、testlink-mcp:add_test_case_to_test_plan

ステップ 6: 件数を検証

testlink-mcp:get_test_cases_for_test_plan を使用してプラン内のケース数を数えます。 ローカルテストケース数と比較します。

検証

以下を報告します:

• ローカルテストケース数 vs TestLink 件数
• 件数一致: 合格 または 不合格
• 今後の実行用テストプラン ID

入力の想定

test_cases/ フォルダと TS-XX ファイルを含むプロジェクトフォルダへのパス。

次のステップ

TestLink の同期が完了した後、/executing-tests を実行してテストプランを実行します。