api-test-bruno

api-test-bruno（EN）

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

使用する場合

• API の出力を Bruno の構成やワークフローに取り込む必要がある場合。
• プロジェクトですでに Bruno を使用している場合や、Bruno ですぐに使える構成が必要な場合。

生成と実行の境界

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

ワークフロー

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

主な制約

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

段階的な開示

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

提出前チェックリスト

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

よくある落とし穴

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