テスト報告書ツール

start_test

テスト仕様書からテスト実行を開始し、新しい報告書（TestReport）を作成します。仕様書の全テストケースに対応する TestReportResult が自動生成されます。

入力:

パラメータ	型	必須	説明
specId	String	✓	テスト仕様書の複合ID（{projectId}.{specUuid}）
reportName	String	✓	報告書名
webhookEnabled	Boolean	-	Webhook有効フラグ（省略時は仕様書の設定を継承）
author	String	-	操作者署名

出力: TestReport（reportResults は含まない）

---

list_test_reports

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

入力:

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

出力: TestReport[]（reportResults は含まない）

---

get_test_report

入力:

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

出力: TestReport（reportResults フィールド付き）

---

update_test_report_result

テスト結果を1件更新します。

処理方式: キューが設定されている場合は SQS 経由の非同期処理（202相当）。ローカル開発（キュー未設定）の場合は同期処理（後方互換）。

入力:

パラメータ	型	必須	説明
reportId	String	✓	テスト報告書の複合ID（{projectId}.{specUuid}.{reportUuid}）
resultId	String (UUID)	✓	テスト結果ID
testResult	String	-	OK / NG / SKIP
notes	String	-	備考
executionResultLink	String	-	テスト実行結果リンク
author	String	-	操作者署名

出力（キューあり）:

Copy{
  "queued": true,
  "messageId": "sqs-message-id-xxxx"
}

出力（ローカル開発・キューなし）: TestReportResult

---

batch_update_test_results

複数のテスト結果を同期的に一括更新します。CI/CDパイプラインで大量のテスト結果をまとめて記録する用途に最適化されています。

制約: 1リクエストあたり最大 100件

入力:

パラメータ	型	必須	説明
reportId	String	✓	テスト報告書の複合ID（{projectId}.{specUuid}.{reportUuid}）
items	Array	✓	更新リスト（1〜100件）
items[].resultId	String (UUID)	✓	テスト結果ID
items[].testResult	String	-	OK / NG / SKIP
items[].notes	String	-	備考
items[].executionResultLink	String	-	テスト実行結果リンク
author	String	-	操作者署名

出力:

Copy{
  "reportId": "report-uuid",
  "updated": 3
}

---

abort_test_report

報告書を ABORTED 状態に遷移します。

入力:

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

出力: TestReport（status: "ABORTED"）

---

reopen_test_report

ABORTED 状態の報告書を IN_PROGRESS に戻します。

入力:

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

出力: TestReport（status: "IN_PROGRESS"）

---

force_complete_test_report

報告書を強制的に COMPLETED 状態に遷移します。未完了（testResult: null）の結果は自動的に SKIP に設定されます。

入力:

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

出力:

Copy{
  "report": { },
  "autoSkippedCount": 5
}

report フィールドには status: "COMPLETED" の TestReport オブジェクトが含まれます。

---

get_completion_summary

アクセストークンが紐づくプロジェクトの全報告書の消化率サマリーを取得します。

入力:

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

出力:

Copy{
  "totalReports": 10,
  "notStartedReports": 1,
  "inProgressReports": 3,
  "completedReports": 5,
  "abortedReports": 1,
  "averageCompletionRate": 0.75
}