test-case-writing

テストケース作成（英語）

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

使用するタイミング

• 実際のプロジェクトの状況に即したテストケースの作成を支援してほしい場合。
• 実行、レビュー、またはフォローアップにそのまま使える出力が必要な場合。
• 複数の役割から集めたシナリオ候補を、役割ごとの重複を避けながら、追跡可能なテストスイートにまとめたい場合。

ワークフロー

1. Progressive disclosure に記載されているメインプロンプト（カバレッジ、構成、品質基準）を読み、その指示に従います。
2. 結果に影響するプロジェクトのコンテキストのみを追加します。対象範囲、環境、制約、リスク、依存関係、期待する成果物、および任意の source_role 付き役割別シナリオ候補が該当します。
3. 統合テストスイートを作成する前に、要件のトレース、トリガー、アクション、観察可能な結果に基づいて、同等の候補を特定します。
4. 入力が不完全な場合は、利用可能な初稿を作成し、仮定と不足情報を明示します。
5. デフォルトでは Markdown を使用し、ユーザーから要望があった場合にのみ形式を変更します。

主な制約

• リスク／ビジネスへの影響に基づいて優先順位を付け、すべてを同等に扱わないでください。
• 確認済みの事実と現時点での仮定を区別してください。
• ユーザーが提示していないエンドポイント、フィールド、環境、根本原因を作り出さないでください。
• 出力は実行可能なものにしてください。具体的なシナリオ、明確な優先順位、明確な次の手順を含めます。
• 役割ごとにテストスイートを作成しないでください。同等の候補は、すべての該当する source_role、要件／受け入れ基準のトレース、リスクタグを記載した1つのケースにまとめます。
• トリガー、実行方法、または観察可能な結果の違いが実行に実質的な影響を与える場合にのみ、ケースを分割します。表現の違いだけで重複ケースを作成しないでください。

Plus スキルとの振り分け境界

• このスキルは、軽量なデフォルトの作成手段です。すでに作成されている役割別シナリオ候補を受け取り、出典と要件の追跡可能性を保ちながら統合できます。
• 異種ソース間の競合と出所の調整、独立した成果物としての正式なトレーサビリティマトリクス、または高リスク経路に対するポジティブ・ネガティブ・境界値のカバレッジに加えてデータのセットアップとクリーンアップを求めるなど、より高いカバレッジ基準が必要な場合は、testcase-writer-plus を選択します。このスキルですでに求められている基本的なケースフィールドや Trace だけを理由に切り替えないでください。2つのスキルは独立したままにし、統合したり名前を変更したりしないでください。

段階的な情報開示

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

提出前チェックリスト

• メインプロンプトの出力構成に従った
• 最低限必要なカバレッジの重点項目を含めた：対象範囲、ケースの優先順位、事前条件、テストデータ、手順、期待結果、ポジティブシナリオ、ネガティブシナリオ、source_role、要件のトレーサビリティ……（詳細はメインプロンプトを参照）
• 統合テストスイートを作成し、同等の役割別候補を統合しつつ、該当するすべての役割を保持した
• 最低限のチェック項目を網羅した、または省略理由を説明した
• 高リスク項目に明示的な優先順位を付けた
• ユーザーが提示していない詳細を作り出していない
• 仮定と不足情報を明示した

よくある落とし穴

• 対象範囲やコンテキストが不足しているのに、完全な内容であるかのように見せないでください。
• すべての項目を同等に重要なものとして扱わないでください。
• 仮定や情報の不足を省略しないでください。
• 同じシナリオを Product、QA、UI/UX、Technical の各スイートにコピーせず、統合時に少数派の出典も除外しないでください。
• 現在のツールチェーンに関係のない一般論を並べないでください。