api-test-supertest

api-test-supertest（EN）

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

使用する場面

• API の出力を Supertest ベースの自動化で検証する必要がある場合。
• プロジェクトが Node.js ベースであるか、すでに Supertest/Jest を使用している場合。

生成と実行の境界

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

ワークフロー

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

主な制約

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

段階的な情報開示

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

提供前のチェックリスト

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

よくある落とし穴

• 対象範囲やコンテキストが不足しているのに、網羅できているかのように装わないでください。
• すべての項目を同等に扱わないでください。
• 前提や情報の不足を省略しないでください。
• 現在のツールチェーンに関係のない一般論を並べないでください。