Skill.md検索

実装コードと仕様書の乖離を自動検出: データモデル、API、ワークフロー、外部統合など4つの観点から、コード実装が仕様書と一致しているか自動チェック。 優先度付きレポートで人間に報告: 検出された乖離を「データモデル → API → ワークフロー → その他」の順で整理し、実装・仕様のどちらが正しいか判断する情報を提供します。 自動修正は行わない: 人間が仕様優先か実装優先か判断すべき箇所を明確にし、意思決定を支援します。 未解決事項を追跡: 仕様書の open-questions セクションから、現在の実装に影響する未決定事項をリストアップします。 SDD（仕様駆動開発）を採用しているプロジェクトチーム 大規模な仕様書と実装コードを管理している人 仕様書の更新漏れやコード実装の逸脱を防ぎたい人 コードレビュー時に仕様との整合性を確認する負担を減らしたい人 このスキルは仕様駆動開発（SDD）向けの乖離検出ツール。specs/multi-vendor-ecommerce/ が Single Source of Truth。Step 1 で変更ファイルを git status/diff で特定し、Step 2 で関連仕様書を選択的に読み込む（prisma/schema → 03-data-model.md、src/queries → 04-interfaces.md、src/app → 05-workflows.md）。Step 3 でデータモデル・API・ワークフロー・その他の4観点から乖離検出：A. データモデルはモデル・フィールド・リレーション・インデックスをチェック、B. API は関数シグネチャ・認証・エラー処理を比較、C. ワークフローはページ・ルート・ユーザーフロー・RBAC を確認、D. その他は外部サービス・技術制約・テスト要件を検査。Step 4 で open-questions.md から未解決事項を確認、Step 5 でレポート出力。

ユニットテスト・型チェック・リントを順序立てて実行 - Jest、TypeScript型チェック、ESLintを指定の順番で実行し、複数の品質チェックを一度に完了できます。 テスト失敗を詳細に分析・原因特定を支援 - 失敗テストのファイル名、テスト名、エラーメッセージ、行番号を抽出し、「期待値vs実際値」「推奨対応」を記載したレポートを出力します。 カバレッジギャップを可視化 - テストカバレッジ（Statements/Branches/Functions/Lines）を自動計測し、ギャップ分析で改善すべきテストを提案できます。 型エラー・リント違反を一覧化・改善方法を提示 - TypeScriptエラーとESLintルール違反をファイル・行番号とともに抽出し、各違反の対応方法を簡潔に説明します。 E2Eテスト実行は明示指示時のみ、デフォルト実行なし - ユーザーが「E2Eも含めて」と指示した場合のみPlaywright E2Eテストを実行し、無駄な待ち時間を削減できます。 品質を維持しながら開発速度を上げたいエンジニア - コミット前に自動で複数の品質チェックが実行されるため、後続レビューでの指摘を事前に減らせます。 テストカバレッジの改善を目指すチーム - ギャップ分析で「どのテストが足りないか」が可視化され、効率的にカバレッジを向上させられます。 型安全性と品質を両立させたい開発者 - TypeScript型チェックとESLintが同時実行されるため、静的解析による品質保証が徹底できます。 限られた時間の中でテストの健全性を確保したい急ぎプロジェクト - E2Eテストはオプト・イン方式なので、ユニットテストで素早く品質判定でき、必要時のみE2Eテストを実行できます。 ユニットテスト（Jest）→型チェック（TypeScript）→リント（ESLint）→E2Eテスト（オプション）の順序で実行。Step 1：明示的指定でスコープ決定（デフォルト：ユニット+型+リント、「E2Eも含めて」：上記+E2E、「特定ファイル」：対象のみ、「ギャップ分析」：カバレッジ付き）。Step 2：bun run testで全テスト実行、--testPathPatternで特定ファイル指定、--coverageでカバレッジ詳細出力。失敗時は失敗テスト・ファイル名・テスト名・エラーメッセージ・行番号を抽出。Step 3：bunx tsc --noEmitで型チェック、エラー時はファイル・行番号・メッセージを抽出。Step 4：bun run lint実行、エラー・警告時はルール名・ファイル・行番号・メッセージを抽出。Step 5：要求時のみE2E実行（bun run seed:e2eでシード投入、bunx playwright testで実行、--project・--fileで選択実行可能）。Step 6：Markdownレポートを出力（テスト総数・成功・失敗・スキップ、カバレッジ％、失敗テスト詳細と推奨対応、型エラー数と詳細、リント警告・エラー数と詳細、コミット可否判定）。