test-changes について
現在の会話で完了した作業を、簡潔な手動テスト用の引き継ぎ資料にまとめるスキルです。変更を観察可能な確認項目に対応付け、端末準備が必要な場合はコピー可能な PowerShell 手順を示します。
主な機能
- 01最終的な変更内容の再構成
- 02ユーザーに見える変更とテスト箇所の対応付け
- 03順序付き PowerShell 準備手順
- 04操作、期待結果、失敗の兆候の明示
- 05検証の不足と復旧要件の提示
活用シーン
- 01完了した変更を手動テスト担当者へ引き継ぐ
- 02変更されたUI、ファイル、サービス、外部状態の確認
- 03最小限のローカルテスト手順の準備
- 04手動では検証できない箇所の特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pinguapps/ skills --skill test-changesインストール後、Claude Code で/test-changesを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
テスト変更
現在の会話で完了した作業を手動で確認するための、実用的な引き継ぎ情報を作成してください。
1. テスト対象を特定する
後からの修正や失敗・部分的な試行も含め、会話の内容から納品された結果を再構成してください。現在のワークスペース、接続済みのシステム、実行中の環境は最終状態の確認には使えますが、会話内容の代わりにはなりません。
必要に応じて、変更されたファイル、git diff、リポジトリの状態、利用可能なスクリプト、プロジェクトのドキュメント、生成された成果物、外部の記録、すでに稼働中のサービスなど、読み取り専用の証拠を確認してください。完了した作業で変更された、ユーザーが確認できる挙動、成果物、外部の状態をすべて考慮してください。無関係な既存の変更は分けてください。
完了した変更も確認可能な変更もない場合は、そのことを明記し、手動テストを有意義に行うために必要な作業を示してください。
完了条件:この会話で行われたすべての変更について、ユーザーが確認または操作できる対象に対応付けるか、手動テストの対象がないことを明示します。
2. 最短の有効なテスト手順を作成する
ユーザーに何かを実行してもらう前に、現時点でユーザーが確認できるものから始めてください。確認済みの既存ファイル、レンダリング済みの成果物、開いているアプリケーション、稼働中のサービス、URL、表示状態のみを記載してください。
テスト対象に到達するために必要な最小限の前提条件とコマンドを示してください。ターミナルコマンドには PowerShell の構文を使ってください。
- 正しいディレクトリに移動する
Set-Locationから始めます。 - コマンドは実行順に記載し、各ブロックをそのままコピーして実行できるようにします。
- リポジトリで実際に使われているスクリプト、プロジェクト名、ポート、パスを使用します。
- 必要な場合に限り、依存関係のインストール、ビルド、マイグレーション、シード、サーバーの起動、認証の手順を含めます。
- 長時間実行するコマンドがターミナルを占有するかどうか、また別の PowerShell ウィンドウが必要になるタイミングを明記します。
- 変更箇所を試す最小限のコマンドを優先します。実質的に異なるリスクが明らかになる場合に限り、より広範な確認を追加します。
<ApiKey>など、ユーザーが指定する必要のある値には目印を付け、入手先を記載します。
回答から開ける場合は、ローカルの成果物や外部ページへ直接リンクしてください。ターミナルでの操作が不要な場合は、PowerShell コマンドを無理に作らず、直接確認する手順を示してください。
説明を準備するためだけにアプリケーションのデータを変更しないでください。テスト自体がデータを変更する場合は、ユーザーに警告し、可能であればクリーンアップまたはリセットの手順を示してください。
完了条件:ユーザーが新しい PowerShell ウィンドウからコマンドを実行すれば、隠れた手順を挟まずに、テスト可能なすべての変更箇所へ到達できます。
3. 確認結果を明確にする
各テストについて、以下を示してください。
- 実行する具体的な操作。
- 期待される具体的な結果。
- 新しい挙動または変更された挙動を証明する詳細。関連するテキスト、コントロール、値、ファイル、ログ、ステータスコード、変更前後の差異などを含めます。
- 意味のある失敗の兆候。
まず正常系を確認し、続けて作業内容から必要性が説明できる変更済みの境界ケースや回帰を確認してください。実装の詳細ではなく、観測可能な挙動を記述してください。確証のないことを断定しないでください。推測に基づく期待値はその旨を示し、手動テストを完全に行えない要因があれば明記してください。
完了条件:ユーザーが「正しく動作する」といった曖昧な表現を解釈せずに、各テストの合否を判断できます。
回答形式
該当する内容がないセクションは省略してください。
## What you can see now
- <Confirmed immediately visible state, and where to find it>
## Start or prepare
<Copyable PowerShell commands, plus terminal/window guidance>
## Manual tests
### 1. <Behaviour or artifact>
**Action:** <Exact interaction>
**Expected:** <Specific observable result>
**Changed:** <What is new or different>
**Failure:** <Specific sign of failure>
## Cleanup
<PowerShell commands or actions needed to stop services or revert test data>
## Limitations
- <Anything unconfirmed, untestable manually, or requiring unavailable access>
引き継ぎ情報は簡潔に保ちつつ、変更されたテスト対象をすべて含めてください。手動テストの判断に役立たない限り、自動テストの結果は繰り返さないでください。
重大な検証上の不足と、ランタイム、データ、設定に関する変更からの復旧手順を明記してください。該当する場合は、元に戻せない手順を特定してください。ロールバック手順をでっち上げないでください。レビュー修正後は、最終的な変更内容に合わせて、該当する期待結果とコマンドを更新してください。2つ目のレビュー依頼を追加するのではなく、呼び出し元が提示した既存のレビュー依頼に従ってください。