テスト仕様書ツール

list_test_specs

アクセストークンが紐づくプロジェクトの仕様書一覧を返します。

入力:

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

出力: TestSpec[]（testCaseCount フィールド付き）

Copy[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "projectId": "proj-abc",
    "name": "ログイン機能テスト",
    "description": null,
    "testCaseCount": 12,
    "createdAt": "2026-01-01T00:00:00.000Z",
    "updatedAt": "2026-01-01T00:00:00.000Z"
  }
]

---

get_test_spec

入力:

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

出力: TestSpec（webhook フィールド解決済み）

---

create_test_spec

入力:

パラメータ	型	必須	説明
projectId	String	-	プロジェクトID（省略時はトークンのprojectIdを使用）
name	String	✓	仕様書名
description	String	-	説明
webhookId	String	-	Webhook設定ID（ワークスペースに登録済みのID）
requiredTesterEnv	String	-	要求テスター環境（自由記述）
requiredProductEnv	String	-	要求プロダクト環境（自由記述）
author	String	-	操作者署名

出力: TestSpec

---

update_test_spec

入力:

パラメータ	型	必須	説明
id	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
name	String	-	仕様書名
description	String	-	説明
webhookId	String	-	Webhook設定ID（null 指定でWebhook無効化）
requiredTesterEnv	String	-	要求テスター環境
requiredProductEnv	String	-	要求プロダクト環境
author	String	-	操作者署名

出力: TestSpec

---

delete_test_spec

テスト仕様書を削除します。報告書（TestReport）が1件でも存在する場合は削除できません（先に delete_test_report で該当報告書を削除してください）。配下のテストケース・ラベル割り当て・画像は削除に伴い連鎖的に削除されます。この操作は取り消せません。

入力:

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

出力:

Copy{ "success": true, "id": "550e8400-e29b-41d4-a716-446655440000" }

エラー: 報告書が存在する場合は VALIDATION_ERROR（details.hasReports: true）を返します。