api-test-restassure

api-test-restassure（EN）

中国語版： 対応する中国語のスキルを参照してください。

使用する場面

• REST Assured ベースの自動化で利用する API 出力が必要な場合。
• プロジェクトが Java ベース、またはすでに REST Assured を使用している場合。

生成と実行の境界

ジェネレーターが生成するのは、既知のフィールドに対するスモークアサーションのみです。エンドポイントが空でないことと、expected_statuses が明示されていることが必須です。expected_json と、出典が示された max_response_ms は任意です。データの不足、未解決のパラメーター／変数、またはスキーマアサーションがある場合は、不完全なひな形が生成され、終了コードは 0 以外になります。references/generator-contract.md を読み、ターゲットと認証情報を明示的に設定してください。

ワークフロー

1. Progressive disclosure に記載されたメインプロンプト（カバレッジ、構成、品質基準）を読み、それに従います。
2. 結果に影響するプロジェクトコンテキストのみを追加します。対象範囲、環境、制約、リスク、依存関係、期待する成果物などです。
3. 入力が不完全な場合は、利用可能な初稿を提示し、前提と不足情報を明示します。
4. 既定では Markdown を使用し、ユーザーから求められた場合にのみ形式を切り替えます。

主な制約

• リスク／ビジネスへの影響に基づいて優先順位を付け、すべてを同等に扱わないでください。
• 確認済みの事実と現時点での前提を分けてください。
• ユーザーが提示していないエンドポイント、フィールド、環境、根本原因を創作しないでください。
• 認証情報／シークレットにはプレースホルダーまたは環境変数の仕組みを使用し、実際の認証情報をハードコードしないでください。
• 出力は実行可能なものにしてください。具体的なシナリオ、明確な優先順位、明確な次のステップを含めます。

段階的な情報開示

• 出力を作成する前に、prompts/api-test-restassure.md を読み、それに従います（最低限のカバレッジ、出力構成、品質基準）。
• 既製のテンプレートが適している場合は、output-templates/ 内の該当ファイルを使用します。
• ユーザーが例や既存のアセットとの整合性を求める場合は、関連する examples/ を読みます。
• フレームワーク、トラブルシューティング、スキーマに関する詳細な説明が必要な場合は、references/ 内の関連ファイルのみを読み、ディレクトリ全体を読み込まないでください。
• 形式変換や補助的なチェックには、一から作り直すのではなく既存の scripts/ を優先します。
• このスキルの評価やリグレッションには、skill-up とともに evals/ を使用します。

提出前チェックリスト

• メインプロンプトの出力構成に従った
• 最低限のカバレッジに注力した：スイート構成、共通セットアップ、認証の処理、優先度の高いエンドポイント、正常系シナリオ、異常系および境界値シナリオ、アサーションの重点、テストデータ戦略、...（詳細はメインプロンプトを参照）
• 最低限のチェックリストを網羅した、または省略した項目について説明した
• リスクの高い項目に明確な優先順位を付けた
• ユーザーが提示していない詳細を創作しなかった
• 前提と不足情報を明示した

よくある落とし穴

• 対象範囲やコンテキストが不足しているのに、完全であるかのように装わないでください。
• すべての項目を同等に重要なものとして扱わないでください。
• 前提や情報の不足を見過ごさないでください。
• 現在のツールチェーンに関係のない一般論を大量に提示しないでください。