テストケースツール

list_test_cases_by_spec

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
author	String	-	操作者署名

出力: TestCase[]（index 昇順）

---

list_test_cases

アクセストークンが紐づくプロジェクトの全テストケースを返します。

入力:

パラメータ	型	必須	説明
author	String	-	操作者署名

出力: TestCase[]

---

get_test_case

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
caseNumber	Integer	✓	テストケースの安定ID（UI表示の「case-N」のN）
author	String	-	操作者署名

出力: TestCase

---

create_test_case

作成されたテストケースには caseNumber（安定ID）が自動採番されます。caseNumber はその仕様書内で単調増加し、他のケースを削除しても変わりません。

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
testSubject	String	✓	テストサブジェクト
steps	String[]	✓	テスト手順（文字列配列）
expectedResult	String	✓	期待結果
labelIds	String[]	-	割り当てるラベルID配列（省略時は空配列）
preconditions	String	-	前提条件
notes	String	-	備考
author	String	-	操作者署名

出力: TestCase

---

batch_create_test_cases

複数のテストケースを一括作成します（末尾追加）。AIエージェントがテスト仕様書をまとめて生成する用途に最適化されています。

制約:

• 1リクエストあたり最大 1000件
• リクエストペイロード全体が 6MB を超える場合はエラー
• insertAtIndex は非対応（常に末尾追加）

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
cases	Array	✓	作成するテストケースの配列（1〜1000件）
cases[].testSubject	String	✓	テストサブジェクト
cases[].steps	String[]	✓	テスト手順（文字列配列）
cases[].expectedResult	String	✓	期待結果
cases[].labelIds	String[]	-	割り当てるラベルID配列
cases[].preconditions	String	-	前提条件
cases[].notes	String	-	備考
author	String	-	操作者署名

出力:

Copy{
  "created": 3,
  "testCases": [
    {
      "id": "uuid",
      "specId": "spec-uuid",
      "caseNumber": 1,
      "testSubject": "ログインできること",
      "steps": ["メールアドレスを入力する", "パスワードを入力する", "ログインボタンをクリックする"],
      "expectedResult": "ダッシュボードに遷移すること",
      "labels": [],
      "preconditions": null,
      "notes": null,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

---

update_test_case

caseNumber（UI表示の「case-N」に対応する安定ID）で対象を指定します。指定したフィールドのみ更新されます。labelIds は full-replacement（省略時は変更なし）。

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
caseNumber	Integer	✓	テストケースの安定ID
testSubject	String	-	テストサブジェクト
steps	String[]	-	テスト手順
expectedResult	String	-	期待結果
labelIds	String[]	-	ラベルID配列（full-replacement、省略時は変更なし）
preconditions	String	-	前提条件
notes	String	-	備考
author	String	-	操作者署名

出力: TestCase