name	description
vitest-ja-explainer	Vitest の実行結果とテストコードを読み取り、日本語で「何を保証しているテストか」を説明する。テスト失敗時は原因候補と確認手順を提示する。

Vitest JA Explainer

目的

Vitest のログを「実行結果」だけでなく「仕様保証の説明」に変換する。

この skill を使うタイミング

• 「この npm test 結果を日本語で説明して」と頼まれたとき
• 「何をテストしているか知りたい」と頼まれたとき
• 失敗テストの原因候補と次の確認手順を整理したいとき

実行手順

1. テスト結果を取得する。

• 既にログがある場合: そのログを使う。
• ログがない場合: npm test -- --reporter=verbose を実行する。

2. 必要なら機械可読ログを出す。

• npm test -- --reporter=json --outputFile=.dist/vitest-report.json
• 詳細解析が必要な場合のみ使う。

3. ログに出ているテストファイルを開く。

• tests/*.test.js を読み、describe / it の文言と実装を確認する。
• 実際に検証している入力・期待値・境界値を抜き出す。

4. 日本語で説明する。

• まず全体（成功/失敗件数）
• 次にファイルごとに「何を保証しているか」
• 最後に「未検証のリスク」を簡潔に書く

出力フォーマット（推奨）

• 全体結果
• テストごとの保証内容
• 残るリスク / 追加すると良いテスト

例:

• 全体結果: 3ファイル・7件すべて成功。
• tests/myutils.test.js: 受注番号プレフィックスからショップ判定・URL解決が正しいことを保証。
• tests/myutils-hours.test.js: 営業時間判定で通常窓と日跨ぎ窓の両方を保証。
• 未検証: 不正フォーマット文字列（空白混在、全角など）の網羅は不足。

失敗時の指針

• 失敗テスト名 -> 対象関数 -> 入力値 -> 期待値の順に原因を特定する。
• スタックトレースの先頭1件だけで決め打ちせず、テストコードの意図を優先して判断する。
• 修正提案時は「コード修正」か「テスト期待値修正」かを明確に分ける。

注意

• テスト名の日本語訳だけで終わらせない。
• 必ずテストコード実装を読み、実際に何を検証しているかで説明する。